# zigpy

Library implementing a Zigbee stack

Repository: https://github.com/zigpy/zigpy
Canonical: https://ross.abutalabs.com/products/zigpy
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: zigbee
Last push: 2026-08-24T20:08:35+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 95, longevity 100
- inputs: {"age_days": 3131, "days_push": 9, "days_rel": 36, "gap_med": 9, "n_releases_24m": 60}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1054, forks 215 (observed 2026-08-28T04:03:23.964706+00:00)

## What it is
Zigpy is a Python library implementing a Zigbee stack, and zha-device-handlers provides custom 'quirks' that bridge non-standard Zigbee device behavior for the ZHA integration in Home Assistant. It parses custom messages to and from devices whose manufacturers deviate from the Zigbee Cluster Library specification.

## Use cases
- make a non-standard Zigbee sensor work with Home Assistant ZHA
- add device support quirks for Tuya Zigbee devices
- parse custom Zigbee cluster messages from a manufacturer device
- control Zigbee lights and switches from Home Assistant
- support a Zigbee device that deviates from the ZCL specification

## When to choose
- you use Home Assistant's ZHA integration and a device misbehaves or lacks functions
- you want to write a custom quirk for a non-compliant Zigbee device
- you need a pure-Python Zigbee stack for a home automation project

## When to avoid
- you prefer Zigbee2MQTT or deCONZ ecosystems with their own converter sets
- your Zigbee devices are fully standards-compliant and work out of the box
- you need Zigbee support outside the Python/Home Assistant ecosystem

## Facets
- artifact type: library
- maturity: active
- function: middleware, parser, sdk
- domain: iot
- platform: python, self-hosted
- tags: zigbee, home-assistant, zha, device-quirks, iot-devices, tuya, home-automation, automation, linux

## Member repositories
- zigpy/zigpy (main) score 98
- zigpy/zha-device-handlers (plugin) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:23.964706+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:38:45.103167+00:00, confidence not recorded.
  - readme: https://github.com/zigpy/zigpy (fetched 2026-08-28T04:03:23.964706+00:00, sha 9c05a4dc3e18)
  - registry_pypi: https://pypi.org/pypi/zigpy/json (fetched 2026-08-29T12:43:24.752230+00:00, sha 2b0b7f513713)
- Data as of 2026-08-30T08:39:29.467469+00:00.