Aktualizováno 2026-04-14 · zpět na dashboard

Běžecký trenér — vysvětlení pro lidi

Tenhle dokument je srozumitelný popis celého projektu. Bez programátorských zkratek, bez JSON ukázek, bez příkazové řádky. Když chceš vědět technické detaily, otevři si dokumentace.md.

1. Co to vlastně je

Představ si osobního trenéra, který:

Ten trenér je AI (konkrétně Claude od Anthropicu). Projekt „Běžecký trenér" je infrastruktura, která AI krmí tvými daty — sbírá je, třídí, ukládá a dává AI k dispozici, když si s ní povídáš.

2. Proč to existuje

Garmin Connect je skvělý na jednotlivé běhy, ale:

Běžecký trenér s AI tohle umí. Protože má všechno na jednom místě a pamatuje si.

3. Jak to funguje (zjednodušený obrázek)

   Hodinky na ruce                   Chytrá váha
   (Garmin Forerunner 970)           (s Garminem spárovaná)
          │                                   │
          └──────────────┬────────────────────┘
                         ▼
                ┌─────────────────┐
                │  Garmin Connect │  ← webová platforma Garminu
                └────────┬────────┘
                         │
        ┌────────────────┴────────────────┐
        ▼                                 ▼
   Domácí server                    Home Assistant
   (malý počítač NUC)              (chytrá domácnost —
   stahuje data                     má integraci s Garminem)
   pravidelně z Garminu                    │
        │                                  │
        └───────────────┬──────────────────┘
                        ▼
                 ┌──────────────┐
                 │ Soubory      │  ← ukládá vše do uspořádaných
                 │ (na disku +  │    souborů, zálohuje na GitHub
                 │  GitHub)     │
                 └──────┬───────┘
                        ▼
                 ┌──────────────┐
                 │  AI (Claude) │  ← když si s ní povídáš,
                 │              │     sáhne do souborů
                 │              │     a poradí ti
                 └──────────────┘

Klíčové je, že data jsou mimo Garmin — uložená u tebe, v textových souborech, které AI umí číst. Takže AI má plný přístup ke všemu, co o tobě Garmin ví.

4. Co všechno to sbírá

Z hodinek a Garmin Connectu

Ze zdravotních funkcí Garminu (přes Home Assistant)

Home Assistant je „most" — Garmin mu dá data a on je předá dál. Sbírá se 44 různých zdravotních metrik, mimo jiné:

Z tréninkového plánu (Google Sheets)

Máš v Google Sheets plán — „v pondělí 10 km, ve středu intervaly, v neděli 20 km". Projekt ho taky stahuje a páruje odběhnuté kilometry s plánem — takže vidíš nejen „co jsi měl dělat", ale i „co jsi opravdu udělal" a kolik jsi splnil.

5. Jak to data třídí a ukládá

Aby AI v tom nebyla ztracená, všechno je uspořádané do hierarchie od obecného k detailnímu:

Aktivity (běhy)

  1. Souhrn posledních 100 běhů — jeden soubor, rychlý přehled (datum, km, tempo, HR)
  2. Celá historie všech běhů — jeden velký soubor od začátku (např. od 1. 1. 2024)
  3. Detaily posledních 30 aktivit — každý běh zvlášť (splits po kilometrech, HR zóny, počasí)
  4. Mikrodetail (data po 1 vteřině) — pro každý běh zvlášť — z Garmin FIT souboru se vyparsují tepy, tempo, kadence, výška atd. po sekundě. Typicky 2 000–6 000 bodů na jeden běh.

Když se AI zeptáš „jaké jsem měl průměrné tempo minulý měsíc", sáhne po úrovni 1. Když se zeptáš „jak mi na tom kopci ve čtvrtek stoupala tepovka", sáhne po úrovni 4. Takhle je to rychlé a AI se nezahltí.

Zdravotní data

Tělesné údaje

Tréninkový deník

Tohle je srdce celého projektu. Týdenní záznamy obsahují:

Dlouhodobá kronika

Mimo týdenní deník vede AI ještě chronologickou kroniku (kronika.json) s klíčovými životními událostmi:

Proč je to zvlášť od deníku? Protože deník se archivuje — staré týdny se po roce slijí do měsíčních souhrnů a detail se ztratí. Kronika je trvalá. Takže za 5 let se AI bude moct podívat: „Jo, před 4 lety v říjnu sis zlomil prst, pak ses vrátil v únoru, PB na 10 km jsi dal půl roku poté." Kronika je paměť napříč lety.

6. Rutina — jak to běží samo

Automatické sbírání

Na malém počítači (NUC s Proxmoxem, konkrétně virtuální kontejner LXC 113) běží cron — plánovač úloh. Pravidelně spouští skripty, které:

Automatické triggery

Home Assistant sám ráno řekne serveru „hej, vstal, stáhni zdravotní data". Po zaznamenaném běhu může spustit „po-behu" sync, který stáhne nové aktivity.

Ruční ovládání

Máš i Ops Dashboard — webová stránka garmin.promaagency.cz, kde vidíš:

Dashboard je chráněný heslem.

7. Jak to funguje s AI (Claude)

Máš několik způsobů, jak si s AI o svém běhání povídat:

1. Claude Code CLI v počítači

Otevřeš terminál ve složce projektu, řekneš claude a můžeš se ptát. AI sáhne na soubory v projektu, přečte si je a odpoví. Může i sama data měnit — třeba zapsat poznámku do deníku, commitnout do Gitu, rozběhnout sync.

2. Claude v mobilu / prohlížeči

Stejně, jen přes web nebo mobilní aplikaci Claude. Data vidí z GitHubu (kam se automaticky pushují).

