yunfanye/openhouse-3d

어떤 프로젝트인가요?

핵심 기능

• 01시프트 렌즈 촬영과 드론 항공 사진을 포함한 매물 사진의 카메라 포즈를 계산합니다.
• 02개구부를 검증한 벽체와 사이딩, 벽돌, 창문, 문, 계단, 지붕을 절차적으로 생성합니다.
• 03가상 스테이징을 위해 가구, 러그, 미술품, 식생, 주변 환경을 추가합니다.
• 04CPU, Metal, OptiX, CUDA, HIP 또는 oneAPI에서 헤드리스 Cycles 렌더링을 지원하며, 청크 단위로 렌더링을 이어서 진행할 수 있습니다.
• 051080p 워크스루 영상, 사진과 렌더 비교 갤러리, 동기화된 비교 영상을 생성합니다.

활용 사례

• 기존 매물 사진을 바탕으로 부동산 가상 워크스루를 제작합니다.
• 실제 주택과 3D 모델을 비교할 수 있도록 사진과 구도를 맞춘 렌더 이미지를 생성합니다.
• 스크립트로 제어하는 재현 가능한 씬을 사용해 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은(는) 무엇인가요?

부동산 매물 사진을 바탕으로 주택을 재구성해 3D Blender 모델을 만들고 워크스루 영상을 렌더링하는 Python 툴킷입니다. OpenHouse 3D는 부동산 매물 사진을 Blender(bpy)에서 절차적으로 생성한 3D 주택으로 변환하는 모델링 툴킷입니다. 이미지 특징을 분석해 원근 보정 사진과 드론 항공 사진을 포함한 각 매물 사진의 카메라를 계산하고, 개구부를 검증한 벽체와 사이딩, 벽돌, 창문, 문, 계단, 홈통이 있는 지붕, 설비 요소를 만듭니다. 가상 스테이징을 위해 가구, 러그, 식생, 주변 환경도 추가할 수 있습니다.

openhouse-3d은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

openhouse-3d은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

openhouse-3d은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. openhouse-3d의 마지막 커밋은 2026년 9월 26일입니다.

openhouse-3d은(는) 어디에 사용할 수 있나요?

기존 매물 사진을 바탕으로 부동산 가상 워크스루를 제작합니다. 실제 주택과 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