Skip to content

RunFestival

RunFestival puts an AI running coach in your earbuds.

Core trick

Streams Claude's reply sentence by sentence into OpenAI TTS so the coach starts speaking within five seconds of a request.

Tags

Description

RunFestival puts an AI running coach in your earbuds. Pick a persona and go — Claude talks to you in real time throughout your run. A multi-agent system powers every coaching moment. Claude Opus 4.6 serves as Head Coach with four personas: Hype Coach, Calm Guide, Data Nerd, and Storyteller. Two zero-cost rule-based agents — a Pace Strategist and a research-backed Motivation Engine — enrich every prompt without additional API calls. The Motivation Engine implements findings from four peer-reviewed sports psychology papers: six run phases, "how" vs "why" mindset modes, momentum detection across splits, and self-talk cues from endurance research. The voice pipeline achieves <5s latency by streaming Claude's response sentence-by-sentence through OpenAI TTS. Runners can talk back — tap the mic and Claude responds with full context. Community presence shows who's running worldwide right now. Because running alone doesn't mean running lonely. https://runfestival.vercel.app
spenceryang/RunFestival★ 00 forksTypeScriptCreated Feb 11, 2026 · last push Feb 16, 2026

README excerpt

# RunFestival

**You run alone. You never run alone.**

RunFestival is a Progressive Web App that turns solo runs into shared experiences with real-time AI voice coaching and live community presence. Strava is great *after* the run. RunFestival is great *during* the run.

## What It Does

Open the app, pick your coaching persona, and go. Your AI coach runs with you in real time:

- **Coaches your pace** — announces splits, detects pace drift, adjusts strategy mid-run
- **Talks to you** — tap the mic and speak; your coach responds conversationally with full run context
- **Motivates through community** — "1,247 people running with you right now"
- **Tells stories** — when you're in a groove, it tells fascinating stories from topics you choose
- **Recaps your run** — AI-generated narrative, pace heatmap on a map, split analysis

Think Peloton energy, but for the open road.

## Features

### Multi-Agent AI Coaching
- **Head Coach (Opus 4.6)** — 4 coaching personas with distinct voices and personalities
- **Pace Strategist** — Rule-based split analysis, finish projection, pacing strategy classification
- **Motivation Engine** — Research-backed: 6 run phases, "how" vs "why" mindset modes, momentum detection, self-talk cues, experience-adaptive coaching
- **Story Curator** — Async story planning for idle storytelling triggers
- **Quality Supervisor** — Reviews every 3rd coaching message, improves future prompts
- Sentence-level streaming for <5s latency (Claude API to OpenAI TTS to

Team