Co AI typicky dělá

Ranní check-in:

Ty: „Jak mi je?"
AI: (přečte poslední zdravotní snapshot + týdenní trendy) „HRV máš 58, o 4 níž než týdenní průměr. Spal jsi 6:20, dost krátce. Stres byl včera vyšší. Doporučuju lehký trénink nebo odpočinek."

Analýza tréninku:

Ty: „Jak mi šel ten včerejší dlouhý běh?"
AI: (přečte detail aktivity + trackpoints po sekundě) „20,3 km v průměrném tempu 5:12/km. V první polovině ses držel v zóně 2 (HR ~140), ve druhé HR drift na 152 — známka dobré vytrvalosti, ale únavy ke konci. Kadence stabilní 176. Poslední 2 km jsi tempo zpomalil o 20 s/km, nejspíš ti došla energie."

Nedělní review (jednou týdně):

Ty: „Pojďme na deník."
AI: (nejdřív zkontroluje, jestli nečeká archivace — viz níže. Pak projde celý týden.) „V úterý jsi běžel jen 6 km místo plánovaných 10, co se stalo?" (vedeš s ní dialog, AI všechno zapíše do týdenního deníku.)

Dlouhodobá otázka:

Ty: „Kdy jsem naposled měl problém s achilovkou?"
AI: (sáhne do kroniky) „Naposled 12. května 2025 — W19. Trvalo to 3 týdny, řešil jsi to masáží. Před tím v říjnu 2024 po půlmaratonu."

AI-řízená archivace deníku

Tohle je klíčový prvek. Deník drží jen 53 posledních týdnů. Starší se musí sloučit do měsíčních souhrnů — ale nechceš, aby se ztratilo to nejdůležitější (pocity, bolesti, plány). Proto:

  1. Žádný skript nic automaticky nemaže.
  2. Když je něco zralé k archivaci, Dashboard na to upozorní oranžovou kartou.
  3. V nedělním review AI zkontroluje, jestli něco čeká. Když ano, nabídne ti to.
  4. Když souhlasíš, AI:
    - Projde všechny týdenní soubory daného měsíce.
    - Napíše narativ — 2–5 odstavců „co se v dubnu dělo" (trendy, klíčové momenty, důležité body).
    - Extrahuje highlights (co šlo dobře, co zlepšit, klíčové momenty).
    - Detekuje milníky a přidá je do kroniky (kdyby tam už nebyly).
    - Napíše měsíční archiv a commitne do Gitu.
    - Teprve po tvém potvrzení smaže týdenní soubory.

Takže ztráta dat je v podstatě vyloučená — před mazáním je všechno důležité zachycené v měsíčním archivu + kronice + Gitu.

8. Bezpečnost dat

9. Kam co patří (mapa souborů)

Nemusíš tomu rozumět detailně, ale pro představu:

Běžecký trenér/
├── CLAUDE.md              ← pokyny pro AI (jak se chovat, kam sáhnout)
├── dokumentace.md         ← technická dokumentace (pro vývojáře)
├── dokumentace_human.md   ← tento soubor
├── data/                  ← všechno, co se stáhlo z Garminu a HA
│   ├── aktivity/          ← běhy
│   ├── zdravi/            ← zdraví
│   ├── telo/              ← váha, tuk
│   └── plan/              ← tréninkový plán
├── denik/                 ← tréninkový deník
│   ├── tydni/             ← posledních 53 týdnů
│   ├── mesicni/           ← starší měsíční archivy
│   └── kronika.json       ← dlouhodobá paměť (zranění, závody, PB)
├── profil/                ← kdo jsi — dotazník, cíle, omezení
├── skripty/               ← Python skripty, co to všechno stahují
│   └── (běžci to nepotřebují řešit, jede to samo)
└── dashboard/             ← web stránka pro kontrolu

10. Nejčastější otázky

„Co se stane, když vypadne internet / server?"
Nic hrozného. Cron se příští hodinu pokusí znovu. Všechno je idempotentní (můžeš to spustit víckrát, nerozbije se to). Data ze tří zařízení se přes Git srovnají.

„Co když zapomenu na nedělní deník?"
Nic. AI si to pamatuje — až si s ní příště sedneš, doptá se na minulý týden. Data už má stejně stažená.

„Můžu AI věřit, že mi dá dobrou radu?"
AI je chytrá, ale je to sekundární trenér. Má přístup ke všem tvým datům, takže často vidí víc než primární trenér, který tě potká jednou za týden. Ale na závažné věci (bolesti, zranění, rozhodnutí o závodech) se vždycky poraď s člověkem — lékařem, fyzioterapeutem, trenérem.

„Co když chci víc/míň dat?"
Všechno se dá změnit. Chceš sbírat víc metrik z HA? Přidá se entita do ENTITY_MAP. Chceš mazat starší historii? Upraví se retence. Chceš víc měsíců v deníku? Změní se cutoff.

„Můžu data exportovat?"
Jasně — jsou to obyčejné JSON soubory. Otevři libovolný text editor a máš to.

„Je to drahé?"
Samotný projekt běží na tvém malém počítači (NUC, spotřeba ~10 W). Claude AI si platíš podle použití (typicky pár stovek měsíčně pro aktivního uživatele). GitHub repo zdarma.

11. Co to NEumí

12. Shrnutí v jedné větě

Běžecký trenér je systém, který sbírá všechna tvá běžecká a zdravotní data na jedno místo, dává je k dispozici AI, a společně s AI v nedělním deníku vede paměť tvého tréninku a zdraví napříč týdny, měsíci a lety — aby ses mohl rozhodovat z kompletního kontextu a nic důležitého se neztratilo.