tempest-weather

Get current weather conditions from a WeatherFlow Tempest station using the Tempest REST API. Use when the user asks for "tempest weather" (preferred trigger), or asks for backyard/home weather, Tempest station readings, wind/gust/rain/lightning from a specific station, or quick local weather summaries sourced from Tempest data.

# Tempest Weather

Use this skill to fetch current conditions from a Tempest station/device or retrieve historical station statistics (day/month/year) from the Tempest Stats API.

## Run the fetch script

Use:

```bash
python3 scripts/get_tempest_weather.py
```

The script reads configuration from environment variables by default, if both station and device id are set device_id is used by default:

- `TEMPEST_API_TOKEN` (required)
- `TEMPEST_STATION_ID` (optional if `TEMPEST_DEVICE_ID` is set)
- `TEMPEST_DEVICE_ID` (optional if `TEMPEST_STATION_ID` is set)
- `TEMPEST_UNITS` (optional: `metric` or `us`, default `us`)

## Useful command options

```bash
# Explicit station/token (current observations)
python3 scripts/get_tempest_weather.py --station-id 12345 --token "$TEMPEST_API_TOKEN"

# Explicit device/token (current observations)
python3 scripts/get_tempest_weather.py --device-id 67890 --token "$TEMPEST_API_TOKEN"

# Historical stats for current local day/month/year (defaults to "now")
python3 scripts/get_tempest_weather.py --stats day
python3 scripts/get_tempest_weather.py --stats month
python3 scripts/get_tempest_weather.py --stats year

# Historical stats for a specific target date period
python3 scripts/get_tempest_weather.py --stats day --date 2026-02-23
python3 scripts/get_tempest_weather.py --stats month --date 2026-02
python3 scripts/get_tempest_weather.py --stats year --date 2025

# Metric output
python3 scripts/get_tempest_weather.py --units metric

# JSON only (machine-friendly)
python3 scripts/get_tempest_weather.py --json
```

## Output behavior

- Emit concise JSON (always)
- Include a short human summary unless `--json` is used
- Include timestamp and source URL for traceability
- For `--stats`, return the matched historical row from `stats_day`, `stats_month`, or `stats_year`

## If data fetch fails

- Check token validity and station/device ID
- Retry once for transient network errors
- Return a short actionable error message

## Field mapping reference

For Tempest observation index mapping and response notes, read:

- `references/tempest-api.md`

## License

- `LICENSE` (MIT)

## Source

- https://github.com/wranglerdriver/tempest-weather