airthings-cloud

What it is and what it does

airthings-cloud is a Python library that wraps the Airthings cloud API to retrieve data from Airthings environmental monitoring devices. It handles authentication and device communication asynchronously using aiohttp, making it suitable for integration into home automation systems and monitoring dashboards.

The library is designed for developers building integrations with Airthings hardware—such as radon detectors, CO₂ monitors, and air quality sensors. It abstracts away the HTTP details of the Airthings cloud service, allowing you to query device status and environmental readings programmatically. The active maintenance status and recent release history suggest ongoing compatibility with current Airthings cloud endpoints.

Use it for:

• Fetch air quality readings from Airthings devices in a Home Assistant integration or similar home automation platform.
• Build a dashboard that aggregates radon, CO₂, and particulate matter data from multiple Airthings devices.
• Monitor environmental conditions in a workspace or facility by polling Airthings sensors on a schedule.
• Trigger alerts or automations when air quality metrics from Airthings devices exceed configurable thresholds.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python library for communicating with Airthings air quality and environmental monitoring devices via their cloud API.

Yes, if you own Airthings devices and need programmatic access to their cloud data. The library has low installation friction, permissive licensing, no known vulnerabilities, and active maintenance. The main caveat is the strict Python 3.13.0 requirement and the need for valid Airthings API credentials—verify your device compatibility and authentication method before committing.

Install

airthings-cloud on PyPI

pip install airthings-cloud

uv add airthings-cloud

poetry add airthings-cloud

Installing airthings-cloud

Before you install

Low installation friction with a single async dependency (aiohttp). Active maintenance with recent commits as of April 2026, though the repository has modest visibility (6 stars).

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal legal constraints.

Quickstart

pip install airthings-cloud

import aiohttp
from airthings_cloud import AirthingsCloud

# Requires aiohttp session and Airthings API credentials
async with aiohttp.ClientSession() as session:
    client = AirthingsCloud(session, api_key, api_secret)
    devices = await client.get_devices()

Requires Python 3.13.0 or later; async/await usage requires an event loop context.

Verify before relying

• Whether the library supports all Airthings device models or only a subset
• API rate limits or throttling behavior when polling device data
• Authentication method requirements (API key, OAuth, or other credentials)

Package facts

Evidence: airthings_cloud-0.3.0-py3-none-any.whl

Tags

More Python Modules packages