Meteostat Python Library Reaches First Stable Release

Christian Lamprecht
Dec 8, 2020 · 3 min read

Today we are announcing the first stable release of the Meteostat Python library on PyPI. With version 1.0.0, the library becomes much more mature and performant. Furthermore, future minor releases will guarantee full compatibility from version 1.0 upwards.

Image for post
Image for post

With our Python library we wanted to build a scalable solution which allows users to analyze historical weather and climate data on a large scale — both time-wise and geographically. In contrast to the Meteostat JSON API, the library provides unlimited data access and doesn’t require users to sign up. This is made possible with the help of Cloudflare, a global CDN provider, which allows Meteostat to serve data dumps relatively fast — no matter where you are. The ability to provide large amounts of data through a flexible, open and free interface makes the Meteostat project even more suitable for data science use cases.


The Meteostat Python package is available through PyPI. Therefore, installing the library is as easy as running this command:

pip install meteostat

Once the package is installed, you can start analyzing historical weather and climate data without limits.

Getting Started

The library features a detailed documentation with a lot of examples and details about the library’s API. Essentially, the package provides three classes which give you access to historical weather and climate data:

The Stations class is useful if you do not have a specific weather station ID at hand. It provides different filters for finding weather stations which are suitable for your use case. A common task is the lookup of the closest weather station to a certain geographical location. Take a look at this example:

The example prints a 2018 temperature chart for the city of Vancouver, BC using the Daily class. The data access does not require knowledge about the available weather stations and could easily be adapted to another location.

More examples and explanations are available in the documentation.

Our Roadmap

Once the library has settled and we do have some experience with how exactly people are using it, we will proceed with adding monthly data and an interface which provides regional averages. Furthermore, on mid to long-term distance, we want to move from Creative Commons Attribution-NonCommercial 4.0 International Public License to a license which enables commercial usage of meteorological data.

Also, we want to focus on stabilizing what is already there and implementing additional data sources. Going forward, all coding of the project will be open sourced under the MIT license.

If you want to get involved in the development of the Meteostat Python library, are running into an issue or just want to give some feedback, please refer to the GitHub repository. Also, you can support our work with a donation or by becoming a patron of Meteostat.

Last but not least: a big thanks to all users, Stargazers and supporters of the Meteostat Python library and the overall project.

Let’s continue to democratize weather and climate data!


A free online service which provides weather and climate…

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store