Aixle is an automated, open-source cycling coach powered by Google Gemini AI and Intervals.icu.
It acts as the "axle" of your training—analyzing your data and driving your performance forward. Every morning, Aixle calculates your fatigue and training phase, then authors a custom Zwift workout (.zwo) tailored specifically to your goal.
- Smart Periodization: Automatically determines if you are in Base, Build, or Peak phase based on your target race date.
- Daily AI Generation: Creates engaging workouts (Pyramids, Over-Unders) with embedded text instructions, tailored to your daily TSB (Fatigue).
- Context Aware: Pushes you when you're fresh, protects you when you're tired.
- Zwift Compatible: Generates standard
.zwofiles with cadence targets and motivational messages. - Auto-Sync: Includes a script to sync workouts from Google Drive to Zwift automatically.
- Google Account (for Gemini API, Sheets, Drive).
- Intervals.icu Account (for fitness data).
- Zwift (PC/Mac recommended for auto-sync).
- Intervals.icu: Settings -> Developer -> API Key.
- Gemini API: Google AI Studio.
- Create a Google Sheet and open
Extensions>Apps Script. - Copy
Code.gsfrom this repository. - Configure the
USER_SETTINGSat the top:const USER_SETTINGS = { LANGUAGE: "en", GOAL_DESCRIPTION: "Increase FTP by 10W", TARGET_DATE: "2026-06-01", WORKOUT_FOLDER: "Aixle_Workouts", // Folder created in Google Drive // ... };
Set Apps Script triggers to run fetchAndLogActivities at 2:00 AM and generateOptimalZwiftWorkoutsAutoByGemini at 6:00 AM.
Use the included WatchZwiftZwo.ps1 script. It will automatically create an "Aixle" category inside Zwift and sync your workouts there.
- Install Google Drive for Desktop.
- Open
WatchZwiftZwo.ps1with a text editor and update the top configuration:$sourceFolder = "G:\My Drive\Aixle_Workouts" # Your Google Drive path $zwiftId = "123456" # Your Zwift ID
- Right-click the file and select "Run with PowerShell".
- You will see a new folder named "Aixle" in your Zwift workout selection screen.
Aixle is an experimental tool. Use the generated workouts at your own risk.
MIT License