52 lines
1.2 KiB
Markdown
52 lines
1.2 KiB
Markdown
# Soleprint
|
|
|
|
Development workflow platform. Run, test, and document everything in one place.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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`.
|