Build a program around your sports.
HOW IT WORKS
Your assistant sets you up
Talk it through with your AI assistant: your basics, a quick health check, what you do now and what you're aiming for. It asks one question at a time and helps with anything you're unsure of.
You train and report
Your fitness tracker records every session. A quick morning check-in and a few words after a workout say how your body actually feels.
The hub keeps the record
What you did in each sport, how efficient it was (pace or power against heart rate, with the day's temperature), and where the work landed on your body. Your reports are the evidence that matters most.
Your assistant plans with it
It lays out your season, then plans the coming week's workouts from how the last one went. You see every change first, and your call always wins.
GET STARTED WITH YOUR AI
1. Connect your assistant (the steps are just below). Checking for your assistant…
2. Copy this into your assistant to begin, or just talk to it in your own words:
I just installed S-Bike Training Hub. Please call get_setup_status and walk me through setting up: my basics, a quick health check, my current routine and my goals, then my first program. Ask one question at a time and help me with anything I'm not sure about.
Setup works through the assistant's connection to the hub (MCP): that's how it reads what the hub needs and saves your answers safely. An assistant that isn't connected can chat, but it can't set anything up. No assistant? Set up by hand below.
BUILT TO WORK WITH AN AI ASSISTANT
The hub keeps the numbers; your AI does the coaching conversation. It works with a frontier model (like Claude) or a local model running free on your own computer, through any app that supports MCP servers. The hub stores your records on your computer. A cloud AI receives the information you choose to share with it; use a local model for an entirely local coaching conversation.
🧭 Consult me
"Look at my training load and plan me a lifting session that fits my triathlon plan for the next three weeks. Let's discuss it."Your AI leads with your numbers and the hub's suggestions, and you shape the plan together.
📋 I have a plan
"I have a workout: goblet squats 3 × 8 at 35, dead hangs 3 × 30 seconds…"Your AI records it as you said it and scores it, so the load counts. Your plan stands.
Connect it (Claude Code):
claude mcp add --scope user s-bike-hub -- "…/.venv/bin/python" "…/mcp_server.py"
Claude Desktop and other MCP apps: install io.github.JHarp199345/s-bike-hub from the MCP Registry, or the one-file bundle from the GitHub releases. More in Training with your AI.
YOUR BIKE
Riding without a smart bike? Skip this - everything else works without one.
Turn the bike on and pedal a few turns to wake it. Disconnect it from any phone or watch app first: most bikes allow only one connection.
The hub can't talk to yet
Your AI assistant can work out how. May the hub ask it to set this bike up?
Your assistant will see the bike's Bluetooth name, the services it offers and a few seconds of its data packets - no training history. It writes a bike profile (settings, never code); the hub checks it and runs a short guided test that only nudges resistance in small steps while you pedal. Nothing changes until you confirm it worked.
Keep pedaling - the hub is listening to the bike for a few seconds…
Now open your AI assistant and type:
get my bike working
Your assistant picks up the request from here. Keep this page open: it shows each step, and tells you when to pedal.
No assistant connected yet? Connect it first (see Built to work with an AI assistant above), then type the line.
WHAT YOU NEED
| ⌚ A fitness tracker | Any watch that exports activity files (.fit or .tcx): COROS, Garmin and most others. Your training load is built from what it records. |
| 🤖 An AI assistant | Frontier or local. A local model costs nothing to run. |
| 🚴 A smart bike | Optional. Without one, the hub is your multisport coach; with one (tested on a Merach S29), it runs your rides too: hills, gears, ERG workouts and 3D routes. |
What your tracker needs, for every metric
Missing a feature never breaks anything. It just means fewer metrics.
| Tracker feature | What it unlocks | Without it |
|---|---|---|
| Activity file export | Everything below: how your sessions get in | Only check-ins, lifting and the bike's own rides |
| Heart rate | Heart-and-lungs load for runs, swims and gym; heart rate at the same watts; recovery after efforts | Rides still count from power; other sports lose most of their cardio load |
| GPS, distance, speed | Run pace and splits; how hard each step lands | Indoor runs count by time only |
| Running cadence | Foot impact step by step: the running blocks | Steps estimated from your earlier runs |
| Barometric altitude | Downhill running counted as extra impact | Hills treated as flat |
| Running dynamics | Run form drift (ground contact, bounce, step length) | No form flags |
| Running power | Power in the run splits | Pace and heart rate only |
| Pool swim mode | Swim load, SWOLF, stroke breakdown, how long your stroke holds | Swim load estimated, low confidence |
| Pairs as a bike power sensor | Rides with power and heart rate together: aerobic efficiency and drift | Rides count from the bike alone |
| Overnight HRV, resting HR, sleep | Morning readiness (read by your AI through the watch's connector) | The morning check-in covers it |
| Daily steps | Walking load toward the running budget | Walking not counted |
SET UP BY HAND
No assistant? Set up by hand
WELCOME
Free and open source · GitHub · Wiki · The numbers are estimates, tuned by your reports - not medical advice.