zha-quirks
Library implementing Zigpy quirks for ZHA in Home Assistant
Decision gist · record as of 2026-08-14
Yes, if you are running Home Assistant with ZHA and have non-standard Zigbee devices. The package is actively maintained, has no known vulnerabilities, and uses a permissive license. Install friction is low. If you are not using Home Assistant or ZHA, this package is not applicable.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later.
- Intended for use within Home Assistant's ZHA component, not as a standalone library.
- Low install friction with a pure Python wheel.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.
last release 2026-07-29 (16 days) · last repo commit 2026-08-12 · 1,125 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 338,468 downloads/mo, #7,432 on PyPI
Alternatives
Verify before relying
pip install zha-quirks
from zha_quirks import get_quirked_device
# Used internally by ZHA integration in Home Assistant- Whether the package is intended for direct end-user installation or primarily for Home Assistant maintainers and contributors.
- The scope and number of device handlers currently included in version 2.2.0.
- Whether custom quirks can be added or extended by end users without modifying the package itself.
What it is and what it does
zha-quirks is a library of custom device handlers for the Zigpy Zigbee library, designed to make non-standard Zigbee devices work correctly with Home Assistant's ZHA component. Many Zigbee devices deviate from the Zigbee Cluster Library specification, and this package bridges that gap by implementing device-specific quirks that parse custom messages and handle manufacturer deviations.
The package works by defining virtual representations of physical Zigbee devices (light bulbs, switches, sensors, etc.) that expose functionality not provided out-of-the-box. It handles endpoints, clusters, and descriptors according to Zigbee specifications, allowing Home Assistant to correctly communicate with devices that would otherwise be incompatible or non-functional. The package is actively maintained and includes support for common manufacturers like Tuya.
Use it for
- Enable non-standard Zigbee light bulbs or switches to work with Home Assistant's ZHA integration.
- Add support for Tuya Zigbee devices that use custom manufacturer-specific clusters.
- Handle Zigbee devices that do not fully conform to the ZCL specification.
- Extend Home Assistant's Zigbee device compatibility without modifying the core ZHA component.
- Contribute new device handlers for previously unsupported Zigbee devices.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are running Home Assistant with ZHA and have non-standard Zigbee devices.
The package is actively maintained, has no known vulnerabilities, and uses a permissive license. Install friction is low. If you are not using Home Assistant or ZHA, this package is not applicable.
Install
zha-quirks on PyPI
Before you install
Low install friction with a pure Python wheel. The package is actively maintained with a recent release and steady commit activity. Requires Python 3.12 or later.
Requires Python 3.12 or later. Intended for use within Home Assistant's ZHA component, not as a standalone library.
License in practice
Licensed under Apache-2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.
Quickstart
pip install zha-quirks
from zha_quirks import get_quirked_device
# Used internally by ZHA integration in Home AssistantVerify before relying
- Whether the package is intended for direct end-user installation or primarily for Home Assistant maintainers and contributors.
- The scope and number of device handlers currently included in version 2.2.0.
- Whether custom quirks can be added or extended by end users without modifying the package itself.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packageszigpyzha |
| Maintenance | Actively maintained 16 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 338,468 / month, #7,432 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: zha_quirks-2.2.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 device handlers home assistant”
- zha-quirksProvides custom device handlers (quirks) for non-standard Zigbee…
- zhaZHA is a hardware-independent Zigbee gateway implementation that…
- pydeconzPython library that wraps the deCONZ REST API to communicate with…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also zigpy-znp · zha · zigpy-zigate · zigpy-xbee · zigpy · bellows · tinytuya · pydeconz · home-assistant-chip-core · home-assistant-chip-clusters