Accueil

Quoi de neuf

COROS comme source complète, OpenRouter en un clic, choix des chaussures (/shoes), plusieurs athlètes sur une machine, tableau de bord installable : voir les Nouveautés.

Cinq spécialistes, un seul objectif : le vôtre¶

ai-running-coach transforme votre IDE en staff d'entraînement complet. Cinq agents IA open source, en français par défaut, coordonnés par un coach — chacun avec ses skills, ses données et ses protocoles. Vous décrivez votre objectif, ils construisent le plan.

Coach¶

Le chef d'orchestre. Il construit le plan, semaine après semaine ou en bloc de plusieurs semaines, analyse chaque séance Garmin, fixe vos cibles d'allure et de FC à partir de vos propres zones et pousse les séances dans votre calendrier Garmin Connect.

« Je veux préparer un trail de 50 km avec 2500 m de D+ dans 6 mois. »

Stratège de course¶

Il lit le GPX de la course, découpe le parcours en segments et prédit chacun avec votre propre modèle pente → allure. Trois scénarios, ravitos, météo, équipement — puis le parcours envoyé sur la montre.

« Analyse ce parcours et donne-moi un plan d'allures. »

Médecin du sport¶

Il lit HRV, FC de repos, readiness et dette de sommeil avant chaque séance, lève un signal de vigilance blessure quand plusieurs indicateurs dérivent ensemble, et suit vos douleurs jusqu'à la consultation.

« Suis-je prêt pour la séance de demain ? »

Nutritionniste¶

Il gère macros, poids de course et plans de ravitaillement, mesure vos glucides par heure et votre sudation sur les sorties longues, en croisant vos apports avec les calories brûlées Garmin.

« Que dois-je manger pendant la course ? »

Directeur sportif¶

Il choisit avec vous quelle course faire, et quand. Il part de ce que vous avez réellement couru, propose une progression réaliste, cherche les courses sur le web et vérifie chaque date sur le site de l'organisateur. Quand une distance est hors de portée, il le dit, et vous trouve le format qui vous convient.

« Je cherche un trail entre amis en juin. »

Du premier réglage à la ligne d'arrivée¶

Le staff vous suit sur tout le parcours d'une préparation — et chaque étape laisse une trace lisible dans votre workspace.

Départ
Installer et se présenter¶

Un script, trois préréglages (laptop, coach-server, docker). Puis /coach-setup vous interroge et pré-remplit FC max, FC de repos, seuil et VO2max depuis Garmin — avec leur source, à confirmer.
Préparation
Un plan qui sait dire non¶

Des plans sur plusieurs semaines, poussés au calendrier Garmin. Avant chaque push, sept garde-fous calculés vérifient charge, volume, D+ et enchaînements : un second avis déterministe, pas une intuition de LLM. Vos chaussures aussi sont suivies : kilométrage par paire depuis Garmin, prévision de retraite, inspection photo proposée environ tous les 200 km, bilan de carrière à la retraite d'une paire.
Chaque matin
Le verdict, et sa raison¶

HRV, FC de repos et readiness avant toute séance, la météo et le meilleur créneau. Si le coach allège, la décision est tracée : /why vous dit pourquoi, jamais une raison inventée.
Jour J
Prêt, et le plan en poche¶

Le score Trail Shape mesure si vos huit dernières semaines couvrent ce que la course exige. Le plan de course donne une allure par segment, tirée de votre propre modèle pente → allure.
Arrivée
Le débrief, segment par segment¶

Prévu contre réalisé : écart d'allure et dérive cumulée, fade, glucides par heure, météo. Vos indices ITRA et UTMB rejoignent l'historique — et la préparation suivante part de là.

Trente skills, prêts à l'emploi¶

Des protocoles précis que l'IA suit à la lettre. Sept d'entre eux sont des commandes courtes, pensées pour le téléphone : cinq pour une question, une réponse, /inspection pour une inspection guidée et /shoes pour choisir sa prochaine paire.

/todaySéance du jour, bilan du matin, créneau météo. /whyLa raison de la dernière décision du coach, citée depuis le journal. /weekLa semaine en cours : réalisé face au prévu, garde-fous. /raceCompte à rebours, score Trail Shape, plan de course. /log« 2 gels + 500 ml au km 15, genou gauche 3/10, RPE 7 » — noté. /inspectionInspecter une paire : photos, usure, état. /shoesChoisir la prochaine paire : continuité, plages sourcées.

Le tableau de bord sur téléphone : score Trail Shape à 54 jours d'un trail de 42 km

Terrain et séances¶

Analyse GPXprofil, D+, compatibilité avec une séance cible
Comparaison de parcoursprogression sur un même lieu
Analyse de séancesstrides, montées, intervalles au segment près
Téléchargement FITdonnées brutes, précision sub-kilomètre
Météoprévisions et créneau optimal
Inspection des chaussuresusure lue sur photos, comparée à la précédente (/inspection)
Fiche des chaussuresdrop, pile, poids d'une paire, chaque valeur avec sa source, validée par vous
Choix des chaussuresla prochaine paire : continuité d'abord, caractéristiques sourcées (/shoes)

Garmin et synchronisation¶

Planification Garminséances poussées au calendrier
Planification COROSséances poussées sur une montre COROS, en interactif
Synchronisation Garminrécupérer sans saturer le contexte
Sync quotidienneheadless, résumé poussé sur le téléphone
Intervals.icusource primaire avec --source intervals, secondaire sinon

Installation et données¶

Premier démarragestaff, discipline, style, profil
Diagnostic d'installationtokens, MCP, config, daily-sync
Mettre à journouvelle version signalée, mise à jour en une commande
Contrat de donnéesle schéma lu par l'index et le tableau de bord
Backfill du contratmettre à niveau vos anciens fichiers

Tout ce que le coach sait, sous vos yeux¶

Un tableau de bord local, en lecture seule, alimenté par les fichiers de votre workspace — même quand le coach travaille seul sur votre machine coach. Captures du design roadbook sur le workspace de démonstration d'une athlète fictive, à 54 jours de sa course.

Découvrir toutes les vues

Prêt à courir plus malin ?¶

Installez ai-running-coach et laissez votre staff d'entraînement prendre le relais.

git clone https://github.com/mmornati/ai-running-coach.git && cd ai-running-coach && ./install.sh

Commencer en 5 minutes

Projet open source (MIT), en français par défaut (langue des documents configurable via config/workspace.toml), compatible Claude Code, GitHub Copilot, OpenCode, Gemini CLI, Cursor et Windsurf. Ce projet fournit des outils d'aide à la préparation sportive : il ne remplace pas un avis médical professionnel.

Votre staff d'entraînement,dans votre IDE.