weatherfeeder/README.md

weatherfeeder

weatherfeeder is a config-driven daemon that polls weather providers, normalizes provider-specific responses into canonical weather events, and routes those events to configured sinks.

It currently supports NWS observations, alerts, hourly forecasts, narrative forecasts, forecast discussions, and weather stories; Open-Meteo observations and hourly forecasts; and OpenWeather observations. Implemented sinks are stdout, NATS, and Postgres.

Quickstart

Run the checked-in sample config:

cd cmd/weatherfeeder
go run .

The sample config at cmd/weatherfeeder/config.yml is load-tested and can be used as a starting point. The executable always reads config.yml from its current working directory.

Documentation

• CLI reference
• Configuration reference
• Architecture policy
• Documentation policy