open-meteo-client 0.0.5

Lightweight async Python client for the Open-Meteo weather API

open-meteo-client

A lightweight, async Python client for the Open-Meteo weather API — with high-level helpers that fit on a sticky note.

from openmeteo import weather

await weather.today("Dresden")

Status: 🚧 Planning — no code yet, just reserving the name and building the foundation. Track progress toward v0.1.0 in the CHANGELOG.

Planned features

• Lightweight — two dependencies (httpx, pydantic), no FlatBuffers, no pandas
• Async-first — built on httpx.AsyncClient
• Typed — full pydantic v2 models, StrEnum for weather variables, IDE autocomplete
• Two layers — high-level convenience API (weather.today()) on top of a full low-level Client

Install

pip install open-meteo-client

⚠️ Package reserved — no functionality yet. Check back for v0.1.0.

Documentation

Full docs live at open-meteo-client.readthedocs.io:

• Tutorial — learn by example
• How-to guides — solve specific problems
• Reference — the full public API
• Explanation — the design "why"

Roadmap

Public roadmap and backlog live on the Roadmap project board. Pick anything from the Backlog column that's not claimed — see CONTRIBUTING.md.

Changelog

See CHANGELOG.md for release notes.

Contributing

Contributions are welcome! See CONTRIBUTING.md for setup instructions and guidelines.

Contributors

Jakob Heine 💻 📖 🎨 🚇 🚧 ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!

License

Apache-2.0. See LICENSE.