Meteostat CLI

The Meteostat CLI gives you direct access to weather and climate data from the terminal. It is built on top of the Meteostat Python library and lets you query historical observations, browse weather stations, and export data in a variety of formats — all without writing a single line of code.

📚 Installation

Install the CLI via PyPI:

uv tool install meteostat-cli

For plotting capabilities (png and svg output), install the plot extra:

uv tool install "meteostat-cli[plot]"

Alternatively, you can use uvx:

uvx --from meteostat-cli meteo

🚀 Usage

Want to know the hottest temperature of 2024 at Frankfurt Airport (station 10637)? Run the following command:

meteo d 10637 -s 2024-01-01 -e 2024-12-31 -p tmax --agg max

This will yield the following output:

         tmax
station
10637    35.9

⚡ Shell Completion

To enable shell completion (Bash, Zsh, Fish, PowerShell), run the following command:

meteo --install-completion

👀 Learn More

📄️ Overview

The Meteostat CLI gives you direct access to weather and climate data from the terminal. It is built on top of the Meteostat Python library and lets you query historical observations, browse weather stations, and export data in a variety of formats — all without writing a single line of code.

🗃️ Weather Stations

3 items

🗃️ Time Series

4 items

📄️ Configuration

Manage the Meteostat CLI configuration. Settings are stored in a cli.yml file in the platform-specific app directory (e.g. ~/.config/meteostat/cli.yml on Linux).