---
id: pydeconz
version: "120"
license: MIT
license_treatment: permissive
maintenance: active
---

# pydeconz — Python library for communicating with deCONZ REST-API

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

## 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 above — 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

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

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

## Tags

deconz rest api python, zigbee device control library, home automation deconz, zigbee gateway integration, deconz python wrapper, zigbee, home-automation, async-api

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