Get started
Quickstart·
Clone, pick a model, point TINY at a daemon — real robot or MuJoCo — and get the first antenna wobble in three minutes.
In 10 seconds
make venv && make runtalks to a daemon on:8000;make simspawns MuJoCo instead.- Default brain: Bedrock (
TINY_MODEL_ID); voice: OpenAI Realtime. - Every gesture is clamped — nothing here can hurt the robot.
| mode | what runs where | when |
|---|---|---|
| Lite | daemon on your laptop over USB, TINY beside it | developing tools |
| Wireless | daemon + TINY on the CM4 | a robot on a desk → systemd |
| Simulation | REACHY_USE_SIM=1, headless MuJoCo |
no hardware, CI → docker |
1. Clone and run·
git clone https://github.com/cagataycali/tiny-the-reachy.git
cd tiny-the-reachy
cp .env.example .env && $EDITOR .env # fill in your keys (below)
make venv # .venv + deps
make run # REPL against the Reachy daemon
2. Pick a model·
export AWS_BEARER_TOKEN_BEDROCK=... # Bedrock bearer token (preferred)
export AWS_DEFAULT_REGION=us-west-2
export TINY_MODEL_ID=global.anthropic.claude-opus-4-8 # override the default
Voice: OPENAI_API_KEY.
3. Connect·
4. Talk to it·
> check state
reachy_state → head pitch/roll/yaw 0/0/0 · antennas 0/0 · body_yaw 0 · imu ok
> show me you're happy to meet me
reachy_express("cheerful1") · reachy_antennas(wiggle) — the closest of 81 moves to "happy"
Same tools as the personas — all 28.
Safe first commands
check state · wake up · look at me · wiggle your antennas · nod · spin around · go home
Expression is the whole point
Ask it to feel something, not do something: be curious, act shy.
One-shot mode·
On the real robot·
How TINY boots (systemd) → Deploying to the robot → Meet the personas →