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; SPC Day 1-3 convective outlooks; 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
• Operations guide
• Troubleshooting guide
• Example configs
• Event wire contract
• Postgres table contract
• NWS integration notes
• SPC integration notes
• Open-Meteo integration notes
• OpenWeather integration notes
• Architecture policy
• Development policy
• Documentation policy