---
id: zigpy
version: "2.1.0"
license: GPL-3.0
license_treatment: copyleft
maintenance: active
---

# zigpy — Library implementing a Zigbee stack

License: copyleft · Maintenance: active · Downloads: 673.6K/mo

## 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 above — verify before relying.

zigpy is a hardware-independent Zigbee protocol stack library that enables Python applications to communicate with and control Zigbee devices through compatible radio adapters.

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

pip install zigpy
uv add zigpy
poetry add zigpy

## Installing zigpy

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.

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 integration

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.

Verify 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_current
- Install friction: low
- Maintenance: active
- Downloads: 673.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

zigbee protocol stack python, zigbee device control library, zigbee coordinator integration, home automation zigbee, zigbee cluster library, zigbee radio adapter support, zigbee device management, zigbee ota firmware updates, zigbee-protocol, home-automation, iot-hardware

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