zha
Library implementing ZHA for Home Assistant
Decision gist · record as of 2026-08-14
Yes, if you are using Home Assistant and need Zigbee device support. The package is actively maintained, has no known vulnerabilities, and low install friction. It is purpose-built for Home Assistant integration; standalone use requires familiarity with zigpy and radio adapter configuration. The permissive Apache 2.0 license poses no deployment concerns.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later.
- Intended primarily as a Home Assistant integration; standalone library use requires understanding of zigpy architecture and radio adapter setup.
- Low install friction with a pure-Python wheel distribution.
License · maintenance · safety
Apache-2.0 (permissive) — Released under Apache 2.0, a permissive license allowing commercial and private use with minimal restrictions—suitable for most deployment scenarios.
last release 2026-07-29 (16 days) · last repo commit 2026-08-12 · 94 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 76,446 downloads/mo, #14,624 on PyPI
Alternatives
Verify before relying
pip install zha
import zha
# ZHA is typically integrated into Home Assistant; direct library usage requires zigpy and radio-specific adapters (bellows, zigpy-znp, etc.)- Specific Zigbee device compatibility list and supported radio hardware models
- Performance characteristics under typical home automation loads
- Network scalability limits (number of devices, mesh depth)
- Integration requirements and API stability for non-Home Assistant use
What it is and what it does
ZHA is a Zigbee gateway library that abstracts hardware differences and provides a unified interface for managing Zigbee networks and devices. It sits between Home Assistant and various Zigbee radio adapters (bellows, zigpy-znp, zigpy-deconz, zigpy-xbee, zigpy-zigate, zigpy-ziggurat), allowing you to pair and control Zigbee-based home automation devices without being locked into a specific hardware gateway or proprietary bridge.
The package depends on zigpy as its core protocol layer and includes support for multiple radio types through separate adapter libraries. It handles device discovery, pairing, and network coordination over low-bandwidth Zigbee mesh networks. The library is actively maintained and designed to work within Home Assistant's ecosystem, though it can be used standalone if you understand the underlying zigpy architecture.
Use it for
- Replace a proprietary Zigbee hub with a software-based gateway on existing hardware
- Integrate diverse Zigbee devices (lights, switches, sensors) into a unified home automation network
- Support multiple Zigbee radio types on a single system without vendor lock-in
- Manage Zigbee device pairing, routing, and network topology in Home Assistant
- Build custom Zigbee applications on top of zigpy's protocol abstraction
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are using Home Assistant and need Zigbee device support.
The package is actively maintained, has no known vulnerabilities, and low install friction. It is purpose-built for Home Assistant integration; standalone use requires familiarity with zigpy and radio adapter configuration. The permissive Apache 2.0 license poses no deployment concerns.
Install
zha on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Active maintenance with a recent release (16 days old) and ongoing repository activity. Requires Python 3.12 or later.
Requires Python 3.12 or later. Intended primarily as a Home Assistant integration; standalone library use requires understanding of zigpy architecture and radio adapter setup.
License in practice
Released under Apache 2.0, a permissive license allowing commercial and private use with minimal restrictions—suitable for most deployment scenarios.
Quickstart
pip install zha
import zha
# ZHA is typically integrated into Home Assistant; direct library usage requires zigpy and radio-specific adapters (bellows, zigpy-znp, etc.)Verify before relying
- Specific Zigbee device compatibility list and supported radio hardware models
- Performance characteristics under typical home automation loads
- Network scalability limits (number of devices, mesh depth)
- Integration requirements and API stability for non-Home Assistant use
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 9 packagesattrsfrozendictbellowszigpy-znpzigpy-deconzzigpy-xbeezigpy-zigatezigpy-zigguratzigpy |
| Maintenance | Actively maintained 16 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 76,446 / month, #14,624 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: zha-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 gateway home automation”
- zhaZHA is a hardware-independent Zigbee gateway implementation that…
- pydeconzPython library that wraps the deCONZ REST API to communicate with…
- zigpy-znpAdds support for Texas Instruments ZNP Zigbee radio modules to the…
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 zigpy-znp · zha-quirks · zigpy · zigpy-xbee · zigpy-zigate · pydeconz · midea-local · bellows · zigpy-deconz · boschshcpy