README.md

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

<p align="center">
  <img src="https://img.shields.io/badge/Vitalis-DevCore-7c3aed?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDAiIGhlaWdodD0iNDAiIHZpZXdCb3g9IjAgMCA0MCA0MCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48cmVjdCB4PSI0IiB5PSI0IiB3aWR0aD0iMzIiIGhlaWdodD0iMzIiIHJ4PSI0IiBzdHJva2U9IiM3YzNhZWQiIHN0cm9rZS13aWR0aD0iMiIvPjxwYXRoIGQ9Ik0xNCAxOGw0LTQgNCA0LTIgMi0yLTItMiAyeiIgZmlsbD0iIzdjM2FlZCIvPjwvc3ZnPg==" alt="Vitalis DevCore"/>
</p>

<h1 align="center">Vitalis DevCore — 3D Blueprint Builder</h1>

<p align="center">
  <strong>→ Rival Codex: Natural Language → Interactive 3D Architecture</strong>
</p>

<p align="center">
  <a href="https://huggingface.co/spaces/FerrellSyntheticIntelligence/Vitalis-DevCore">
    <img src="https://img.shields.io/badge/🤗%20HF%20Spaces-Live-7c3aed?style=flat-square" alt="HF Spaces"/>
  </a>
  <a href="https://github.com/AnonymousNomad/Vitalis-DevCore">
    <img src="https://img.shields.io/badge/GitHub-Source-181717?style=flat-square&logo=github" alt="GitHub"/>
  </a>
  <a href="https://www.buymeacoffee.com/anonymousnomad">
    <img src="https://img.shields.io/badge/Sponsor-%E2%9D%A4%EF%B8%8F-ff69b4?style=flat-square" alt="Sponsor"/>
  </a>
</p>

---

## 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](https://huggingface.co/spaces/FerrellSyntheticIntelligence/Vitalis-DevCore)
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
```bash
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:

<p align="center">
  <a href="https://www.buymeacoffee.com/anonymousnomad">
    <img src="https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me A Coffee"/>
  </a>
  <a href="https://github.com/sponsors/AnonymousNomad">
    <img src="https://img.shields.io/badge/GitHub_Sponsor-%23EA4AAA?style=for-the-badge&logo=github&logoColor=white" alt="GitHub Sponsor"/>
  </a>
</p>

## License

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

---

*Built by FerrellSyntheticIntelligence for the Vitalis ecosystem.*