CoolFace
Apppublic

Boopster/reachy_mini_danceml

sourceHugging Faceupdated 9mo agoView on Hugging Face
6likes
App README

Reachy Mini DanceML

👋 Voice-controlled movement SDK for Reachy Mini robot.

Features

  • —🎤 Voice Control: Natural language commands via OpenAI Realtime API
  • —🧠 AI Agent: 11 function-calling tools for movement control
  • —📚 Move Library: 101 pre-recorded dances and emotional expressions
  • —🌊 Procedural Motion: Generate continuous animations with waveforms
  • —🎬 Sequence Planning: Multi-step choreography via GPT-4.1 planner
  • —🎯 Precise Control: Keyframe animations with smooth interpolation

Quick Start

bash
# Install dependencies
pip install -e .

# Set your OpenAI API key
export OPENAI_API_KEY="your-key-here"

# Run the app
reachy-mini-daemon

Then open http://localhost:8042 to interact via voice.

Available Tools

ToolDescription
goto_poseMove to specific head/body angles
look_atLook at direction or 3D point
stop_movementStop and return to neutral
search_movesSearch 101 library moves
play_movePlay a library move
generate_motionProcedural motion with waveforms
execute_sequenceMulti-step choreography
wake_up / goto_sleepLifecycle animations
motor_controlEnable/disable motors
get_choreography_guideLoad movement reference

Documentation

  • —📖 Architecture - System design & tool reference
  • —🎭 Choreography Guide - Movement creation rules
  • —📚 SDK Documentation - API details

HuggingFace Dataset

python
from datasets import load_dataset

ds = load_dataset("pollen-robotics/reachy-mini-dances-library")
print(ds['train'][0]['description'])  # "A sharp, forward, chicken-like pecking motion."

Example: Procedural Motion

python
# Via voice: "Do a spiral motion while rising up"
# Or programmatically:
generate_motion(
    motion_type="spiral", 
    z_drift=0.02, 
    duration=5
)

Tags

reachymini, voicecontrol, robotics, openai, dance