garmin-health-report

# Garmin Health Report

Generate professional daily health reports from Garmin Connect data with advanced running analysis.

**Features:**
- **Sleep Analysis**: Duration, stages (deep/light/REM), scores, and 7-dimension quality ratings
- **Heart Rate Monitoring**: Resting HR with recovery status
- **Activity Tracking**: Steps, distance, floors, goal completion
- **Professional Running Metrics**:
  - Heart Rate Zones (Zone 1-5 distribution)
  - TRIMP (Training Impulse) load calculation
  - Jack Daniels VDOT estimation with training paces
  - Personalized recovery and training advice
- **7-Day Trend Analysis**: Activity patterns and consistency tracking
- **Personalized Recommendations**: Sleep tips, step goals, training insights

**Regional Support**: Works with both Garmin.com (international) and Garmin.cn (China region) accounts.

## Quick Start

### 1. Install Dependencies

This skill requires Python 3.8 or higher and `garth` library:

```bash
# Install garth (Garmin Connect authentication library)
pip3 install garth

# Verify installation
python3 -c "import garth; print('garth installed successfully')"
```

### 2. Authenticate with Garmin Connect

First time setup requires authentication with Garmin Connect:

```bash
# Navigate to skill directory
cd ~/.agents/skills/garmin-health-report

# Run authentication script
python3 authenticate.py
```

Follow prompts to enter your Garmin Connect username and password. Tokens will be securely stored in `~/.garmin-health-report/tokens.json`.

**For China Region Users (garmin.cn):**

Create a config file before authenticating:

```bash
mkdir -p ~/.garmin-health-report
cat > ~/.garmin-health-report/config.json << 'EOF'
{
  "is_cn": true,
  "log_level": "INFO"
}
EOF
```

Then run `python3 authenticate.py`.

### 3. Generate Health Report

Generate a report for today or any specific date:

```bash
# Today's report
python3 health_daily_report.py

# Specific date
python3 health_daily_report.py 2025-01-15

# Save to file
python3 he...

# Garmin Health Report

A standalone implementation of Garmin Connect health reporting using `garth` library.

## What's This?

This is a refactored version of `garmin-health-report` that simplifies dependencies by using the official Garmin Connect authentication library (`garth`) directly instead of the more complex `garmer` package.

## Why?

The original version required `garmer` which has installation issues. This version:

- ✅ **Uses only one dependency**: `garth` (official Garmin Connect library)
- ✅ **Simpler installation**: `pip3 install garth`
- ✅ **Same features**: All original functionality preserved
- ✅ **Better error handling**: Direct use of garth's stable authentication
- ✅ **Easier to debug**: Fewer layers of abstraction

## Installation

### 1. Install Dependencies

```bash
# Install garth (Garmin Connect authentication library)
pip3 install garth

# Verify Python version (requires 3.8+)
python3 --version
```

### 2. Authentication

First time setup requires authentication with Garmin Connect:

```bash
# Navigate to skill directory
cd ~/.agents/skills/garmin-health-report

# Run authentication script
python3 authenticate.py
```

Follow the prompts to enter your Garmin Connect username and password. Tokens will be securely stored in `~/.garmin-health-report/tokens.json`.

**For China Region Users (garmin.cn):**

Create a config file before authenticating:

```bash
mkdir -p ~/.garmin-health-report
cat > ~/.garmin-health-report/config.json << 'EOF'
{
  "is_cn": true,
  "log_level": "INFO"
}
EOF
```

Then run `python3 authenticate.py`.

### 3. Generate Health Report

```bash
# Today's report
python3 health_daily_report.py

# Specific date
python3 health_daily_report.py 2026-03-01

# Save to file
python3 health_daily_report.py > ~/health_report_$(date +%Y-%m-%d).txt
```

## Files

- `authenticate.py` - Garmin Connect OAuth2 authentication (using garth)
- `garmin_client.py` - Garmin Connect API client (using garth)
- `health_daily_report.py` - Main r...