yunfanye/openhouse-3d

这是什么？

核心功能

• 01为挂牌照片求解相机参数，支持移轴镜头照片和无人机航拍图。
• 02程序化生成带校验门窗洞口的墙体、侧挂板、砖墙、窗、门、楼梯和屋顶。
• 03添加家具、地毯、画作、植被和周边环境，用于虚拟布置。
• 04支持 CPU、Metal、OptiX、CUDA、HIP、oneAPI 的无界面 Cycles 渲染，可分块断点续传。
• 05输出 1080p 漫游视频、照片与渲染对照画廊以及同步对比视频。

适用场景

• 基于现有挂牌照片为房产制作虚拟漫游。
• 生成与照片匹配的渲染图，用于对比三维模型与真实房屋。
• 在 Blender 中以脚本化、可复现的方式制作建筑可视化原型。
• 学习如何在 Blender 流程中结合相机求解与程序化建模。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/yunfanye/openhouse-3d.git
2. 2

   在虚拟环境中安装 Python 依赖

   python -m pip install -e '.[dev]'
3. 3

   创建合成的入门示例房屋

   python tools/new_house.py my_house --title "My house"
4. 4

   使用无界面 Blender 渲染入门房屋的静态图

   blender -b --python-exit-code 1 --python run.py -- --house my_house --cam hero --samples 16 --scale 25 --no-polish --device CPU

使用前须知

• !需要 Blender 5.2.x 以及本地 Python 3.9+ 环境。
• !这是建模工具包，而不是一键式照片转 3D 服务，每座房屋都需要人工或 AI 代理编写房屋包。
• !重建结果基于照片推断，并非实测测绘。

收录于专题

标签

常见问题

openhouse-3d 是什么？

基于 Blender 的 Python 工具包，从房产挂牌照片重建三维房屋模型并渲染漫游视频。 OpenHouse 3D 是一个建模工具包，可将房产挂牌照片转换为 Blender（bpy）中的程序化三维房屋模型。它从图像特征中求解每张照片的相机参数，包括经过透视校正的照片和无人机航拍图，并构建带有校验过的门窗洞口的墙体、侧挂板与砖墙、窗、门、楼梯、带排水槽的屋顶以及固定装置。还可以添加家具、地毯、植被和周边环境，用于虚拟布置。

openhouse-3d 可以免费使用吗？用的什么许可证？

openhouse-3d 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

openhouse-3d 还在维护吗？

半年内有更新。openhouse-3d 最近一次提交是在 2026年9月26日。

openhouse-3d 适合用来做什么？

基于现有挂牌照片为房产制作虚拟漫游。 生成与照片匹配的渲染图，用于对比三维模型与真实房屋。 在 Blender 中以脚本化、可复现的方式制作建筑可视化原型。 学习如何在 Blender 流程中结合相机求解与程序化建模。

openhouse-3d 怎么安装和运行？

克隆仓库: git clone https://github.com/yunfanye/openhouse-3d.git 在虚拟环境中安装 Python 依赖: python -m pip install -e '.[dev]' 创建合成的入门示例房屋: python tools/new_house.py my_house --title "My house" 使用无界面 Blender 渲染入门房屋的静态图: blender -b --python-exit-code 1 --python run.py -- --house my_house --cam hero --samples 16 --scale 25 --no-polish --device CPU

在哪里获取 openhouse-3d？

源代码和安装说明在 GitHub 上：https://github.com/yunfanye/openhouse-3d