weather-for-grown-ups
v0.5.5
Published
Unified agent-native access to global and regional NOAA/DWD/Météo-France/ECMWF atmospheric forecasts, ensembles, reforecasts, and historical GFS analysis.
Maintainers
Readme
Weather for Grown Ups
Weather is the hello-world of agent tools. WFG is for when “temperature tomorrow” stops being enough.
One query language for operational NWP: global and regional models, deterministic and ensemble forecasts, physics and AI, current runs and history.
Ask the same atmospheric question across models without flattening what makes the models different.
30-second start
Requires Node.js 20+.
npx weather-for-grown-ups catalog --dataset all --search wind --json
npx weather-for-grown-ups query \
--dataset gfs \
--lat 50.08 --lon 14.43 \
--at 2026-08-24T12:00:00Z \
--vars temperature,wind \
--levels 850,700,500 \
--jsonFor repeated use:
npm install -g weather-for-grown-ups
wfg --helpThe contract
Normal atmospheric access is four orthogonal choices:
dataset × geometry × time × selection{
"dataset": "gefs",
"geometry": {
"type": "point",
"latitude": 50.08,
"longitude": 14.43
},
"time": {
"at": "2026-08-30T12:00:00Z"
},
"selection": {
"variables": ["temperature", "wind"],
"pressureLevelsHpa": [850, 700, 500]
},
"ensemble": {
"quantiles": [0.1, 0.5, 0.9]
}
}Change the dataset; keep the question. Unsupported combinations fail rather than being coerced into fake symmetry.
Read the unified atmospheric API →
Ask harder questions
Start with the question. Let the agent build the forecast investigation from scratch.
01 — Give me the serious forecast
What does the atmosphere over Prague look like tomorrow afternoon? Cover the surface and vertical structure, compare the main global guidance, and show which parts are robust across the ensembles.
GFS + IFS → pressure profiles → GEFS + IFS ENS → regional model if useful
02 — Is a front coming?
Is a frontal passage expected near Prague tomorrow? If so, when does it arrive, what changes through the column, and how consistent are the models?
GFS + IFS → time evolution → pressure profiles → GEFS + IFS ENS → run comparison
03 — AI vs physics
How do AIFS and IFS describe the atmosphere over Prague tomorrow? Where do they disagree through time and height, and is that disagreement large relative to their ensemble uncertainty?
IFS ↔ AIFS → pressure profiles → IFS ENS ↔ AIFS ENS → aligned comparison
04 — Plan a paragliding day
I’m planning to paraglide around Bassano tomorrow. How does the convective window develop through the day, what do the wind profile and stability look like, and how robust is the picture across ensembles and global/regional guidance?
profiles → parcel diagnostics → wind through the column → time evolution → ensembles → global + regional models
05 — Verify an old forecast
What did GFS predict three days ago for Prague today, and how well did that forecast verify?
archived forecast → analysis / radiosonde → error → lead provenance
Explore the investigation gallery →
Models
GFS · GEFS · AIGFS · AIGEFS · HGEFS · IFS · IFS ENS · AIFS · AIFS ENS · ICON-D2 · ICON-D2-EPS · AROME · PE-AROME · GFS analysis · GEFSv12 reforecast
Capabilities come from the catalog. Native grids, cadence, domains, members, fields and provenance remain explicit.
wfg catalog --dataset all --jsonAgents
WFG exposes the same core through CLI and MCP.
Shell available → CLI.
No shell / remote → MCP.
npx weather-for-grown-ups mcpAdd the portable WFG skill, then pick a setup guide: Codex · Claude Code · Hermes · OpenClaw · other agents
Go deeper
Examples · Installation · API contract · Catalog · History · Architecture · All docs
License
MIT. See LICENSE.
