Interactive Race Commentary Meets Robotics
Transform your Reachy Mini into an enthusiastic F1 commentator with organic, context-rich commentary, synchronized movements, and professional audio synthesis.
See It In Action
Features
Enhanced Organic Commentary
210 unique templates with 5 excitement levels and 5 perspectives (technical, strategic, dramatic, positional, historical) for natural-sounding commentary that never repeats.
Quick Demo Mode
2-3 minute pre-configured demonstration perfect for showcasing. No internet required - includes overtakes, pit stops, fastest laps, and incidents.
Full Historical Race Mode
Replay any F1 race from 2023-2025 using real data from the OpenF1 API. China 2025 is recommended as it has complete telemetry (221 overtakes, 25 pit stops). Note: Not all races have full data available.
Professional Audio Synthesis
ElevenLabs text-to-speech integration with streaming audio for natural, expressive commentary that plays through Reachy's speakers.
Synchronized Robot Movements
Reachy's head movements are perfectly synchronized with commentary excitement levels, creating an engaging and lifelike presentation.
Intuitive Web Interface
Browser-based control panel for race selection, playback speed (1x-20x), and configuration. Easy to use, no command-line required.
How It Works
Select Your Race
Choose from Quick Demo mode or browse historical F1 races from 2023-2025. Try China 2025 for the best experience - it has complete telemetry data with 221 overtakes and 25 pit stops. Configure your preferred playback speed (1x-20x).
AI-Powered Commentary Generation
The system analyzes race events in real-time, enriches context from multiple data sources, and generates organic commentary using 210 unique templates.
Audio Synthesis & Robot Control
Commentary is converted to natural speech via ElevenLabs, streamed to Reachy's speakers, and synchronized with expressive head movements.
Live Commentary Experience
Watch as Reachy brings the race to life with dynamic commentary, tracking overtakes, pit stops, fastest laps, and dramatic moments.
Technical Highlights
Context Enrichment
Pulls data from multiple OpenF1 API endpoints to create rich, contextual commentary with driver stats, team info, and race history.
Narrative Tracking
Detects ongoing battles, comebacks, and strategy divergence to create compelling story arcs throughout the race.
Frequency Controls
Intelligent tracking prevents repetitive content patterns, ensuring fresh commentary throughout long races.
Event Prioritization
Significance scoring with context bonuses ensures the most important moments get the attention they deserve.
Installation
🎯 Via Reachy Dashboard (Recommended)
- Open your Reachy Mini dashboard at
http://reachy-mini:8000 - Navigate to the Apps section
- Find Reachy F1 Commentator in the app store
- Click Install - all dependencies are handled automatically
✨ The easiest way to install - one-click installation with automatic dependency management.
Via Reachy Mini App Assistant
reachy-mini-app-assistant install reachy-f1-commentator
Command-line installation for users who prefer terminal access.
Manual Installation (Advanced)
pip install git+https://huggingface.co/spaces/d10g/reachy-f1-commentator
For advanced users or custom installations.
Requirements
- Reachy Mini robot (or simulation mode for development)
- Python 3.9+
- ElevenLabs API Key for audio synthesis (sign up here)
- Internet Connection for Full Historical Race mode
💡 Tip: Start with China 2025 for the best historical race experience - it has complete overtake, pit stop, and race control data.
Quick Start
1. Launch the App
Start from the Reachy Mini dashboard or run directly:
python -m reachy_f1_commentator.main
2. Open Web Interface
Navigate to http://reachy-mini:8080 in your browser to access the control panel.
3. Configure & Start
Enter your ElevenLabs API key, select a race or demo mode, choose playback speed, and hit Start Commentary!
Architecture
Built with modern Python and designed for extensibility:
Web Interface
FastAPI + HTML/CSS/JS
Commentary Engine
Template Library + Context Enricher + Narrative Tracker
Output Layer
Speech Synthesizer + Motion Controller
Reachy Mini
Audio Playback + Head Movements
Credits & Acknowledgments
Pollen Robotics
Reachy Mini platform and SDK
Hugging Face
App hosting and distribution
OpenF1
Historical race data API
ElevenLabs
Text-to-speech synthesis
Ready to Get Started?
Install Reachy F1 Commentator today and bring Formula 1 races to life with your robot!
Commentary Variations
Every event has multiple commentary variations with different excitement levels and perspectives:
Example: Overtake for P1
"Fantastic overtake by Hamilton on Verstappen, now in P1!"
"There it is! Hamilton takes the lead from Verstappen!"
"Hamilton makes a brilliant move on Verstappen for P1!"
"And Hamilton is through! That's P1 now for Hamilton!"
210 unique templates across 5 excitement levels and 5 perspectives ensure fresh, natural-sounding commentary throughout the race