pydeconz
Python library for communicating with deCONZ REST-API
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12.0 or later and an active deCONZ gateway with a valid API key.
- 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 · maintenance · safety
MIT (permissive) — MIT license is permissive, allowing use in commercial and private projects with minimal restrictions—only requiring attribution and including a copy of the license.
last release 2025-03-23 (509 days) · last repo commit 2026-08-14 · 47 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 77,213 downloads/mo, #14,546 on PyPI
Alternatives
Verify before relying
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())- 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
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 on it.
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
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.
Requires Python 3.12.0 or later and an active deCONZ gateway with a valid API key.
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())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 the current Python release >=3.12.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesaiohttporjson |
| Maintenance | Actively maintained 509 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 77,213 / month, #14,546 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3.12Topic :: Home Automation |
Evidence: pydeconz-120-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 › “deconz rest api python”
- pydeconzPython library that wraps the deCONZ REST API to communicate with…
- zigpy-deconzProvides a Python interface to deCONZ-based Zigbee radio adapters…
- agithubA lightweight REST API client with transparent Python syntax that…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also zigpy-deconz · zigpy-xbee · zigpy · aioruuvigateway · zha · aiohomekit · zigpy-zigate · zigpy-znp · zha-quirks · aiomusiccast