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.
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 |
| 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: over 600 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,end;Optionssay how values come back,Settingsconfigure the host - 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, a glossary and an overview of the providers, 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.
On Linux, a process that imports ecCodes (bufr or eccodes extra) itself, before wetterdienst
does, and then imports pyproj (which radarplus brings) can crash at exit
(ecmwf/eckit#354). See
known issues
for the workaround.
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_amount")],
start="2002-08-11",
end="2002-08-13",
).filter_by_station_id(station_id=(5779,))
stations = request.df
stations.head()
# ┌────────────┬─────────────────┬────────────┬─────────────────────────┬───┬───────────┬───────────┬──────────────────────┬─────────┐
# │ resolution ┆ dataset ┆ station_id ┆ start_timestamp ┆ … ┆ longitude ┆ elevation ┆ name ┆ region │
# │ --- ┆ --- ┆ --- ┆ --- ┆ ┆ --- ┆ --- ┆ --- ┆ --- │
# │ 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 ┆ timestamp ┆ value ┆ quality_flags │
# ╞════════════╪════════════╪═════════════════╪══════════════════════╪═════════════════════════╪═══════╪═══════════════╡
# │ 05779 ┆ daily ┆ climate_summary ┆ precipitation_amount ┆ 2002-08-11 00:00:00 UTC ┆ 67.9 ┆ 10 │
# │ 05779 ┆ daily ┆ climate_summary ┆ precipitation_amount ┆ 2002-08-12 00:00:00 UTC ┆ 312.0 ┆ 10 │
# │ 05779 ┆ daily ┆ climate_summary ┆ precipitation_amount ┆ 2002-08-13 00:00:00 UTC ┆ 26.3 ┆ 10 │
# └────────────┴────────────┴─────────────────┴──────────────────────┴─────────────────────────┴───────┴───────────────┘
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 --stations=1048,4411
More in examples and in the quickstart.
Where to start
Documentation: wetterdienst.readthedocs.io
- Install and make a first call (Python, command line, REST API, assistant, app): Quickstart, and Concepts for the words.
- Python: Python API, examples and benchmarks.
- Command line: command line interface.
- REST API and MCP: REST API, MCP server.
- App: wetterdienst.eobs.org, and how to run your own.
- The data: providers, parameters and licences, DWD weather alerts.
- Upgrade: compatibility, what is stable and how a break is announced, and the migration note from 0.139.0.
- Something fails: troubleshooting and known issues.
- Contribute: contribution guide, changelog.
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
Metadata
1 maintainer
Release files for wetterdienst 0.162.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| wetterdienst-0.162.0.tar.gz | 750.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wetterdienst-0.162.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / wetterdienst-0.162.0.tar.gz
| Download URL | wetterdienst-0.162.0.tar.gz |
|---|---|
| Size | 750.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0f20a7f3a59fe48001f4cfdafb83c2a06b68b7498a29996c1509ccf21d5bbf9b
|
|
BLAKE2b-256 checksum How to use checksums |
2a47b0d3f988af4d60e94ffaf0fd12be06c44a3f0d879ee63cf8638e2f771126
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","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}
|
Release files / wetterdienst-0.162.0-py3-none-any.whl
| Download URL | wetterdienst-0.162.0-py3-none-any.whl |
|---|---|
| Size | 843.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb49098213f6e70f51498c84bb106d25c031c5e2b9bdc9642ced0bb2b0719799
|
|
BLAKE2b-256 checksum How to use checksums |
2292c5f4c81c43021e66287f0a871d00b657a8c97cba831f8c38cc6f795526dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","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}
|
Security for wetterdienst 0.162.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
