pydeconz

What it is and what it does

pydeconz is a Python wrapper around the deCONZ REST API that enables programmatic control and monitoring of Zigbee devices connected through deCONZ gateways. It is designed primarily for Home Assistant integration but can be used in any Python application that needs to communicate with deCONZ-compatible Zigbee networks. The library handles authentication via host address and API key, abstracts the REST API details, and provides async-first communication using aiohttp.

The package requires Python 3.12.0 or later and uses orjson for efficient JSON handling. It has been actively maintained since 2017-11-03 and is classified as production-stable. Installation is straightforward with minimal dependencies, making it suitable for embedded systems running Home Assistant or other home automation platforms.

Use it for:

• Integrate Zigbee devices into Home Assistant via deCONZ gateway without manual REST API calls
• Build custom home automation scripts that control Zigbee lights, switches, and sensors through deCONZ
• Monitor Zigbee device state and receive updates asynchronously in Python applications
• Automate Zigbee device management tasks in headless or containerized environments

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python library that wraps the deCONZ REST API to communicate with Zigbee devices and gateways supported by deCONZ, primarily for Home Assistant integration.

Yes, if you have a deCONZ gateway and need Python integration. The package is actively maintained, production-stable, has low install friction, carries a permissive MIT license, and has no known vulnerabilities. The requirement for Python 3.12.0 or later is a constraint but aligns with current Python versions. Verify that your deCONZ hardware and API setup are in place before installing.

Install

pydeconz on PyPI

pip install pydeconz

uv add pydeconz

poetry add pydeconz

Installing pydeconz

Before you install

Low install friction with only two runtime dependencies (aiohttp and orjson). The package is actively maintained with a recent commit on 2026-08-14 and has been in production use since its first release in 2017-11-03.

License in practice

MIT license is permissive, allowing use in commercial and private projects with minimal restrictions—only requiring attribution and including a copy of the license.

Quickstart

pip install pydeconz

import asyncio
from pydeconz import DeconzSession
import aiohttp

async def main():
    async with aiohttp.ClientSession() as session:
        deconz = DeconzSession(session, host='gateway', apikey='key')
        await deconz.get_state()

asyncio.run(main())

Requires Python 3.12.0 or later and an active deCONZ gateway with a valid API key.

Verify before relying

• Whether the library supports all device types currently supported by deCONZ or only a subset
• Performance characteristics when managing large numbers of Zigbee devices
• Specific Home Assistant version compatibility requirements

Package facts

Evidence: pydeconz-120-py3-none-any.whl

Keywords: deconz, zigbee, homeassistant

Tags

More Home Automation packages