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 …