Robot mainboard

RoboTheater/
├── apps/
│   ├── authoring-tool/      # LLM story generation (Flask + web UI)
│   └── performance-runner/  # TTS playback + MQTT motion
├── firmware/
│   ├── robot-controller/    # Robot firmware (PlatformIO)
│   └── test/                # Motor / fidget hardware tests
├── electronics/
│   ├── kicad/               # Mainboard schematic & PCB
│   └── fabrication/         # Gerbers, BOM, positions
├── mechanical/              # 3D chassis & wheel models
├── example/                 # Sample story JSON scripts
├── assets/                  # Images for this README
├── .env.example             # Environment variable template
├── CITATION.cff
└── LICENSE

cd firmware/robot-controller
cp include/config.example.h include/config.h

pio run --target upload

cp .env.example .env
# Edit .env — fill in OPENAI_API_KEY, ELEVENLABS_API_KEY, MQTT_BROKER, MQTT_PORT

set -a && source .env && set +a

cd apps/authoring-tool/backend && pip install -r requirements.txt
cd ../../performance-runner && pip install -r requirements.txt

cd apps/authoring-tool/backend
python app.py

cd apps/performance-runner
python run_performance.py ../authoring-tool/backend/story.json --audio-mode local

cd apps/performance-runner
python run_performance.py ../../example/A\ Magical\ Christmas\ Conspiracy.json --dry-run

@inproceedings{10.1145/3731459.3779333,
  author    = {Gao, Yinghao and Yang, Yongbo and Zhong, Chenwan Halley and Zhang, Xinyi and Song, Junrong and Kim, Lawrence H and Chang, Tengfei and Tong, Xin},
  title     = {RoboTheater: A Multi-Robot Storytelling Platform from LLM Scripts to Stage Performance},
  year      = {2026},
  isbn      = {9798400718687},
  publisher = {Association for Computing Machinery},
  address   = {New York, NY, USA},
  url       = {https://doi.org/10.1145/3731459.3779333},
  doi       = {10.1145/3731459.3779333},
  booktitle = {Proceedings of the Twentieth International Conference on Tangible, Embedded, and Embodied Interaction},
  articleno = {73},
  numpages  = {7},
  keywords  = {Multi-Robot Systems; Human-Robot Interaction (HRI); Storytelling},
  series    = {TEI '26}
}