Wetterdienst - Open weather data for humans
Hohenpeißenberg, Germany: 245 years of mean air temperature, one stripe per year from 1781 to 2025 — fetched and drawn with wetterdienst.
Global warming is not an opinion.
Erderwärmung ist keine Meinung.
[!WARNING] This library is a work in progress! Breaking changes should be expected until a 1.0 release, so version pinning is recommended.
Wetterdienst gives you weather, climate and hydrology data from 22 national services through one interface: one way to find a station, one way to ask for values, one shape of result. It is a polars-based Python library, a command line client, a REST API, an MCP endpoint and a web app, all serving the same data.
Contributions and feedback are very welcome — we do not use most of this data ourselves, so what you need is what tells us what to build next. Hand in an issue or a PR.
What we support
| Provider | Country | What you get |
|---|---|---|
| DWD | 🇩🇪 Germany | observations, MOSMIX/DMO forecasts, radar, warnings, road weather, derived indices |
| AEMET | 🇪🇸 Spain | observations (API key) |
| CHMI | 🇨🇿 Czechia | observations |
| DMI | 🇩🇰 Denmark | observations, incl. Greenland and the Faroe Islands (API key) |
| EA | 🇬🇧 England | hydrology |
| Eaufrance | 🇫🇷 France | hydrology |
| ECCC | 🇨🇦 Canada | observations |
| FMI | 🇫🇮 Finland | observations |
| GeoSphere | 🇦🇹 Austria | observations |
| IMGW | 🇵🇱 Poland | meteorology, hydrology |
| IPMA | 🇵🇹 Portugal | observations |
| KNMI | 🇳🇱 Netherlands | observations (API key) |
| LHMT | 🇱🇹 Lithuania | observations |
| Met Office | 🇬🇧 UK | MIDAS Open observations (CEDA account) |
| Météo-France | 🇫🇷 France | observations, SYNOP |
| MeteoSwiss | 🇨🇭 Switzerland | observations |
| met.no | 🇳🇴 Norway | Frost observations (API key) |
| NOAA | 🌍 worldwide | GHCN daily and hourly, stations across the globe |
| NWS | 🇺🇸 USA | observations |
| RMI | 🇧🇪 Belgium | observations |
| SMHI | 🇸🇪 Sweden | observations |
| WSV | 🇩🇪 Germany | hydrology (Pegelonline) |
Across those: 514 canonical parameters, resolutions from 1 minute to annual, and archives
reaching back centuries where the service keeps them. Every provider is reached the same way, and a
parameter means the same thing whichever service reports it — temperature_air_mean_2m is the mean
air temperature at 2 m, converted to the same unit, everywhere.
Licenses and usage requirements differ per provider, so check the data chapter before you publish anything built on them. It also lists every dataset and parameter per provider.
Features
- Stations, values and station history (metadata changes) through one request model
- Find stations by name, id, distance from a point, bounding box or rank
- Request by
parameters,periods,start_date,end_date; tune the rest throughSettings - Unit conversion, interpolation and summarization for a point between stations
- DWD weather alerts (CAP warnings) with GeoJSON geometry, by community or district
- SQL queries over results, export to CSV/JSON/Excel/Parquet/Zarr and to SQLite, PostgreSQL, CrateDB, InfluxDB and DuckDB
- Command line client, REST API and a public Docker image
- MCP (Model Context Protocol) endpoint, so LLM agents can query the data as tools
- Web app with map-based explorer, forecasts, climate stripes and a glossary, at wetterdienst.eobs.org
Setup
pip install wetterdienst # from PyPI
pip install wetterdienst[export] # with an extra
pip install git+https://github.com/earthobservations/wetterdienst # most recent
Extras: bufr, cratedb, duckdb, eccodes, excel, export, influxdb, interpolation,
knmi, mcp, mysql, pdf, plotting, postgresql, radar, radarplus, restapi, sql.
Check the installation with wetterdienst --help.
Prefer Docker? The image ships with the optional dependencies included:
docker pull ghcr.io/earthobservations/wetterdienst
docker run -ti ghcr.io/earthobservations/wetterdienst wetterdienst --version
See the Docker chapter for running the REST API and the app from the image.
Example
Daily precipitation for Zinnwald-Georgenfeld, August 2002 — the flood:
from wetterdienst.provider.dwd.observation import DwdObservationRequest
request = DwdObservationRequest(
parameters=[("daily", "climate_summary", "precipitation_height")],
start_date="2002-08-11",
end_date="2002-08-13",
).filter_by_station_id(station_id=(5779,))
stations = request.df
stations.head()
# ┌────────────┬─────────────────┬────────────┬─────────────────────────┬───┬───────────┬────────┬──────────────────────┬─────────┐
# │ resolution ┆ dataset ┆ station_id ┆ start_date ┆ … ┆ longitude ┆ height ┆ name ┆ state │
# │ --- ┆ --- ┆ --- ┆ --- ┆ ┆ --- ┆ --- ┆ --- ┆ --- │
# │ str ┆ str ┆ str ┆ datetime[μs, UTC] ┆ ┆ f64 ┆ f64 ┆ str ┆ str │
# ╞════════════╪═════════════════╪════════════╪═════════════════════════╪═══╪═══════════╪════════╪══════════════════════╪═════════╡
# │ daily ┆ climate_summary ┆ 05779 ┆ 1971-01-01 00:00:00 UTC ┆ … ┆ 13.7516 ┆ 877.0 ┆ Zinnwald-Georgenfeld ┆ Sachsen │
# └────────────┴─────────────────┴────────────┴─────────────────────────┴───┴───────────┴────────┴──────────────────────┴─────────┘
values = request.values.all().df
values.head()
# ┌────────────┬────────────┬─────────────────┬──────────────────────┬─────────────────────────┬───────┬─────────┐
# │ station_id ┆ resolution ┆ dataset ┆ parameter ┆ date ┆ value ┆ quality │
# ╞════════════╪════════════╪═════════════════╪══════════════════════╪═════════════════════════╪═══════╪═════════╡
# │ 05779 ┆ daily ┆ climate_summary ┆ precipitation_height ┆ 2002-08-11 00:00:00 UTC ┆ 67.9 ┆ 10.0 │
# │ 05779 ┆ daily ┆ climate_summary ┆ precipitation_height ┆ 2002-08-12 00:00:00 UTC ┆ 312.0 ┆ 10.0 │
# │ 05779 ┆ daily ┆ climate_summary ┆ precipitation_height ┆ 2002-08-13 00:00:00 UTC ┆ 26.3 ┆ 10.0 │
# └────────────┴────────────┴─────────────────┴──────────────────────┴─────────────────────────┴───────┴─────────┘
values.to_pandas() # if you would rather have pandas
The same thing from the command line:
wetterdienst stations --provider=dwd --network=observation --parameters=daily/kl --all
wetterdienst values --provider=dwd --network=observation --parameters=daily/kl --station=1048,4411
More in examples and in the usage chapter.
Links
- App: wetterdienst.eobs.org
- Documentation: wetterdienst.readthedocs.io (usage, contribution, changelog)
- Examples and benchmarks
What we stand for
- 🏳️🌈🏳️⚧️ We stand with the LGBTQI+ community.
- ✊ No place for Nazis. FCKNZS.
- 🌡️ Global warming is not an opinion.
- 🔓 Weather data belongs to everyone.
Acknowledgements
We want to acknowledge all environmental agencies which provide their data open and free of charge first and foremost for the sake of endless research possibilities.
We want to acknowledge all contributors for being part of the improvements to this library that make it better and better every day.
Supported by
Special thanks to the kind people at JetBrains s.r.o. for a PyCharm licence through their open-source support programme, and to Anthropic for a Claude Max subscription for open-source maintainers.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file wetterdienst-0.134.0.tar.gz.
File metadata
- Download URL: wetterdienst-0.134.0.tar.gz
- Upload date:
- Size: 361.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c0122e14f6ad124ad3a63543c6a396baa74fd0d5583a62260d3d6e776e09b2cc
|
|
| MD5 |
a362b29888f29f26503a9b39369b5645
|
|
| BLAKE2b-256 |
c22e497b0834e80cdceac1c00b28a5846956a410f906eb94cf7697b751515154
|
File details
Details for the file wetterdienst-0.134.0-py3-none-any.whl.
File metadata
- Download URL: wetterdienst-0.134.0-py3-none-any.whl
- Upload date:
- Size: 457.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a35530d3af22c045c1f0298518c7bece1b17ac71b420577279689e5eaffca0e0
|
|
| MD5 |
e997fca0bd2f6db665150f97aa9d54a1
|
|
| BLAKE2b-256 |
48b27e712a36dc3af147da49ee100294eac86c828107f51e4c107787d608875f
|
