---
id: airthings-cloud
version: "0.3.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# airthings-cloud — A python3 library to communicate with Airthings devices

License: permissive · Maintenance: active · Downloads: 73.7K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 73.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airthings api client, air quality monitoring python, airthings cloud integration, environmental sensor data, home automation air quality, airthings device communication, radon detector integration, iot-integration, async-http, home-automation

[View on SkillFed](https://skillfed.io/packages/airthings-cloud) · [View on PyPI](https://pypi.org/project/airthings-cloud/)