aioairctrl

library0.3.1pypypi✓ verified 84d ago

Library for controlling Philips air purifiers using encrypted CoAP. Currently at version 0.3.1, released on 2025-11-13. Active development, with frequent releases.

http-networking communication

pip install aioairctrl

github ↗package ↗

INSTALL

IMPORT

SIG · AIOAIRCTRL

aioairctrl

http-networkingpythonv0.3.1

Install

2.2s avg

Import

317ms

Disk

27MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.2.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.322s · 28.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.2s · import 0.312s · 29MB

27MB installed

● package 27MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CoAPClient

✓ from aioairctrl import CoAPClient

✗ from aioairctrl.client import CoAPClient

Import path changed in v0.3.0; direct client import is deprecated.

Connects to a Philips air purifier at given IP and fetches device status.

import asyncio from aioairctrl import CoAPClient async def main(): host = "192.168.1.100" client = await CoAPClient.create(host) status = await client.get_status() print(status) await client.shutdown() asyncio.run(main())

Debug

Known issues

breakingIn v0.3.0, the import path for CoAPClient changed from `aioairctrl.client` to `aioairctrl`. Old imports will raise ImportError.

fix

Change imports to `from aioairctrl import CoAPClient`.

affects: >=0.3.0

gotchaThe library requires Python >=3.12. Attempting to install on older Python will fail.

fix

Ensure Python 3.12+ is used.

affects: all

gotchaThe client uses encrypted CoAP and may fail if the device is not on the same network or if ports are blocked.

fix

Verify network connectivity and that the device's CoAP port (typically 5684) is reachable.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'CoAPClient' from 'aioairctrl'

Incorrect import path; CoAPClient is exported from aioairctrl, not aioairctrl.client.

fix

Use `from aioairctrl import CoAPClient`.

RuntimeError: asyncio.run() cannot be called from a running event loop

Calling asyncio.run() inside an async context (e.g., Jupyter notebook or another async function).

fix

Call `await main()` instead of asyncio.run() in async environments.

Upgrade

Version history

0.3.1latest on PyPI · released Mar 1, 2026

Audit

Dependencies

aiocoaprequiredCoAP communication

Agent activity

59 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/kongo09/aioairctrl ↗

packagehttps://pypi.org/project/aioairctrl/ ↗