Free Garmin running dashboard by coach Inna Ryzhykh
A year of your Garmin running on one page
Why isn’t your result improving? Why are you always tired? Why another injury? The dashboard does not diagnose. In twenty minutes it pulls from your watch what a coach looks at first: how much of your running is really easy, what your load periodization looks like (if you have one at all), and whether your fitness is growing.
No sign-up · your data stays on your computer

What is inside
What the dashboard shows
Garmin shows a hundred numbers and not a single conclusion. This dashboard reads a year of your runs by the same rules I use to read my athletes' training logs.
The verdict
One line at the top: what stands out in your training first. For example, “Not much easy running” or “5 weeks in a row without a recovery week”. The numbers behind it sit next to it.
The easy line
Every run of the year as a dot against the easy heart rate ceiling from your own watch. Drag the line and see how much the verdict depends on one setting in Garmin.
Load periodization
Each week a column, each run a block. Weekly load counts every workout your watch recorded: cycling, swimming, strength and recorded walks are included too, so a hard week on the bike will not pass for an easy one. You see how hard and easy weeks alternate, whether a working block ends with a recovery week, and how long the load ran without one. Click a week to open it day by day.
Technique
Cadence, stride length, ground contact and bounce by month: where you started the period and where you are now, at the same pace. If your step changed, the dashboard checks whether the weather is the reason.
What goes with what
The dashboard compares your runs with each other: heat, sleep, the load before, resting heart rate, HRV. It shows only links that pass a statistical check, each with a hypothesis you can test on yourself.
Fitness and recovery
Metres per heartbeat on easy runs: whether your aerobic fitness is growing, judged by the trend over months, with no separate test. And resting heart rate by week against the hard weeks, to see whether you recover enough.




What you need
- A Garmin watchAny model that records heart rate and syncs with Garmin Connect. The longer the history, the more honest the picture, but three months is already enough. Older watches without zones or Training Load work too: the dashboard fills those in itself.
- A computerMac or Windows. The Garmin key and all your data stay on it; nothing goes to the cloud.
- ClaudeThe Claude desktop app with its Code tab, or Claude Code in the terminal. A Pro or Max subscription is required. Step three shows how to set it up.
- Twenty minutesAbout five of them are yours: create the key and check your zones. Claude Code does the rest on its own.
The guide
Four steps
-
Create your Garmin Personal API Key
Since October 2026 Garmin gives every user a personal key to their own data. This is the official way in: no password is shared, no third-party libraries are needed, and the key can only read.
- Open connect.garmin.com → Settings → Personal API Key and log in if asked.
- Click Create Key, read and accept the terms.
- Choose 1 year as the expiration, otherwise you will repeat all this in a month.
- Copy the key right away. Garmin shows it once. If you lose it, delete the old key on the same page and create a new one.

