AI_Cycling_Coach

🚴 AI Cycling Coach

An intelligent web app that pairs cyclists with an AI coaching agent to build personalized training plans. Chat with your coach, manage your life schedule, and track your workouts — all in one place.

Features

• AI Coach Chat — Conversational coaching powered by any OpenAI-compatible model
• Training Calendar — FullCalendar view with life events and AI-scheduled workouts
• Workout Logging — Click any workout to log duration, distance, power, heart rate, RPE
• Adaptive Plans — AI considers your logged results and schedule when planning

Quick Start

Prerequisites

• Python 3.11+
• Node.js 18+
• An OpenAI API key OR Ollama installed locally

Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env      # Edit with your API key
python run.py             # Starts on http://localhost:5000

Frontend Setup

cd frontend
npm install
npm run dev               # Starts on http://localhost:3000

Using Ollama (Free, Local AI)

brew install ollama
ollama pull llama3.2
ollama serve

Then in backend/.env:

OPENAI_API_BASE=http://localhost:11434/v1
OPENAI_API_KEY=ollama
OPENAI_MODEL=llama3.2

Documentation

• ARCHITECTURE.md — System design and data flow
• REQUIREMENTS.md — External API requirements
• AGENT.md — Instructions for AI coding agents
• Plan.md — Living project plan

Tech Stack

Layer	Technology
Backend	Python, Flask, SQLAlchemy
Database	SQLite (dev) / PostgreSQL (prod)
AI	OpenAI-compatible API
Frontend	React 18, TypeScript, Vite
Calendar	FullCalendar

License

MIT