airthings-ble
Manage Airthings BLE devices
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; BLE adapter and Airthings device within range required at runtime.
- 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 · maintenance · safety
permissive license (permissive) — MIT license (permissive) — no restrictions on use, modification, or distribution in proprietary or open-source projects.
last release 2025-10-29 (289 days) · last repo commit 2026-08-13 · 36 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 74,879 downloads/mo, #14,776 on PyPI
Alternatives
Verify before relying
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)- 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.
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 on this page. Verify before relying on it.
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
airthings-ble on PyPI
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.
Requires Python 3.11 or later; BLE adapter and Airthings device within range required at runtime.
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)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 | permissive license permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesasync-interruptbleakbleak-retry-connectorcbor2 |
| Maintenance | Actively maintained 289 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 74,879 / month, #14,776 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: OS IndependentTopic :: Software Development :: Libraries |
Evidence: airthings_ble-1.2.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “airthings ble library”
- airthings-bleLibrary to communicate with Airthings air-quality monitors over…
- airthings-cloudA Python library for communicating with Airthings air quality and…
- matter-ble-proxyA Python client library that bridges BLE operations to a remote…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also airthings-cloud · xiaomi-ble · nettigo-air-monitor · bthome-ble · aiobmsble · govee-ble · inkbird-ble · kegtron-ble · led-ble · greeneye_monitor