Getting Started


  • Python v3.6 or higher.
  • An active AerisWeather API subscription.

Don't have an active AerisWeather weather API client account?
Accessing the API data requires an active weather API subscription, and registration of your application or namespace. You can sign up for a free developer account at the sign up page to get your client ID and secret.


This SDK is provided free of charge for AerisWeather's customers, and is available for use under the MIT open source license.


The full SDK containing the library, docs and demos, is available for download from the project's GitHub page.

If you want just the library, that's available all by itself on PyPi. Most likely though, you'll just want to install it via pip (see Installation).

SDK Contents

  • Core Library/Package:

    The AerisWeather Python SDK includes a core Python library that provides simplified fetching and parsing of data from the API, written in Python v3.6 and available on GitHub.

  • Unit Tests:

    The SDK incudes a full set of unit tests, which are a great source of sample code for accessing the weather API endpoints.

  • Docs:

    A full set of code documentation is provided, outlining class and method structure. More documentation can be found at, and on the project's GitHub page.

  • Demo Project File:

    AerisWeatherPythonDemo is a Python file containing examples demonstrating a few ways to use the aerisweather package to get data from the AerisWeather API. Get it from GitHub here.

  • Jupyter Notebook:

    Also in the AerisWeatherPythonDemo folder is a Jupyter Notebook. This is another source of example code. The notebook allows you to experiment with various methods of accessing the API without having to run the demo project.

  • Readme

  • License file


Last modified: July 30, 2020