Buildify turns a handful of home requirements — bedrooms, bathrooms, square footage, style — into multiple, ready-to-review architectural floor plans in seconds. Every plan is structurally sound, zero-gap, and compliant with US residential building codes.
Buildify is an end-to-end AI platform for residential architectural design. It combines a locally trained Mixture of Experts (MOE) neural network for intelligent room sizing, HouseGAN++ graph-based spatial topology, and a deterministic zone-based layout solver to produce realistic, buildable floor plans — not hallucinated geometry.
Unlike pure generative approaches, Buildify's hybrid pipeline ensures every plan:
- Has zero gaps between rooms — rooms are packed edge-to-edge on a 2ft construction grid
- Respects US IRC (International Residential Code) minimums — e.g. 70 sq ft for habitable rooms
- Has correct architectural proportions — houses are 60–80 ft wide and 40–65 ft deep, not skyscraper towers
- Varies meaningfully across variants — different garage arrangements, room groupings, and outdoor configurations
| Use Case | Description |
|---|---|
| 🏡 Instant Conceptual Design | Enter beds, baths, sqft and style — get 3 distinct plan variants immediately |
| 📐 Charrette Board Comparison | Compare all generated plans side-by-side as architectural cards with 2D minimaps |
| 🔍 Detailed 2D Review | Click into any plan to examine a scaled, color-coded architectural floor plan with room labels and dimensions |
| 🏠 3D Exterior Visualization | Switch to a clean, white architectural 3D exterior with roof, windows, and lawn |
| 💬 Design Consultation | Use the integrated AI chat to ask questions about your plan, room sizes, or code requirements |
| 📦 Export to CAD | Export any plan as a .dxf file for import into AutoCAD or any professional CAD tool |
| 💰 Cost Estimator | Get a regional cost estimate based on your plan's sqft and room configuration |
Buildify uses a 5-stage hybrid generation pipeline. The diagram below shows exactly how a user request flows from constraints to final plan:
flowchart TD
%% ─── USER INPUT ───────────────────────────────────────────────────
A([👤 User Constraints\n Beds · Baths · SqFt · Style\n Garage · Outdoor · Office]) --> B
%% ─── FRONTEND ─────────────────────────────────────────────────────
subgraph FE ["⚛️ React Frontend (Vite + TypeScript)"]
B[Room Catalog\nConstraint Form]
B --> C[POST /api/generate/moe]
end
%% ─── BACKEND API ──────────────────────────────────────────────────
subgraph BE ["🐍 FastAPI Backend"]
C --> D
subgraph PIPE ["🔁 5-Stage Generation Pipeline"]
direction TB
D["📋 Stage 1 — BUILD\nDeterministic room list\nfrom IRC specs & constraints\n─────────────────\n2-Car Garage · Foyer · Mudroom\nLiving · Dining · Family · Kitchen\nHallway · Primary Suite · Bedrooms\nBathrooms · Patio …"]
D --> E["🧠 Stage 2 — SIZE (MOE Model)\nMixture of Experts neural net\nOutputs 8 expert weights →\nscales each room's W × H\nbased on SqFt & Style target\n─────────────────\n8 Experts: Room Sizing ·\nSpatial Layout · Style Adaptation\nCode Compliance · Adjacency\nCirculation · Outdoor & Garage\nCost Optimization"]
E --> F{"Stage 3 — PLACE\nHouseGAN++ Available?"}
F -- Yes --> G["🕸️ HouseGAN++\nGraph-based bubble diagram\nTopological adjacency placement\nRoom graph → XY coordinates"]
F -- No --> H["🗺️ Zone-Based Architectural Solver\nEntry Band → Garage · Foyer · Mudroom\nSocial Band → Living · Dining · Kitchen\nHallway → Full-width 4 ft spine\nPrivate Band→ Primary Suite · Bedrooms\nOutdoor Band→ Patio · Deck"]
G --> I
H --> I
I["✅ Stage 4 — VALIDATE (IRC)\nEnforce room minimums\n• Habitable rooms ≥ 70 sq ft\n• Bedrooms ≥ 10 × 10 ft\n• Hallway ≥ 36 in wide\nClamp all rooms to footprint"]
I --> J["📐 Stage 5 — REFINE\nSnap to 2 ft construction grid\nClose all inter-room gaps\nForce exact footprint width\nResolve overlaps\n→ Zero-gap guarantee"]
end
J --> K["📊 Confidence Scoring\n+ IRC Compliance Flag\n+ Expert Weight Breakdown"]
end
%% ─── OUTPUT ───────────────────────────────────────────────────────
K --> L
subgraph UI ["🖥️ Plan Viewer (React + Three.js)"]
L["🗂️ Charrette Board\nA · B · C variant cards\nColor-coded 2D minimap\nSqFt · Beds · Baths · Footprint"]
L --> M["📐 2D Architectural Plan\nScaled room layout\nDimensions + Labels\nDoor swings"]
L --> N["🏠 3D Exterior View\nWhite architectural model\nSegmented roofline · Windows\nLawn · Foundation"]
L --> O["🚶 Walk Mode *(coming soon)*\nFirst-person exploration\nPointer-lock + WASD controls"]
L --> P["🔲 Top View *(coming soon)*\nBird's-eye colored blocks\nRoom labels overlay"]
end
M --> Q["📦 Export DXF · Cost Estimate · Design Score"]
Buildify/
├── backend/
│ ├── main.py # FastAPI app — all API routes
│ ├── generator.py # Deterministic floor plan generator
│ ├── scoring.py # Design quality scoring
│ ├── cost.py # Regional cost estimator
│ ├── exporter.py # DXF CAD export
│ ├── rag.py # RAG-based AI design chat
│ └── moe/
│ ├── model.py # BuildifyMOE — PyTorch Mixture of Experts
│ ├── inference.py # 5-stage generation pipeline
│ ├── data.py # IRC room specs + training data synthesis
│ ├── experts.py # 8 named expert definitions
│ ├── config.py # MOE hyperparameters
│ ├── api_auth.py # API key management
│ └── weights/
│ └── buildify_moe.pt # Trained model weights
└── frontend/
├── src/
│ ├── App.tsx # Root layout + routing
│ ├── App.css # Design system + component styles
│ ├── api/client.ts # Typed API client (axios)
│ ├── types/floorplan.ts # Shared TypeScript types
│ └── components/
│ ├── ConstraintForm.tsx # Room catalog sidebar
│ ├── FloorPlanGallery.tsx # Charrette Board (A/B/C cards)
│ ├── FloorPlanPreview.tsx # Color-coded 2D SVG minimap
│ ├── ArchPlan.tsx # Full 2D architectural plan renderer
│ ├── View3D.tsx # Three.js 3D visualization
│ └── FloorPlanEditor.tsx # Plan detail view + mode switcher
└── vite.config.ts
| Layer | Technology | Purpose |
|---|---|---|
| Frontend | React 18 + Vite + TypeScript | UI framework |
| 3D Visualization | Three.js / React Three Fiber | 3D exterior, walk mode |
| 2D Rendering | SVG / Canvas (custom) | Architectural plan renderer |
| Styling | Vanilla CSS (custom design system) | Dark sidebar, Charrette Board |
| Backend | FastAPI (Python 3.11) | REST API layer |
| AI Model | PyTorch — Mixture of Experts | Room sizing intelligence |
| Spatial Layout | HouseGAN++ | Graph-based room placement |
| Building Codes | IRC 2021 (R304, R311.7) | Room minimums & compliance |
| CAD Export | ezdxf | DXF file generation |
cd backend
pip install -r requirements.txt
python3 -m uvicorn main:app --host 0.0.0.0 --port 8002 --reload
# API docs available at http://localhost:8002/docscd frontend
npm install
npm run dev
# App available at http://localhost:5173The Vite dev server proxies all
/api/*requests tohttp://localhost:8002automatically.
For a 3 bed · 2 bath · 1,800 sq ft · Modern home, Buildify generates 3 variants:
| Variant | Dimensions | Rooms | Total Area |
|---|---|---|---|
| Plan A — Optimized | 68 W × 60 D ft | 17 rooms | 2,332 sq ft |
| Plan B — Balanced | 68 W × 62 D ft | 17 rooms | 2,352 sq ft |
| Plan C — Efficient | 68 W × 60 D ft | 17 rooms | 2,388 sq ft |
Each plan includes: 2-Car Garage · Mudroom · Laundry · Foyer · Living Room · Dining Area · Family Room · Kitchen · Pantry · Main Hallway · Primary Suite · Primary Bath · Primary Closet · 2× Bedroom · Shared Bath · Rear Patio
- MOE model training pipeline
- HouseGAN++ integration with zone-based fallback
- IRC compliance validation
- Zero-gap layout guarantee
- Charrette Board UI (A/B/C variant comparison)
- 3D white architectural exterior
- DXF CAD export
- Regional cost estimator
- First-person 3D walkthrough (WASD + pointer lock)
- Top-view colored block mode (bird's-eye with room labels)
- Door/window placement in plans
- Multi-story support
- Direct integration with Autodesk, SketchUp, or Revit
This project is open-source under the MIT License.
Built with 🤖 AI + 📐 Architecture + 🏗️ Engineering