Coach Watts

Your Open Source AI-Powered Endurance Coach

Key Features • Quick Start • Integrations • Documentation

---

🚀 Overview

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.

✨ Key Features

• 🔗 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.

🔌 Integrations

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

⚡ Quick Start

Prerequisites

• Node.js 20+
• Docker (for PostgreSQL)
• Google Cloud Account (for Auth & Gemini API)

1. Clone & Install

git clone https://github.com/newpush/coach-wattz.git
cd coach-wattz
pnpm install

2. Start Database

docker-compose up -d
# Starts PostgreSQL on port 5439

3. Configure Environment

Copy the example env file and fill in your API keys:

cp .env.example .env

Note: You will need API keys for Google (Auth & Gemini), and optionally Intervals.icu, Strava, etc. See Getting Credentials.

4. Run Migrations

pnpm prisma:generate
npx prisma migrate dev

5. Launch Development Server

pnpm dev

Visit http://localhost:3099 and log in!

📚 Documentation

We have extensive documentation available in the docs/ directory:

• Architecture: System design and data flow.
• Database Schema: Detailed Prisma models.
• Feature Guides:
  • AI Chat System
  • Scoring System
  • Integration Guides

🤝 Contributing

We welcome contributions! Whether it's fixing bugs, improving documentation, or suggesting new features.

1. Fork the repo.
2. Create a branch (git checkout -b feature/amazing-feature).
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

📄 License

Distributed under the MIT License. See LICENSE for more information.

❤️ Community & Support

• Discord: Join our Server
• GitHub: Star us on GitHub
• Issues: Report a Bug

---

Made with ❤️ for endurance athletes.