🏎️ Reachy F1 Commentator

Bring Formula 1 races to life with your Reachy Mini robot

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

Live Race Dashboard

Track race positions in real-time with our integrated live leaderboard

🏁 Live Leaderboard

Live Preview
1
Max VERSTAPPEN
Leader
S
2
Lewis HAMILTON
+2.345s
M
3
Charles LECLERC
+5.891s
S
4
Sergio PEREZ
+8.234s
H
5
Carlos SAINZ
+12.567s
M
🏆

Podium Highlighting

Gold, silver, and bronze styling for top 3 positions

🔴

Tire Strategy

Color-coded tire compounds (Soft/Medium/Hard)

⏱️

Live Gaps

Real-time time differences to race leader

📊

Full Dashboard

Detailed view with pit stops, fastest laps, and events

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 v3 API with emotional variation support creates natural, expressive commentary. Includes a professional "British Sports Broadcaster" voice out of the box - perfect for authentic F1 commentary that adapts to race excitement.

🤖

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

1

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).

2

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.

3

Audio Synthesis & Robot Control

Commentary is converted to natural speech via ElevenLabs, streamed to Reachy's speakers, and synchronized with expressive head movements.

4

Live Commentary Experience

Watch as Reachy brings the race to life with dynamic commentary, tracking overtakes, pit stops, fastest laps, and dramatic moments.

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

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.

🎙️ Professional Broadcasting Quality

Powered by ElevenLabs v3 API with emotional variation for authentic F1 commentary

🎭

Emotional Variation

Using the latest ElevenLabs v3 API, commentary dynamically adjusts tone and emotion based on race excitement. From calm strategic analysis to thrilling overtake moments, the voice naturally adapts to match the action.

🇬🇧

British Sports Broadcaster Voice

Includes a professional "British Sports Broadcaster" voice out of the box - no configuration needed. The authentic accent and delivery style creates an immersive F1 experience that feels like watching live coverage.

Streaming Audio

Low-latency streaming ensures commentary stays synchronized with race events. Audio begins playing within milliseconds of generation, creating a seamless real-time experience.

Emotional Range Examples

😐 Calm

"Hamilton maintains position in P2, managing the gap to Verstappen ahead."

😊 Interested

"Leclerc is closing in on Perez - this could get interesting!"

😃 Excited

"Hamilton is right on Verstappen's gearbox - DRS enabled!"

🤩 Thrilled

"THERE IT IS! Hamilton takes the lead! What a move!"

Installation

🎯 Via Reachy Dashboard (Recommended)

  1. Open your Reachy Mini dashboard at http://reachy-mini:8000
  2. Navigate to the Apps section
  3. Find Reachy F1 Commentator in the app store
  4. 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) - British Sports Broadcaster voice included
  • 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!