Meteostat CLI

📚 Installation

uv tool install meteostat-cli

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

uv tool install "meteostat-cli[plot]"

To contribute to the weather stations directory using meteo station add, edit, validate and build, install the contrib extra:

uv tool install "meteostat-cli[contrib]"

For full provider support, use:

uv tool install "meteostat-cli[providers]"

Alternatively, you can use uvx:

uvx meteostat-cli [YOUR_COMMAND]

⚡ Shell Completion

meteo --install-completion   # Bash, Zsh, Fish, PowerShell

🚀 Usage

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

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

This will yield the following output:

         tmax
station
10637    35.9

📖 Documentation

Please refer to the official documentation for detailed usage instructions and examples.

🤝 Contributing

Please read our contributing guidelines for details on how to contribute to Meteostat.

Local Development

uv tool install --force -e ".[plot,contrib,providers]"

You can now run the CLI locally using:

meteo [YOUR_COMMAND]

📄 License

The Meteostat CLI is licensed under the MIT License. Data provided by Meteostat is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). See the documentation for details.