soleprint/README.md

Soleprint

Development workflow platform. Run, test, and document everything in one place.

Quick Start

# Build and run standalone
python build.py
cd gen/standalone && docker compose up
# Visit http://localhost:12000

# Build and run with room config
python build.py --cfg <room>
cd gen/<room>/soleprint && docker compose up

Commands

# Build
python build.py                    # -> gen/standalone/
python build.py --cfg <room>       # -> gen/<room>/
python build.py --all              # -> all rooms

# Using ctrl scripts
./ctrl/build.sh                    # Build standalone
./ctrl/build.sh <room>             # Build room
./ctrl/start.sh                    # Start standalone
./ctrl/start.sh <room>             # Start room
./ctrl/stop.sh <room>              # Stop
./ctrl/logs.sh <room>              # View logs

# Bare-metal dev (without Docker)
cd gen/standalone && python run.py

Adding a New Room

# 1. Create room config
mkdir -p cfg/myroom/data
cp cfg/standalone/config.json cfg/myroom/
cp -r cfg/standalone/data/* cfg/myroom/data/

# 2. Build and run
python build.py --cfg myroom
cd gen/myroom/soleprint && docker compose up

Or use the generation UI: python -m http.server 8080 in spr/ and visit /generate.html.