zigpy
Library implementing a Zigbee stack
Decision gist · record as of 2026-08-14
Yes, if you are building or extending a home automation or IoT platform that needs to control Zigbee devices. The library is actively maintained, has low install friction, and is battle-tested in production via Home Assistant. However, you must accept the GPL-3.0 copyleft license (your application must also be open-source or compatible), and you will need to install a separate radio library matching your Zigbee coordinator hardware. Not suitable for closed-source or proprietary projects.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later.
- Intended for use with a compatible Zigbee radio library (bellows, zigpy-deconz, zigpy-xbee, zigpy-zigate, zigpy-znp, or zigpy-cc) and typically integrated into a larger home automation or IoT platform.
- Low install friction with a pure-Python wheel and 10 runtime dependencies.
License · maintenance · safety
GPL-3.0 (copyleft) — Licensed under GPL-3.0 (copyleft). Any application that links or imports zigpy must also be distributed under a compatible open-source license; proprietary or closed-source projects cannot use this package.
last release 2026-07-28 (17 days) · last repo commit 2026-08-05 · 1,056 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 673,551 downloads/mo, #5,395 on PyPI
Alternatives
Verify before relying
pip install zigpy
import zigpy
# zigpy is typically used via radio library adapters (bellows, zigpy-deconz, etc.)
# and home automation frameworks like Home Assistant's ZHA integration- Whether zigpy can be used standalone or requires integration with a radio library and host application
- Performance characteristics and latency for real-time device control scenarios
- Stability and maturity level for production home automation deployments
What it is and what it does
zigpy is a Python library that implements the Zigbee protocol stack as a hardware-independent abstraction layer. It translates between different Zigbee radio hardware (from manufacturers like Silicon Labs, Texas Instruments, Digi, and others) and a unified Python API, allowing applications to control Zigbee devices without needing to understand each radio's proprietary communication protocol. The library handles ZCL (Zigbee Cluster Library) and ZDO (Zigbee Device Object) state management, supporting device types such as binary sensors, temperature sensors, lights, switches, covers, fans, climate equipment, and locks.
zigpy is designed as a foundation for home automation platforms—it powers the ZHA integration in Home Assistant, Domoticz's Zigbee plugin, and Jeedom's Zigbee plugin. It includes support for Zigbee Over-The-Air (OTA) firmware updates with built-in providers for IKEA, Inovelli, LEDVANCE/OSRAM, SONOFF/ITEAD, and ThirdReality devices. To use zigpy, you install one of its separate radio library modules (bellows, zigpy-deconz, zigpy-xbee, etc.) that correspond to your specific Zigbee coordinator hardware, then integrate it into your application or home automation system.
Use it for
- Build a home automation system that controls Zigbee lights, switches, and sensors via a unified Python API
- Integrate Zigbee device management into an existing IoT platform or custom application
- Perform firmware updates on Zigbee devices using OTA update files from supported manufacturers
- Support multiple Zigbee radio hardware types in a single application by swapping radio library modules
- Monitor and control Zigbee binary and analog sensors (motion, temperature, humidity) in a networked environment
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building or extending a home automation or IoT platform that needs to control Zigbee devices.
The library is actively maintained, has low install friction, and is battle-tested in production via Home Assistant. However, you must accept the GPL-3.0 copyleft license (your application must also be open-source or compatible), and you will need to install a separate radio library matching your Zigbee coordinator hardware. Not suitable for closed-source or proprietary projects.
Install
zigpy on PyPI
Before you install
Low install friction with a pure-Python wheel and 10 runtime dependencies. Active maintenance with a release 17 days old and continuous commits; last commit on 2026-08-05 indicates ongoing development.
Requires Python 3.11 or later. Intended for use with a compatible Zigbee radio library (bellows, zigpy-deconz, zigpy-xbee, zigpy-zigate, zigpy-znp, or zigpy-cc) and typically integrated into a larger home automation or IoT platform.
License in practice
Licensed under GPL-3.0 (copyleft). Any application that links or imports zigpy must also be distributed under a compatible open-source license; proprietary or closed-source projects cannot use this package.
Quickstart
pip install zigpy
import zigpy
# zigpy is typically used via radio library adapters (bellows, zigpy-deconz, etc.)
# and home automation frameworks like Home Assistant's ZHA integrationVerify before relying
- Whether zigpy can be used standalone or requires integration with a radio library and host application
- Performance characteristics and latency for real-time device control scenarios
- Stability and maturity level for production home automation deployments
Package facts
| License | GPL-3.0 copyleft |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 10 packagesattrsaiohttpaiosqlitecrccheckcryptographyvoluptuousjsonschemaserialxtyping_extensionsfrozendict |
| Maintenance | Actively maintained 17 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 673,551 / month, #5,395 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: zigpy-2.1.0-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 › “zigbee protocol stack python”
- zigpyzigpy is a hardware-independent Zigbee protocol stack library that…
- zigpy-deconzProvides a Python interface to deCONZ-based Zigbee radio adapters…
- zigpy-zigateProvides a Python 3 driver for ZiGate Zigbee radio adapters (USB,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also bellows · zigpy-xbee · zigpy-zigate · zigpy-znp · meshtastic · zigpy-deconz · zha · zha-quirks · pydeconz · pyworxcloud