Repolode
yunfanye

yunfanye/openhouse-3d

Toolkit em Python que reconstrói uma casa a partir de fotos de um anúncio imobiliário como modelo 3D no Blender e renderiza um vídeo de visita virtual.

Alternativa open source a:Matterport

Estrelas
61
Forks
8
Issues abertas
0
Último commit
mês passado

O que é?

OpenHouse 3D é um toolkit de modelagem que transforma as fotos de um anúncio imobiliário em uma casa 3D procedural no Blender (bpy). Ele calcula a câmera de cada foto do anúncio a partir dos recursos da imagem, incluindo fotos com perspectiva corrigida e imagens aéreas feitas por drone, e constrói paredes com aberturas validadas, revestimento, tijolos, janelas, portas, escadas, telhados com calhas e instalações. É possível adicionar móveis, tapetes, vegetação e elementos do entorno para fazer staging virtual.

O projeto renderiza com Cycles em modo headless, usando CPU, Metal, OptiX, CUDA, HIP ou oneAPI. Ele gera um vídeo cinematográfico contínuo de visita virtual em 1080p24, com cartelas de título e música, uma galeria de renders alinhados às fotos e um vídeo sincronizado que mostra o filme ao lado das fotos originais. As cenas podem ser empacotadas, a renderização pode ser retomada em etapas e as rotas de câmera são verificadas para garantir folga.

O projeto é um toolkit, não um serviço de um clique: uma pessoa ou um agente de programação com IA interpreta as fotos e escreve um pacote da casa; a biblioteca cuida da geometria, da renderização e do vídeo. Como a geometria oculta é inferida, o resultado é uma reconstrução, não um levantamento dimensional. O projeto inclui exemplos de casas e um template inicial sintético.

Recursos principais

  • 01Calcula as poses de câmera para fotos de anúncios, incluindo imagens feitas com lente deslocada e fotos aéreas de drone.
  • 02Constrói proceduralmente paredes com aberturas validadas, revestimento, tijolos, janelas, portas, escadas e telhados.
  • 03Adiciona móveis, tapetes, obras de arte, vegetação e elementos do entorno para fazer staging virtual.
  • 04Renderiza com Cycles em modo headless, usando CPU, Metal, OptiX, CUDA, HIP ou oneAPI, com saída em etapas que pode ser retomada.
  • 05Gera um vídeo de visita virtual em 1080p, uma galeria comparando fotos e renders e um vídeo de comparação sincronizado.

Casos de uso

  • Criar uma visita virtual a um imóvel usando as fotos já existentes no anúncio.
  • Gerar renders alinhados às fotos para comparar um modelo 3D com a casa real.
  • Prototipar visualizações arquitetônicas no Blender com cenas programadas e reproduzíveis.
  • Estudar como combinar cálculo de câmera e modelagem procedural em um pipeline do Blender.

Início rápido

  1. 1

    Clone o repositório

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

    Instale as dependências do Python em um ambiente virtual

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

    Crie a casa inicial sintética

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

    Renderize uma imagem estática da casa inicial com o Blender em modo headless

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

Antes de usar

  • Requer Blender 5.2.x e uma instalação local do Python 3.9 ou superior.
  • É um kit de ferramentas de modelagem, não um serviço que transforma fotos em modelos 3D com um clique. É necessária uma pessoa ou um agente de IA para criar cada pacote de casa.
  • As reconstruções são inferidas a partir de fotos e não correspondem a levantamentos feitos por medição.

Em coleções

Tópicos

#3d-reconstruction#blender#architectural-visualization#rendering#virtual-tour#computer-vision#python#3d-rendering#3d-walkthrough#archviz

Perguntas frequentes

O que é openhouse-3d?
Toolkit em Python que reconstrói uma casa a partir de fotos de um anúncio imobiliário como modelo 3D no Blender e renderiza um vídeo de visita virtual. OpenHouse 3D é um toolkit de modelagem que transforma as fotos de um anúncio imobiliário em uma casa 3D procedural no Blender (bpy). Ele calcula a câmera de cada foto do anúncio a partir dos recursos da imagem, incluindo fotos com perspectiva corrigida e imagens aéreas feitas por drone, e constrói paredes com aberturas validadas, revestimento, tijolos, janelas, portas, escadas, telhados com calhas e instalações. É possível adicionar móveis, tapetes, vegetação e elementos do entorno para fazer staging virtual.
openhouse-3d é gratuito? Qual é a licença?
openhouse-3d é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
openhouse-3d ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de openhouse-3d foi em 26 de set. de 2026.
Para que posso usar openhouse-3d?
Criar uma visita virtual a um imóvel usando as fotos já existentes no anúncio. Gerar renders alinhados às fotos para comparar um modelo 3D com a casa real. Prototipar visualizações arquitetônicas no Blender com cenas programadas e reproduzíveis. Estudar como combinar cálculo de câmera e modelagem procedural em um pipeline do Blender.
Como instalar openhouse-3d?
Clone o repositório: git clone https://github.com/yunfanye/openhouse-3d.git Instale as dependências do Python em um ambiente virtual: python -m pip install -e '.[dev]' Crie a casa inicial sintética: python tools/new_house.py my_house --title "My house" Renderize uma imagem estática da casa inicial com o Blender em modo headless: blender -b --python-exit-code 1 --python run.py -- --house my_house --cam hero --samples 16 --scale 25 --no-polish --device CPU
Onde consigo openhouse-3d?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yunfanye/openhouse-3d

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados