RoomCraft AI — Layout Optimizer & 3D Room Planner Distribuir los muebles de una habitación sin que lo haga un LLM

Python FastAPI Groq Llama 3.1 Simulated Annealing Three.js Alpine.js ReportLab Pydantic NLP Optimización Combinatoria 3D WebGL glTF 2.0 USDZ OpenUSD
RoomCraft AI — Layout Optimizer & 3D Room Planner

RoomCraft AI — Del texto libre al plano técnico en 3D en menos de 8 segundos

Los planificadores existentes son drag-and-drop manuales o generan una sola sugerencia de layout que tienes que aceptar a ciegas. RoomCraft AI genera múltiples layouts automáticamente, los rankea con una puntuación real basada en ergonomía y normativa, y explica por qué cada uno es mejor o peor. Todo desde lenguaje natural, sin arrastrar nada.

Módulo 1 — Parser de Lenguaje Natural (Groq + Llama 3.1)

Convierte texto libre del usuario en JSON estructurado con todas las dimensiones de la habitación y los muebles. Maneja ambigüedades, unidades mezcladas y descripciones imprecisas. Latencia <1 segundo.

Módulo 2 — Motor de Optimización (Simulated Annealing)

Metaheurística que explora miles de combinaciones escapando de óptimos locales. Para cada mueble: posición X, posición Y, rotación (0°, 90°, 180°, 270°). 10.000 iteraciones en <2 segundos en CPU. Restricciones duras: ningún mueble fuera de límites, sin solapamientos, sin bloquear puertas (arco 90cm), pasillo mínimo 60cm. Restricciones blandas: ergonomía de cama, orientación de sofá, acceso a luz natural.

Módulo 3 — Visualización 3D (Three.js en navegador)

Three.js r128 corriendo 100% en el navegador del usuario. Sin instalar nada. OrbitControls para rotación libre, vista cenital (planta 2D), primera persona (WASD), isometría 45°. Overlay profesional: distancias en cm entre muebles, zonas de conflicto (rojo) y pasillos correctos (verde). Cada mueble clickeable muestra dimensiones reales.

Módulo 4 — Exportación PDF Técnica (ReportLab)

Planta 2D vectorial a escala con todos los muebles y cotas. Tabla de métricas: puntuación total, circulación mínima, aprovechamiento de luz, conflictos detectados. Escala gráfica (barra 1m) para impresión. Watermark sutil para marketing pasivo cuando el profesional comparte el PDF con su cliente.

Diferenciación respecto al mercado

Planner 5D, Arcadium y SketchUp: de 7€ a 35€/mes, drag-and-drop manual, sin input conversacional, sin auto-layout. RoomCraft AI: gratis, input LLM, Top 5 layouts automáticos, Three.js en navegador, métricas profesionales y PDF técnico gratuito.

Stack Técnico

Python · FastAPI · Groq (Llama 3.1) · Simulated Annealing · Three.js r128 · Alpine.js · ReportLab · Pydantic

Integración, datos y licencia

  • Integración: API REST propia (FastAPI) con 11 endpoints documentados en el repositorio; se puede consumir desde cualquier lenguaje o plataforma, con especificación OpenAPI autogenerada.
  • Tratamiento de datos: la demo pública envía a Google Gemini únicamente el contenido necesario para generar la respuesta. No se almacenan las conversaciones en base de datos ni se asocian a ninguna identidad. En un despliegue propio decides tú el proveedor — incluido un modelo local, con el que ningún dato sale de tu infraestructura.
  • Nota: La optimización de distribución (simulated annealing) se calcula íntegramente en el servidor; la IA externa solo interviene en el render descriptivo.
  • Licencia: MIT — uso libre, incluido comercial, manteniendo el aviso de copyright. El repositorio contiene la aplicación completa y puede desplegarse en infraestructura propia. El código es gratuito; los costes de motor de IA, infraestructura, implantación y mantenimiento corren por cuenta de quien lo despliega (no se ofrece soporte ni consultoría).

¿Cómo lo integro?

Disponible ahora: API REST que optimiza la distribución del mobiliario y exporta el resultado en PDF; el cálculo es determinista y se ejecuta en el servidor.

Integraciones habituales en este sector (valoradas como vía recomendada; salvo que se indique lo contrario, no vienen implementadas — el código está preparado para añadirlas):

  • glTF 2.0 — YA IMPLEMENTADO: POST /api/roomcraft/export-gltf devuelve la distribución como escena 3D estándar de Khronos, que abren sin plugins Blender, three.js, Babylon.js, Unity, Unreal y el Visor 3D de Windows. Las alturas de mueble son una tabla de valores típicos documentada en el propio fichero (el optimizador trabaja en planta).
  • USDZ (realidad aumentada iOS) — YA IMPLEMENTADO: POST /api/roomcraft/export-usdz genera la escena con OpenUSD y la empaqueta con UsdUtils.CreateNewUsdzPackage, la ruta oficial. Al abrirlo en un iPhone, Quick Look ofrece «Ver en tu espacio» sin instalar nada. Verificado: cumple la spec (ZIP sin comprimir, alineado a 64 bytes), OpenUSD lo reabre con la jerarquía correcta y declara upAxis=Y y metersPerUnit=1.0 para que la escala en AR sea real. No verificado: no se ha probado en un iPhone físico.
  • Catálogos de mobiliario: sustituir el catálogo de ejemplo por el del fabricante para que la propuesta use producto real y vendible.
  • Matterport / tours virtuales: partir de un espacio ya escaneado en vez de introducir medidas a mano.
  • Three.js: visor web interactivo sobre la salida del optimizador; es el paso natural para una demo comercial.

Resultados

<1s
Latencia parse
Groq API (Llama 3.1)
2-5s
Latencia optimize
Simulated Annealing CPU
Top 5
Layouts generados
únicos rankeados
0-100
Score función
circulación+luz+ergonomía
~100MB
RAM idle
sin modelos grandes
<1s
Export PDF
ReportLab puro CPU

Funcionalidades implementadas

  • 🗣 Input conversacional. Describe en texto libre. Groq + Llama 3.1 parsea dimensiones, muebles y orientaciones en menos de 1 segundo.
  • 🏆 5 layouts automáticos. Simulated Annealing explora 10.000 combinaciones por intento y presenta el Top 5 con puntuación y desglose numérico.
  • 📐 Overlay profesional. Distancias en cm entre muebles, zonas de conflicto en rojo, pasillos correctos en verde. Igual que un arquitecto a mano.
  • 📄 PDF técnico sin registro. Planta 2D vectorial a escala con cotas reales y tabla de métricas. Descarga directa sin cuenta ni pago.
  • Sin GPU ni modelos grandes. Solo optimización clásica y Groq API. CPU-only, 100MB idle, desplegable en cualquier VPS estándar.
Try Live Demo View Code

Cómo está construido

RoomCraft AI: optimizar la distribución de una habitación con Simulated Annealing Describe tu habitación en lenguaje natural y obtén plantas optimizadas en 3D. Detrás hay un parser con LLM, un optimizador de Simulated Annealing que coloca los mueb...