Repolode
yunfanye

yunfanye/openhouse-3d

Kit de herramientas de Python que reconstruye una casa a partir de fotos de anuncios inmobiliarios como modelo 3D de Blender y genera un video con un recorrido virtual.

Alternativa open source a:Matterport

Estrellas
60
Forks
8
Issues abiertos
0
Último commit
el mes pasado

¿Qué es?

OpenHouse 3D es un kit de herramientas de modelado que convierte las fotos de un anuncio inmobiliario en una casa 3D procedimental en Blender (bpy). Calcula la cámara de cada foto del anuncio a partir de características de la imagen, incluidas las tomas con corrección de perspectiva y las vistas aéreas de dron, y construye paredes con aberturas validadas, revestimientos, ladrillo, ventanas, puertas, escaleras, tejados con canalones y accesorios. Para preparar la puesta en escena virtual, se pueden añadir muebles, alfombras, vegetación y elementos del entorno.

El proyecto renderiza con Cycles sin interfaz gráfica en CPU, Metal, OptiX, CUDA, HIP o oneAPI. Genera un recorrido cinematográfico continuo a 1080p24 con placas de título y música, una galería de renders ajustados a las fotos y un video sincronizado que muestra la película junto a las fotos originales. Las escenas se pueden empaquetar, el renderizado se puede reanudar por partes y se comprueba que las rutas de cámara tengan suficiente espacio libre.

El proyecto es un kit de herramientas, no un servicio de un solo clic: una persona o un agente de programación con IA interpreta las fotos y escribe un paquete de casa, y la biblioteca se encarga de la geometría, el renderizado y el video. La geometría que no se ve se infiere, por lo que el resultado es una reconstrucción y no un levantamiento con medidas. Se incluyen casas de ejemplo y una plantilla inicial sintética.

Funciones clave

  • 01Calcula las posiciones de cámara para fotos de anuncios, incluidas las tomas con lentes descentradas y las vistas aéreas de dron.
  • 02Construye de forma procedimental paredes con aberturas validadas, revestimientos, ladrillo, ventanas, puertas, escaleras y tejados.
  • 03Añade muebles, alfombras, obras de arte, vegetación y elementos del entorno para la puesta en escena virtual.
  • 04Renderiza con Cycles sin interfaz gráfica en CPU, Metal, OptiX, CUDA, HIP o oneAPI, con salida por partes que se puede reanudar.
  • 05Genera un video de recorrido a 1080p, una galería para comparar fotos y renders, y una película comparativa sincronizada.

Casos de uso

  • Crear un recorrido virtual de una propiedad a partir de las fotos que ya aparecen en su anuncio.
  • Generar renders ajustados a las fotos para comparar un modelo 3D con la casa real.
  • Prototipar visualizaciones arquitectónicas en Blender con escenas reproducibles mediante scripts.
  • Estudiar cómo combinar el cálculo de cámaras y el modelado procedimental en un flujo de trabajo de Blender.

Inicio rápido

  1. 1

    Clona el repositorio

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

    Instala las dependencias de Python en un entorno virtual

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

    Crea la casa inicial sintética

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

    Renderiza una imagen fija de la casa inicial con Blender en 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 usarlo

  • Requiere Blender 5.2.x y una instalación local de Python 3.9 o posterior.
  • Es un kit de herramientas de modelado, no un servicio que convierta fotos en modelos 3D con un solo clic. Se necesita una persona o un agente de IA para crear cada paquete de vivienda.
  • Las reconstrucciones se infieren a partir de fotos y no son levantamientos basados en mediciones.

En colecciones

Temas

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

Preguntas frecuentes

¿Qué es openhouse-3d?
Kit de herramientas de Python que reconstruye una casa a partir de fotos de anuncios inmobiliarios como modelo 3D de Blender y genera un video con un recorrido virtual. OpenHouse 3D es un kit de herramientas de modelado que convierte las fotos de un anuncio inmobiliario en una casa 3D procedimental en Blender (bpy). Calcula la cámara de cada foto del anuncio a partir de características de la imagen, incluidas las tomas con corrección de perspectiva y las vistas aéreas de dron, y construye paredes con aberturas validadas, revestimientos, ladrillo, ventanas, puertas, escaleras, tejados con canalones y accesorios. Para preparar la puesta en escena virtual, se pueden añadir muebles, alfombras, vegetación y elementos del entorno.
¿openhouse-3d es gratuito? ¿Qué licencia tiene?
openhouse-3d es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿openhouse-3d sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de openhouse-3d fue el 26 sept 2026.
¿Para qué puedo usar openhouse-3d?
Crear un recorrido virtual de una propiedad a partir de las fotos que ya aparecen en su anuncio. Generar renders ajustados a las fotos para comparar un modelo 3D con la casa real. Prototipar visualizaciones arquitectónicas en Blender con escenas reproducibles mediante scripts. Estudiar cómo combinar el cálculo de cámaras y el modelado procedimental en un flujo de trabajo de Blender.
¿Cómo se instala openhouse-3d?
Clona el repositorio: git clone https://github.com/yunfanye/openhouse-3d.git Instala las dependencias de Python en un entorno virtual: python -m pip install -e '.[dev]' Crea la casa inicial sintética: python tools/new_house.py my_house --title "My house" Renderiza una imagen fija de la casa inicial con Blender en modo headless: blender -b --python-exit-code 1 --python run.py -- --house my_house --cam hero --samples 16 --scale 25 --no-polish --device CPU
¿Dónde consigo openhouse-3d?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/yunfanye/openhouse-3d

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados