AI-powered 18DOF hexapod dance robot that learns African dances from YouTube and curates a dance database. Raspberry Pi 5 + Hermes Agent.
# πΊ Dance Robot
**AI-powered 18DOF hexapod dance robot** β learns African dances from YouTube, iteratively refines them, and curates a dance database.
Runs on **Raspberry Pi 5 (8GB)** with **Sense HAT (B)**, powered by onboard **Hermes Agent** with cloud LLM.
---
## Architecture
```
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β DANCE ROBOT BRAIN β
β β
β YouTube/Web βββ DanceLearner βββ PoseExtractor βββ MoveMapper β
β β β
β Sense HAT βββ AlwaysOnBeat βββ BeatDetector βββ DanceEngine βββ ServoDriver (18DOF)
β (IMU+mic) Detector (FFT+BPM) (routine exec) β
β β β
β Microphone βββ VoiceLearner βββ IntentParser βββ PhraseCache β
β β β
β Hermes Agent βββ Cortex (Cloud LLM) βββ DecisionEngine β
β (onboard) β β
β ββββ IterationEngine βββ DanceDB (SQLite) β
β (expected vs actual) (versioned, curated) β
β β
β All modules βββ EventBus βββ SafetyGovernor βββ Web Dashboard β
β (async pub/sub) (8 checks) (FastAPI+WS) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
## Features
### π΅ Dance Learning
- **YouTube β Pose β Move pipeline**: Search, download, extract poses, map to 18DOF servo angles
- **8 African dance primitives**: Azonto, Gwara Gwara, Shaku Shaku, Alkayida, Zanku, Amapiano, Soukous, and more
- **36 pre-built moves** across 6 categories (Body, Legs, Arms, Poses, Combos, African)
### π Iterative Refinement
- **Expected vs Actual comparis β¦