localgenai/opencode/README.md

# Garmin Data Fetcher

A Python script to download per-second activity data (heart rate, GPS, cadence, etc.) from Garmin Connect and extract it from FIT files for analysis.

## Setup

1. Create virtual environment:
```bash
python -m venv venv
source venv/bin/activate
```

2. Install dependencies:
```bash
pip install garminconnect garmin_fit_sdk
```

3. Set environment variables:
```bash
export GARMIN_EMAIL=your_email@example.com
export GARMIN_PASSWORD=your_password
```

## Usage

Run the script to download and extract data:
```bash
python scripts/fetch_garmin_data.py
```

The script will:
- Authenticate with Garmin Connect
- Download the most recent activity's FIT file
- Extract per-second record data (heart rate, GPS, cadence, etc.)
- Save the data as JSON for analysis

## Output

Data is saved in `garmin_data/` as:
- `{activity_id}.fit` - Original FIT file
- `{activity_id}_data.json` - Extracted per-second records