2026-01-14 00:12:51 +00:00
|
|
|
# weatherfeeder
|
|
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
`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.
|
2026-01-17 17:39:18 -06:00
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
It currently supports NWS observations, alerts, hourly forecasts, narrative
|
2026-06-11 00:27:23 +00:00
|
|
|
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.
|
2026-01-17 17:39:18 -06:00
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
## Quickstart
|
2026-01-17 17:39:18 -06:00
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
Run the checked-in sample config:
|
2026-01-17 17:39:18 -06:00
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
```sh
|
|
|
|
|
cd cmd/weatherfeeder
|
|
|
|
|
go run .
|
|
|
|
|
```
|
2026-01-17 17:39:18 -06:00
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
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.
|
2026-01-17 17:39:18 -06:00
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
## Documentation
|
2026-01-17 17:39:18 -06:00
|
|
|
|
2026-06-10 20:07:56 +00:00
|
|
|
- [CLI reference](docs/cli.md)
|
|
|
|
|
- [Configuration reference](docs/config.md)
|
2026-06-10 20:15:08 +00:00
|
|
|
- [Operations guide](docs/operations.md)
|
|
|
|
|
- [Troubleshooting guide](docs/troubleshooting.md)
|
2026-06-10 20:17:40 +00:00
|
|
|
- [Example configs](examples/)
|
2026-06-11 10:00:15 -05:00
|
|
|
- [Go consumer guide](docs/consumers/api.md)
|
2026-06-10 20:12:27 +00:00
|
|
|
- [Event wire contract](docs/integrations/events.md)
|
|
|
|
|
- [Postgres table contract](docs/integrations/postgres.md)
|
2026-06-11 10:00:15 -05:00
|
|
|
- [Feedkit integration notes](docs/integrations/feedkit.md)
|
2026-06-10 20:25:13 +00:00
|
|
|
- [NWS integration notes](docs/integrations/nws.md)
|
2026-06-11 00:30:49 +00:00
|
|
|
- [SPC integration notes](docs/integrations/spc.md)
|
2026-06-10 20:25:13 +00:00
|
|
|
- [Open-Meteo integration notes](docs/integrations/openmeteo.md)
|
|
|
|
|
- [OpenWeather integration notes](docs/integrations/openweather.md)
|
2026-06-10 20:07:56 +00:00
|
|
|
- [Architecture policy](docs/policy/architecture.md)
|
2026-06-10 20:22:38 +00:00
|
|
|
- [Development policy](docs/policy/development.md)
|
2026-06-10 20:07:56 +00:00
|
|
|
- [Documentation policy](docs/policy/documentation.md)
|
