SuperSpace

The Ultimate Floor Plan BOOM TreeHacks 2026

Youtube Demo: https://youtu.be/1rtGnGzZgrw

Setup

uv venv
source .venv/bin/activate
uv sync

Connect Modal and create the shared volume once:

modal token new
modal volume create floorplan-volume

Generate 3D assets

Shap-E:

uv run modal run scripts/generate_3d_asset/modal_shape_e_generate.py \
  --prompt "Green Office Chair" \
  --guidance-scale 18 \
  --karras-steps 96 \
  --output-path "generated_assets/green_office_chair.ply"

Point-E:

uv run modal run scripts/generate_3d_asset/modal_point_e_generate.py \
  --prompt "Green Office Chair" \
  --karras-steps 96 \
  --grid-size 96 \
  --output-path "generated_assets/green_office_chair_point_e.ply"

Generate and place asset into a scene

One command (generate with Shap-E + place in scene):

uv run python scripts/generate_and_place_shap_e_asset.py \
  examples/Bathroom_Mesh.ply \
  "Green Office Chair" \
  --output examples/Bathroom_With_Green_Office_Chair.ply

Higher quality generation:

uv run python scripts/generate_and_place_shap_e_asset.py \
  examples/Bathroom_Mesh.ply \
  "Green Office Chair" \
  --guidance-scale 20 \
  --karras-steps 128 \
  --output examples/Bathroom_With_Green_Office_Chair_hq.ply

Optional placement tuning:

uv run python scripts/generate_and_place_shap_e_asset.py \
  examples/Bathroom_Mesh.ply \
  "Green Office Chair" \
  --target-footprint-ratio 0.08 \
  --offset-x 0.1 \
  --offset-z -0.1 \
  --y-lift 0.0 \
  --output examples/Bathroom_With_Green_Office_Chair_tuned.ply

If you already have an asset PLY and only want placement:

uv run python scripts/place_asset_in_scene.py \
  examples/Bathroom_Mesh.ply \
  generated_assets/green_office_chair.ply \
  --output examples/Bathroom_With_Green_Office_Chair.ply

Render and interact with the world

Start the viewer:

cd viewer
npm install
npm run dev:world -- --file ../examples/Bathroom_With_Green_Office_Chair.ply

Render other files the same way:

npm run dev:world -- --file ../examples/Bathroom_Mesh.ply
npm run dev:world -- --file ../examples/Living_Room_Mesh.glb

Viewer controls:

• Click Click to enter: pointer lock + FPS mode.
• W/A/S/D: move
• E / C: up / down
• Shift: sprint
• F: pick up asset at screen center
• G: place held asset in free 3D space (in front of camera)
• +: open scale dialog for held asset
• Scaling now accepts decimals (for example, 0.5 scales to half size).
• Scale dialog: enter a positive multiplier (0.5 = half size, 2 = 2x), then Enter/Apply
• Scale dialog: Esc/Cancel closes without changing scale
• Esc: unlock cursor
• Top-right gizmo: world X/Y/Z + plane orientation (XY/XZ/YZ)

New backend (backend/)

Simple FastAPI service that wraps the existing Modal Shap-E generator script:

• POST /generate-ply with JSON body:
  • prompt (string, required)
  • guidance_scale (float, optional, default 18)
  • karras_steps (int, optional, default 96)
• GET /health

Run locally:

cd backend
uv pip install -r requirements.txt
uvicorn app:app --reload --port 8000

Deploy on Modal:

cd backend
modal serve modal_app.py

New frontend (frontend/)

Vite web app that reuses the existing viewer/main.js engine and adds:

• startup-style side panel UI
• local browser persistence of uploaded room .ply files (IndexedDB)
• prompt input that calls backend POST /generate-ply
• generated mesh insertion into the live viewer as movable assets

Run:

cd frontend
npm install
npm run dev