Zigbee Home Automation (ZHA)

ZHA is a versatile and hardware-independent Zigbee gateway implementation, designed to replace proprietary Zigbee gateways, bridges, hubs, and controllers. With ZHA, you can create a unified Zigbee network, allowing you to easily pair and connect a wide range of Zigbee-based devices for home automation and lighting.

Key Features

Hardware Independence: ZHA is not tied to any specific hardware, giving you the freedom to choose the Zigbee radio that best suits your needs.
Compatibility: ZHA supports a vast array of Zigbee-based devices, ensuring seamless integration with popular home automation and lighting solutions.
Unified Zigbee Network: By utilizing ZHA, you can establish a single Zigbee network, simplifying device management and enhancing interoperability.
Low-Bandwidth Communication: Zigbee operates on a low-bandwidth communication protocol, utilizing small, low-power digital radios to connect devices within local Zigbee wireless private area networks.

Getting Started With Development

To bootstrap a development environment for ZHA, follow these steps:

Clone the project from the zigpy organization:

git clone https://github.com/zigpy/zha.git

Navigate to the script directory:
```
cd zha/script
```
Run the setup script to install the necessary dependencies:
```
./setup
```
The setup script sets up a virtual environment, installs necessary packages and dependencies, and configures pre-commit hooks for the project. It helps ensure a consistent and controlled development environment for the project, saving you time and effort.
Script Overview

The setup script in the zha/script directory performs the following actions:
- curl -LsSf https://astral.sh/uv/install.sh | sh: This command uses curl to download a shell script from the specified URL (https://astral.sh/uv/install.sh) and then pipes it to the sh command to execute it. This script is responsible for installing a tool called "uv" (short for "universal virtualenv") which helps manage Python virtual environments.
- uv venv venv: This command uses the "uv" tool to create a new Python virtual environment named "venv" in the current directory. A virtual environment is an isolated Python environment that allows you to install packages and dependencies specific to your project without affecting the global Python installation.
- . venv/bin/activate: This command activates the newly created virtual environment. When a virtual environment is activated, any subsequent Python-related commands will use the Python interpreter and packages installed within that environment.
- uv pip install -U pip setuptools pre-commit: This command uses the "uv" tool to upgrade the "pip" package manager, as well as install or upgrade the "setuptools" and "pre-commit" packages. "pip" is the default package manager for Python, "setuptools" is a library that facilitates packaging Python projects, and "pre-commit" is a tool for managing and enforcing pre-commit hooks in a Git repository.
- uv pip install -r requirements_test.txt: This command uses the "uv" tool to install the Python packages listed in the "requirements_test.txt" file. This file typically contains a list of dependencies required for running tests in the project.
- uv pip install -e .: This command uses the "uv" tool to install the project itself in editable mode. The dot (.) represents the current directory, so this command installs the project as a package in the virtual environment.
- pre-commit install: This command installs Git pre-commit hooks for the project. Pre-commit hooks are scripts that run before each commit is made in a Git repository, allowing you to enforce certain checks or actions before committing changes.
If creating new entities or modifying existing ones, unit tests that use device diagnostic files will fail. You can regenerate existing device diagnostic JSON files to incorporate the new entities:
```
python -m tools.regenerate_diagnostics
```

License

ZHA is released under the Apache 2.0 License. Please refer to the LICENSE file for more details

Release files for zha 2.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zha 2.2.1
File	Size	Uploaded
zha-2.2.1.tar.gz	273.7 kB	Sep 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for zha 2.2.1
File	Interpreter	ABI	Platform	Reset
zha-2.2.1-py3-none-any.whl 204.1 kB Sep 2, 2026	Python 3	none	any	Details

Total release size: 477.8 kB

Release files / zha-2.2.1.tar.gz

Download URL	zha-2.2.1.tar.gz
Size	273.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a8b9998adf1039cc42744dde7cd4139bb371d751c60945128ff4a9862454bfc5`
BLAKE2b-256 checksum How to use checksums	`bb35efc65e1f6eafe38c43eb694a3d666d7ed9d14a4c63758437266e4c62f9fa`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / zha-2.2.1-py3-none-any.whl

Download URL	zha-2.2.1-py3-none-any.whl
Size	204.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c11637654b8d817c8a22267145c55018d51b545d509d7533ef7f6226938c29c8`
BLAKE2b-256 checksum How to use checksums	`8aa362a560ce18cd6c89814e11498c98baf560bfe319ed0519645fddc45d197c`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`