---
id: airthings-ble
version: "1.2.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# airthings-ble — Manage Airthings BLE devices

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

## What it is and what it does

airthings-ble is a Python library for reading sensor data from Airthings air-quality monitors via Bluetooth Low Energy. It wraps the BLE protocol used by Wave and Corentium devices, exposing a simple async API to fetch current measurements. The library is primarily designed as a backend for the Home Assistant Airthings integration but can be used standalone in any Python 3.11+ application that needs to monitor air quality from these devices.

The package depends on bleak (cross-platform BLE client), bleak-retry-connector (automatic reconnection), async-interrupt (async signal handling), and cbor2 (binary data decoding). It is actively maintained, has no known security vulnerabilities, and carries a permissive MIT license. Installation is straightforward with no compiled dependencies or system libraries required beyond a working BLE adapter.

Use it for:

- Integrate Airthings Wave or Corentium monitors into Home Assistant or other home automation platforms for air-quality dashboards.
- Build a standalone Python script to log radon, CO2, or humidity readings from an Airthings device to a database or time-series store.
- Monitor indoor air quality in real time and trigger alerts or automations when sensor values exceed thresholds.
- Collect historical air-quality data from multiple Airthings devices for analysis or compliance reporting.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Library to communicate with Airthings air-quality monitors over Bluetooth Low Energy, reading sensor data from supported Wave and Corentium models.

Yes, if you own a supported Airthings device (Wave Mini, Wave Plus, Wave Radon, Wave Enhance, Wave Gen 1, or Corentium Home 2) and need to read its sensor data programmatically. The library is actively maintained, has low install friction, carries no security vulnerabilities, and is the standard integration point for Home Assistant. Not useful for unsupported devices (Hub, Renew, View Plus, View Radon) which use BLE only for setup.

## Install

pip install airthings-ble
uv add airthings-ble
poetry add airthings-ble

## Installing airthings-ble

Before you install: Low install friction; pure Python wheel with four runtime dependencies (bleak, bleak-retry-connector, async-interrupt, cbor2). Actively maintained with recent release; last commit 2026-08-13.

License in practice: MIT license (permissive) — no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install airthings-ble

from airthings_ble import AirthingsDevice
import asyncio

async def main():
    device = AirthingsDevice(address="XX:XX:XX:XX:XX:XX")
    await device.update()
    print(device.sensors)

Requires Python 3.11 or later; BLE adapter and Airthings device within range required at runtime.

Verify before relying:

- Whether the library supports all sensor types (radon, CO2, humidity, etc.) across all listed devices or only a subset.
- Performance characteristics when polling multiple devices concurrently or at high frequency.
- Stability and reconnection behavior over extended periods or with intermittent BLE signal.

## Package facts

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

## Tags

airthings ble library, bluetooth air quality monitor, radon detector ble control, airthings device integration, ble sensor data reader, home automation air quality, airthings wave mini api, ble-devices, home-automation, air-quality

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