adafruit-io 3.0.0

Python client library for Adafruit IO (http://io.adafruit.com/).

Adafruit IO Python

A Python library and examples for use with io.adafruit.com.

Compatible with Python Versions 3.6+

Installation

Easy Installation

If you have PIP installed (typically with apt-get install python-pip on a Debian/Ubuntu-based system) then run:

pip3 install adafruit-io

This will automatically install the Adafruit IO Python client code for your Python scripts to use. You might want to examine the examples folder in this GitHub repository to see examples of usage.

If the above command fails, you may first need to install prerequisites:

pip3 install setuptools
pip3 install wheel

Manual Installation

Clone or download the contents of this repository. Then navigate to the folder in a terminal and run the following command:

python setup.py install

Usage

Documentation for this project is available on the ReadTheDocs.

Service Integrations

The client includes REST and MQTT helpers for Adafruit IO integrations:

• Time

• Random Data

• Weather (requires IO+ subscription)

• Air Quality (requires IO+ subscription)

Integration API details are documented in docs/integrations.rst.

Service integration examples are included in:

• examples/api/weather.py

• examples/api/weather_create_delete.py

• examples/api/air_quality.py

• examples/api/air_quality_create_delete.py

• examples/mqtt/mqtt_weather.py

• examples/mqtt/mqtt_air_quality.py

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.