GarminAgent | Fitness & Wellness Analytics

Overview

GarminAgent analyzes personal fitness and wellness data exported from Garmin Connect via GDPR data request. It transforms raw activity logs, daily wellness metrics, and heart rate data into actionable insights through 32 deterministic tools.

Data Pipeline

Source: Garmin Connect GDPR export (ZIP)
Storage: SQLite database (garmin.db)
Period: Oct 2023 - Jan 2026
Integration: Exports CSV for TennisAgent cross-domain sync

Variations

8

Basic Activity Analysis

Counts, types, stats, HR zones

8

Trend Analysis

Week/month comparisons, progress, streaks

8

Wellness & Recovery

Sleep, stress, resting HR, recovery

8

Training Load

Session HR, zones, volume, intensity

32 tools · 80 tasks · 4 variations

Data Model

Table	Records	Description
activities	358	Individual activity records with HR, duration, calories, speed
daily_summary	334	Daily steps, sleep, stress, resting HR, intensity minutes
user_profile	1	User biometrics (weight, height, max HR, VO2 max)

Activity Breakdown

Indoor Cardio

85%

Primary activity type

Other

13%

Mixed activities

Cycling

1%

Outdoor rides

Total Time

227h

Cumulative workout hours

Key Fields

Heart Rate

Average, max, min HR per activity. Six HR zones (zone 0-5) tracked in milliseconds.

avg_hr, max_hr, min_hr, hr_zone_0..5

Activity Metrics

Duration, distance, calories, speed, cadence, steps, and lap count per session.

duration_seconds, calories, avg_speed

Daily Wellness

Steps, stress levels, resting heart rate, sleep quality, intensity minutes.

steps, avg_stress, resting_hr, sleep_seconds

Sleep Analysis

Deep, light, and REM sleep durations plus awake time from daily summaries.

deep_sleep, light_sleep, rem_sleep

TennisAgent Integration

GarminAgent exports activity data as CSV for cross-domain analysis with TennisAgent. This enables correlating tennis match performance with fitness metrics like resting HR, sleep quality, and training load.

# Export for TennisAgent python main.py "export" # Creates: garmin_for_tennis.csv

CLI Quick Start

# Run CLI cd domains/GarminAgent/cli python main.py # Single queries python main.py "how many activities" python main.py "weekly stats" python main.py "hr zones" python main.py "daily summary" python main.py "profile"

Architecture

# GarminAgent Domain Structure domains/GarminAgent/ service.py # BaseDomain (SQLite loader) cli/ main.py # CLI entry point config.py # Configuration data_client.py # Database queries nli_parser.py # Intent parsing agent_service.py # Query handlers data/ garmin.db # SQLite database import_export.py # Import from ZIP variations/ variation_1/ # 8 tools, 20 tasks variation_2/ # 8 tools, 20 tasks variation_3/ # 8 tools, 20 tasks variation_4/ # 8 tools, 20 tasks

Technology

Python SQLite Pandas CLI NLI Parser GDPR Export Garmin Connect