Health & Training Data

Personal health and training data pipeline built on Garmin data, stored in DuckDB.

Data Sources

Garmin Connect API

Daily health and wellness metrics:

• Heart rate, HRV, sleep, stress, steps
• Body battery, respiration, SpO2
• Weight and body composition
• Training readiness, training status, endurance score, max metrics
• Activity summaries

Garmin FIT Files

Per-second activity recordings from the device:

• GPS position, altitude, speed, distance
• Heart rate, power, cadence
• Temperature, respiration rate
• Lap splits, HR zone distributions
• Beat-to-beat HRV intervals

Setup

Requires devenv. From the project root:

devenv shell

This provides Python 3.13, uv, and all dependencies.

Usage

Authentication (required once):

python login.py

Collect data (first run with start date):

python collect.py --start 2026-01-01

Subsequent runs (fetches missing days automatically):

python collect.py

See DESIGN.md for schema, collection details, and design decisions.