This is how the page looks once the key exists: Garmin shows when it expires and never shows the key itself again. -
Check your heart rate zones in Garmin
The dashboard takes the easy ceiling from your watch, so everything depends on your zone settings. On newer watches zones are set only in the Garmin Connect app on your phone. The path is:
Your watch → Settings → User Profile → Heart Rate and Power Zones → Heart Rate
- At the top there are three numbers: max heart rate, lactate threshold heart rate and resting heart rate. Tap any of them to correct it.
- Open Zones, then Based On. The best option is % of lactate threshold heart rate, if your threshold comes from a test or the watch detected it on a run with a chest strap.
- If your maximum is set by the 220 minus age formula and you have never measured it, your zones are almost certainly off. The dashboard will notice and warn you.
- Separate running zones live under Sport-specific heart rate. If they are set, the watch uses them instead of the general ones.
- Do not change settings at random. You can move the ceiling right on the dashboard and see what changes.
Menu names can differ slightly depending on the app language and version.
-
Install Claude Code
This is an assistant that works right on your computer: it creates folders, downloads files and runs scripts. The regular Claude chat in a browser or on a phone cannot do that, so the dashboard cannot be built from a phone. A Claude Pro or Max subscription is required.
The easiest way is the app. Download Claude for Mac or Windows, sign in and open the Code tab at the top of the window. It is the same Claude Code with a normal window instead of a black screen: pick any folder, paste the prompt into the message box and press Enter. It asks permission before each action; answer yes.
If you prefer the terminal. Open Terminal on Mac or PowerShell on Windows, run the command on the right, then type claude, sign in and paste the prompt. Anthropic has a detailed walkthrough with pictures: code.claude.com/docs.
-
Paste the prompt
Copy the whole text from the block below and paste it into Claude Code. It downloads three files from this site, installs what is needed, asks you to paste the key into a file, pulls your data and opens the dashboard in your browser. The only thing you do by hand is paste the key into the file it opens and save. A week or a month later, tell Claude Code “update the dashboard” and it pulls in the new runs.
The prompt
Paste it into Claude Code as a whole. You do not have to read it, but you can: it contains nothing but the steps and the safety rules.
If something goes wrong, do not edit the prompt. Just tell Claude Code what happened in your own words. It will sort it out or ask you.
Build me the InnaTri running dashboard from my Garmin Connect data. Walk me through it step by step in plain language and do everything technical yourself: folders, files, installs. Stop and wait for me only where I have to act. Rules - Never print my Garmin key in the chat, never put it in a command, never write it anywhere except the file garmin.env. When you check it, say only “the key is in place” or “no key”. - The key and the data stay on my computer. Add the data folder and garmin.env to .gitignore. - The Garmin key is read-only; it cannot change anything in my account. Step 1. Folder and files Create a folder called innatri-dashboard in my home folder and work inside it. Download these three files into it: - https://innatri.com/guides/dashboard/fetch_garmin.py - https://innatri.com/guides/dashboard/build_dashboard.py - https://innatri.com/guides/dashboard/template.html Check that I have Python 3.10 or newer; if not, help me install it. Create a virtual environment and install the package garmin-connect-personal-api-python into it. Step 2. The key (I do this part, you guide me) Create the folder ~/.config/innatri and inside it the file garmin.env with one line: GARMIN_API_KEY= Set the file permissions to 600. Open it in my text editor and tell me the full path. I will paste the key right after the = sign with no spaces or quotes and save. If I do not have a key yet, tell me: it is created at https://connect.garmin.com/app/settings/personalApiToken with the Create Key button, 1 year is the best expiration, and it is shown only once. Then check that the value is filled in, without printing it. Step 3. Data Run fetch_garmin.py --months 12. If Garmin returns 401, the key was copied incompletely or has expired: ask me to check the file. If it returns 500, the script shrinks the batches on its own, just let it finish. At the end tell me how many activities and days came back. Step 4. Dashboard Run build_dashboard.py --lang en. If it warns that the zones in my watch are based on maximum heart rate, translate that warning into English for me without changing its meaning (the scripts print in Russian; that is expected). Open dashboard.html in my browser. Step 5. Done Tell me the dashboard is ready and give me the full path to dashboard.html. Do not open dashboard.html or the data folder yourself and do not retell my numbers: I read the dashboard in my browser, and my data stays on my computer. Do not advise anything about my training; the coach does the reading. When I say “update the dashboard”, repeat steps 3 and 4.
The guide and the dashboard are free. If they helped, you can chip in.
The address innaryzhykh@gmail.com is copied and PayPal opens in a new tab: paste it as the recipient.
No varnish
What this dashboard does not know
Every threshold in it is a coach's threshold, and every one is named. But there are things Garmin data cannot tell. Better to say so up front than to answer it in the comments.
- How your heart rate was measured
Garmin does not say whether it was a chest strap or the optical sensor on the wrist. Optical sensors are off by 5–10 beats on intervals and in the cold. Monthly averages are more reliable than single runs, and a chest strap settles the argument.
- Where your maximum came from
If it is set by a formula, all the zones are shifted with it. The dashboard prints where the ceiling came from and warns you, but it cannot measure your maximum for you.
- Heat, illness, lack of sleep
A long run in the heat drifts upwards in heart rate towards the end, and the average does not forgive it. Resting heart rate after a glass of wine is three beats higher. These are limits of the method, not your mistakes.
- How Garmin computes load
Training Load is a closed Firstbeat model. Here it is used only to compare weeks with each other: to find the hard ones and the recovery ones.
- VO2max, training status, predictions
The Garmin Personal API Key does not provide them. The dashboard is deliberately built on what was measured, not estimated, and draws nothing extra.
- Your life around running
The dashboard sees your runs and what the watch records day and night, but not your work, your goals or how you feel. The links it finds are coincidences, not causes. So its verdict is a reason to talk to a coach, not a diagnosis.
This is a tool for reading training data, not medical advice. Its thresholds are adjustable, its conclusions depend on the zone settings in your watch, and it is best read as a 6–8 week trend rather than week by week. The scripts are open, run only on your computer and send data nowhere. The Garmin key can be revoked at any time on the page where it was created.
Questions
I am not a programmer. Will I manage?
Yes. You do two things by hand: create the key in Garmin and paste it into a file that Claude Code opens for you. It does and explains everything else as it goes. If you get stuck, tell it what you see on the screen in your own words.
Is it safe? Where does my data go?
Nowhere. The scripts download your data from Garmin's servers to your computer and build one HTML file from it. The key sits in a file only you can read; it never enters the chat. Claude Code works over the internet, but it only sees what the scripts print: activity counts, the easy ceiling and warnings. The prompt tells it not to open the dashboard or your runs.
Garmin returned error 401
The key was copied incompletely, with a space, or has expired. Open garmin.env and check the line. If the key was a 30-day one, create a new one on the same Garmin page.
The dashboard says my zones are based on maximum heart rate
That means Garmin computes your zones as a percentage of maximum heart rate. It is not an error, but if the maximum was never measured and comes from a formula, the easy ceiling may be off by 5–10 beats. Drag the line on the dashboard five beats either way and see whether the verdict holds. If it does not, measure your threshold or maximum.
I run a lot on the treadmill
Treadmill heart rate is real, so treadmill runs count in every heart rate metric. Pace without a footpod is unreliable, so they are excluded from “metres per heartbeat”. Treadmill runs are labelled in the tables.
I run without heart rate or with gaps
Runs without heart rate count in kilometres but not in zones, and the dashboard tells you how many there are. If fewer than 60% of runs have heart rate, there is no verdict, only an honest “heart rate not recorded everywhere”. Days without the watch are not counted as zeros.
Can I change the rules for myself?
Yes. The easy ceiling moves right on the page. The recovery week threshold is set with the --deload flag at build time, and the ceiling can be fixed with --easy-ceiling. Every threshold is listed at the bottom of the dashboard under “How it was calculated”.
Why not Strava and why not an app?
Strava does not hand out zones and resting heart rate so simply through an open key, and an app would mean your data lives with me. Here it lives with you.
What to do with these numbers
The dashboard shows facts. What to do next is a coach’s call. If you want the picture to look different six months from now, I coach runners and triathletes online.