aioafero

Async Python library for the Hubspace / Afero IoT cloud API. Discover devices, poll state, and send commands through typed controllers on AferoBridgeV1.

Documentation: https://aioafero.readthedocs.io/

Installation

pip install aioafero

For Home Assistant, use the Hubspace integration, which installs this library from PyPI.

Quick start

Examples assume an asyncio REPL (python -m asyncio).

from aioafero import v1

bridge = v1.AferoBridgeV1("user@example.com", "password")
await bridge.initialize()
await bridge.async_block_until_done()

light = bridge.lights.get_device("<device_id>")
print(light.on)

await bridge.lights.turn_on("<device_id>")
await bridge.close()

See the user guide for architecture, configuration, controllers, subscribe callbacks, and troubleshooting.

Contributing

Bug reports and pull requests are welcome on GitHub. See CONTRIBUTING.md and the contributing docs.