Reachy's Brain
Turn your iPhone into the brain for Reachy Mini
Control your Reachy Mini from your iPhone. Voice conversations, animations, weather, web search, vision, and more — all processed on the robot.
Features
Everything you need for natural robot conversations
Natural Speech
OpenAI TTS with 8 expressive voices. Multilingual support for conversations in any language.
Real-time Voice
OpenAI Realtime API for fluid, interruption-aware conversations with sub-second latency.
Expressive Animations
Head movements, gestures, and emotional expressions that bring Reachy to life.
Animation Recording
Record custom animations by moving Reachy's head. Save and replay your creations.
Built-in Tools
Weather forecasts, news updates, web search, current time, and camera vision for smart interactions.
Vision & Camera
Reachy can see and describe what's in front of it using the built-in camera.
iOS Reminders
Create and manage reminders on your iPhone through voice commands. Never forget important tasks.
Notes
Capture thoughts and ideas instantly. Dictate notes to Reachy and save them to your device.
Meeting Notes
Automatic meeting note taker. Reachy listens, summarizes, and captures key points from your conversations.
Scheduled Messages
Schedule WhatsApp and iMessage messages to be sent later. Perfect for birthday wishes and reminders.
iOS Contacts
Access your iPhone contacts through voice. Find phone numbers, emails, and contact details instantly.
Play Chess
Challenge Reachy to a game of chess. Play using voice commands and watch Reachy react to your moves.
Memory Game
Test your memory with interactive card matching games. Reachy keeps track and celebrates your wins.
Location
Get your current location and find places nearby. Ask about distances and directions.
Tamareachy
Virtual pet mode! Take care of Reachy by feeding, playing, and keeping it happy. Watch its mood change.
Create Apps
Build custom apps for Reachy using natural language. Describe what you want and watch it come to life.
Custom Personalities
Create unique AI personalities with different voices, behaviors, and conversation styles.
Vibe Coding
Generate websites and web apps through conversation. Describe your vision and Reachy builds it.
Ultra Low Latency
Local WiFi communication with ~1-5ms response times. No cloud dependency for control.
Privacy First
Your API keys stay on Reachy. All processing happens on the robot itself.
Feature Examples
See what you can do with Reachy's Brain
Voice Conversations
Have natural, flowing conversations with Reachy using OpenAI's Realtime API.
Weather
Get current weather conditions and forecasts for any location.
News
Stay informed with the latest news headlines and stories.
Web Search
Search the web for information, facts, and answers.
Vision & Camera
Reachy can see and describe what's in front of it.
iOS Reminders
Create and manage reminders directly on your iPhone.
Notes
Quickly capture thoughts and ideas through voice.
Meeting Notes
Automatic meeting transcription and summarization.
Scheduled Messages
Schedule WhatsApp and iMessage messages to be sent at a specific time.
iOS Contacts
Access your iPhone contacts and find contact information.
Play Chess
Challenge Reachy to a game of chess using voice commands.
Memory Game
Play memory card matching games with Reachy.
Location
Get your current location and find nearby places.
Tamareachy
Take care of Reachy like a virtual pet - feed it, play with it, and keep it happy!
Animations
Trigger expressive head movements and gestures.
Create Apps
Build custom apps for Reachy using natural language.
Vibe Coding
Generate websites and web apps through conversation.
Date & Time
Get current time, dates, and time zone information.
Architecture
A three-layer system designed for responsiveness
iOS App
Native SwiftUI app for controlling Reachy, viewing conversations, and managing settings.
iOS Bridge
Python FastAPI server handling speech, TTS, voice conversations, and tools on Reachy.
Reachy Daemon
Built-in system daemon for motor control, animations, volume, and hardware management.
Getting Started
Up and running in minutes
Install on Reachy Mini
From the Reachy Mini dashboard, install this app from Hugging Face:
robertkeus/reachys-brain
Or install manually with pip:
pip install git+https://huggingface.co/spaces/robertkeus/reachys-brain
Start the Bridge
From the Reachy Mini dashboard (e.g. http://reachy.local:8000), select "Reachy's Brain" from installed applications.
The HTTP server will start on port 8080.
Get the iOS App
Coming Soon
The companion iOS app will be available on the App Store.
Requires iOS 17 or newer.
Configure & Connect
In the iOS app Settings:
- Enter Reachy's IP address (find with
hostname -I) - Add your OpenAI API key
- Choose your preferred voice
Bridge API Reference
HTTP endpoints on port 8080 for custom integrations
/status
Get current robot status including connection, speaking, and animation states.
{
"connected": true,
"speaking": false,
"animation_playing": false
}
/speak
Send text for text-to-speech with optional emotion.
{
"text": "Hello!",
"emotion": "happy"
}
neutral, happy, sad, surprised, thinking
/motion
Trigger a head animation by name.
{
"animation": "nod",
"duration": 1.5
}
nod, shake, happy, thinking, and more
/voices
List available OpenAI TTS voices.
alloy, ash, coral, echo, sage, shimmer, verse, ballad
/voice
Set the active TTS voice.
{ "voice_id": "coral" }
/stop
Stop current speech and animation immediately.
See the full API documentation for all endpoints.
Voice Library
8 expressive voices powered by OpenAI
Alloy
Neutral, balanced
Coral
Clear, friendly
Sage
Calm, wise
Ash
Soft, warm
Echo
Deep, resonant
Ballad
Expressive, storytelling
Shimmer
Bright, energetic
Verse
Dynamic, engaging
Troubleshooting
Common issues and solutions
🔇 No Sound from Reachy?
- Check volume:
GET /volumeshould return a value > 0 - Test audio:
speaker-test -D plug:reachymini_audio_sink -c 1 -t sine -f 440 -l 1 - Verify the daemon is running:
GET http://reachy.local:8000/api/daemon/status
🔑 TTS Not Working?
- Check if API key is set:
GET /openai/api-keyshould return{"configured": true} - Set the key in iOS app Settings or via API
- Check server logs for OpenAI errors
📡 Can't Connect to Reachy?
- Ensure iPhone and Reachy are on the same WiFi network
- Find Reachy's IP:
hostname -I - Try
http://reachy.local:8080if mDNS is available - Check that the bridge app is running on port 8080
🤖 Animations Not Playing?
- Verify Reachy is connected:
GET /statusshould show"connected": true - Wake the robot:
POST /robot/wake - Check that motors are enabled in the daemon dashboard
Requirements
What you need to get started
iOS Device
- iPhone running iOS 17+
- Same WiFi network as Reachy
- OpenAI API key
Reachy Mini
- Reachy Mini Wireless
- Python 3.10+
- Same WiFi as iPhone
Privacy Policy
Data Collection
Reachy's Brain does not collect, store, or transmit any personal data to external servers operated by us. All data processing happens locally on your Reachy Mini robot.
OpenAI API
Voice conversations and text-to-speech are processed through OpenAI's API using your own API key. Your conversations are subject to OpenAI's Privacy Policy. We do not have access to your API key or conversation data.
Camera & Vision
When using vision features, images from Reachy's camera are sent to OpenAI for processing. These images are not stored by us and are handled according to OpenAI's data policies.
Local Storage
Settings, recorded animations, and conversation history are stored locally on your Reachy Mini. No data is synced to cloud services.
Network Communication
The iOS app communicates with Reachy over your local WiFi network. No data is transmitted outside your network except for OpenAI API calls.
Terms of Service
Acceptance
By using Reachy's Brain, you agree to these terms. If you do not agree, please do not use the software.
License
This software is provided under the MIT License. You are free to use, modify, and distribute it according to the license terms.
API Keys
You are responsible for your own OpenAI API key and any costs incurred through its use. Keep your API key secure and do not share it.
No Warranty
This software is provided "as is" without warranty of any kind. We are not liable for any damages arising from its use.
Robot Safety
You are responsible for the safe operation of your Reachy Mini robot. Ensure the robot is placed securely and supervise its operation.
Third-Party Services
Use of OpenAI services is subject to their terms. We are not responsible for third-party service availability or changes.