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 ping

print(ping())
# -> "open-meteo-client 0.0.4: pong"

Status: planning

This package is pre-alpha. The real weather API (today, tomorrow, forecast, OpenMeteoClient, Location) lands in v0.1.0. Until then, ping() exists so you can verify the package imports and runs.

Track progress on the roadmap board.

What you want to read

This site follows the Diátaxis framework — four distinct kinds of documentation, each serving a different user intent:

Section	When you need it	Example
Tutorial	“I’m new — walk me through my first call.”	Your first forecast in five lines
How-to guides	“I have a specific goal.”	How do I handle rate limits?
Reference	“Just show me the exact API.”	Every public function, class, and enum
Explanation	“Why is it designed that way?”	Why async-only?

Install

pip install open-meteo-client

Requires Python 3.11+. Two runtime dependencies: httpx and pydantic.

Contents

• Tutorial
  • Getting started
• How-to guides
  • Verify open-meteo-client is installed
• Reference
  • openmeteo
• Explanation
  • Why async-only
  • Why only two runtime dependencies
  • Architecture

---

Elsewhere

📦 PyPI · 🐙 GitHub · 💬 Discussions · 🗺️ Roadmap