Your Open Source AI-Powered Endurance Coach
Key Features • Quick Start • Integrations • Documentation • Release Notes • Acknowledgements
Coach Watts is a comprehensive, self-hosted endurance coaching platform designed for cyclists, runners, and triathletes. It acts as your "Digital Twin," aggregating data from your favorite fitness platforms and using Google Gemini AI to provide professional-level analysis, personalized training plans, and daily recommendations.
Unlike static dashboards, Coach Watts understands context—analyzing not just your power numbers, but your recovery, sleep, nutrition, and life stress to guide you toward peak performance.
- 🔗 Unified Data Hub: Syncs automatically with multiple fitness platforms to create a 360° view of your athlete profile.
- 🤖 AI Coach:
- Workout Analysis: Detailed breakdown of every session with execution scores.
- Daily Recommendations: Smart suggestions ("Push hard" vs "Rest") based on HRV and sleep.
- Interactive Chat: Ask questions like "How is my fatigue compared to last month?" and get data-backed answers.
- 📈 Advanced Analytics: Track Fitness (CTL), Fatigue (ATL), Form (TSB), and Power Curves with intuitive visualizations.
- 🥗 Nutrition Tracking: AI analysis of your macro intake vs. training demands.
- 📅 Smart Planning: Generate adaptive training plans that fit your schedule and goals.
| Performance Analytics | Training Calendar |
|---|---|
 |
 |
| AI Workout Analysis | Adaptive Planning |
|---|---|
 |
 |
| Planned Workouts | AI Coach Settings |
|---|---|
 |
 |
Coach Watts connects seamlessly with:
| Platform | Features Synced |
|---|---|
| Intervals.icu | Workouts, Calendar, Power Metrics, Fitness/Fatigue |
| Strava | Activity Data, GPS Streams, Heart Rate |
| Whoop | Recovery, HRV, Sleep, Strain |
| Yazio | Nutrition Logs, Macros, Hydration |
| Withings | Body Composition (Weight, Fat %), Sleep, Wellness |
| Hevy | Strength Training, Exercises, Sets & Reps |
| Fitbit | Steps, Sleep, Activity, Heart Rate |
| Oura | Readiness, Sleep, Activity, HRV |
| Polar | Training Sessions, Wellness, Recovery |
- Node.js 20+
- Docker (for PostgreSQL)
- Google Cloud Account (for Auth & Gemini API)
git clone git@github.com:hdkiller/coach.git
cd coach
cp .env.example .env
pnpm installdocker-compose up -d
# Starts PostgreSQL on port 5439Note for MacOS users: Ensure Docker Desktop is running (e.g. open Docker.app via Spotlight).
Edit the .env file to fill in your own API keys (see below):
vim .env # or on MacOS: open -a TextEdit .envNote: You will need API keys for Google (Auth & Gemini), and optionally Intervals.icu, Strava, etc. See Getting Credentials.
pnpm prisma:generate
npx prisma migrate devpnpm devVisit http://localhost:3099 and log in!
We have extensive documentation available in the docs/ directory:
- Architecture: System design and data flow.
- Database Schema: Detailed Prisma models.
- Release Notes: Detailed change logs for each version.
- Feature Guides:
We welcome contributions! Whether it's fixing bugs, improving documentation, or suggesting new features.
- Fork the repo.
- Create a branch (
git checkout -b feature/amazing-feature). - Commit your changes.
- Push to the branch.
- Open a Pull Request.
Distributed under the Apache License 2.0. See LICENSE for more information. Acknowledgements of third-party assets and contributors can be found in ACKNOWLEDGEMENTS.md.
Yes. Coach Watts is open source using the Apache 2.0 license. We are committed to open source software and working with our community to build a great product.
- Discord: Join our Server
- GitHub: Star us on GitHub
- Issues: Report a Bug
Made with ❤️ for endurance athletes.