README.md

metadata

title: Vitalis DevCore — 3D Blueprint Builder
emoji: 🏗️
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 6.19.0
app_file: app.py
pinned: false

Vitalis DevCore — 3D Blueprint Builder

→ Rival Codex: Natural Language → Interactive 3D Architecture

---

Overview

Vitalis DevCore transforms natural language building descriptions into interactive 3D architectural blueprints. Describe any building in plain English — "2000 sq ft ranch with 3 bedrooms and 2 baths" — and get a fully explorable 3D model with rooms, style-specific roofs, measurement labels, and camera controls.

The system is live on HuggingFace Spaces — no GPU, no install, just describe and build.

Features

Feature	Description
Natural Language Parsing	Extracts dimensions, style, stories, bedrooms, bathrooms, garage, extra rooms from plain English
Architecture Styles	Modern, Ranch, Colonial, Victorian, Cabin, Craftsman, Farmhouse, Tudor — each with style-specific roofs
Style-Specific Roofs	Flat (modern), Gable (colonial/cabin), Hip (ranch), Steep-gable (victorian/tudor), Low-gable (craftsman)
Live 3D Rendering	Three.js in-browser — walls, floors, roof, shadows, lighting
Room Labels	Floating sprites showing room names
Measurement Overlays	Dimension labels on each room (width/depth in feet)
Interactive Controls	Orbit (rotate), Pan (move), Tour (auto walkthrough)
JSON Export	Download blueprint data as structured JSON
Extra Room Support	Office, Library, Deck, Loft, Garage, Basement, and more

How It Works

"30x40 modern 2-story with 4 bedrooms and a garage"
  ↓
NL Parser → Structured Blueprint JSON → Three.js Scene → Interactive 3D

Quick Start

Try It Live (no install)

1. Open Vitalis DevCore on HF Spaces
2. Type a building description or click an example prompt
3. Click Build Blueprint
4. Use mouse to orbit/zoom/pan the 3D model
5. Click Tour for auto walkthrough or Export to download

Example Prompts

"2000 sq ft ranch house with 3 bedrooms and 2 baths"
"modern 2-story house 30x40 with 4 bedrooms 3 bathrooms and a garage"
"small cabin 800 sq ft with 1 bedroom and a loft"
"victorian 3500 sq ft 5 bedroom 3 bath with office and library"
"30 feet by 50 feet modern house with 4 bedrooms and a deck"

Run Locally

git clone https://github.com/AnonymousNomad/Vitalis-DevCore.git
cd Vitalis-DevCore
pip install -r requirements.txt
python app.py

Architecture

devcore/
├── parser.py      # Natural language → structured blueprint data
│   ├── 7 extractors (sqft, dimensions, style, stories, bedrooms, bathrooms, extras)
│   └── Room layout generator with smart positioning
├── builder.py     # Blueprint → Three.js HTML with style-specific roofs
│   ├── Measurements overlay
│   └── JSON export support
└── templates/
    └── viewer.html  # Full Three.js scene with orbit/tour/pan controls

Roof Styles by Architecture

Style	Roof	Description
Modern	Flat	Clean, minimal horizontal lines
Ranch/Hip	Hip	Sloped on all four sides
Colonial	Gable	Classic triangular gable ends
Victorian	Steep-gable	Dramatic steep pitch with dormers
Craftsman	Low-gable	Low-pitch with wide eaves
Cabin	Gable	Simple rustic gable
Farmhouse	Gable	Traditional gable

Sponsor

If you find this tool useful for architecture visualization or design education:

License

MIT — build on it, share it, make it better.

---

Built by FerrellSyntheticIntelligence for the Vitalis ecosystem.