{"id":23861,"library":"home-assistant-chip-clusters","title":"Home Assistant CHIP Clusters","description":"Python bindings for CHIP (Connected Home over IP) clusters, auto-generated from the CHIP specification. Version 2025.7.0 requires Python >=3.7 and provides cluster objects for interacting with Matter devices. Released monthly alongside the CHIP SDK.","status":"active","version":"2025.7.0","language":"python","source_language":"en","source_url":"https://github.com/project-chip/connectedhomeip","tags":["matter","chip","cluster","home-assistant","smarthome"],"install":[{"cmd":"pip install home-assistant-chip-clusters","lang":"bash","label":"pip install"}],"dependencies":[{"reason":"Core CHIP library providing low-level API","package":"chip-core","optional":true}],"imports":[{"note":"The package is installed as 'chip-clusters' but the import is from 'chip.clusters'.","wrong":"import home_assistant_chip_clusters","symbol":"Clusters","correct":"from chip.clusters import Clusters"},{"note":"The Objects module is nested under chip.clusters.","wrong":"from chip import Clusters","symbol":"Objects","correct":"from chip.clusters import Objects"}],"quickstart":{"code":"from chip.clusters import Clusters, Objects\ncluster = Clusters.OnOff()\nprint(cluster.cluster_id)  # 6","lang":"python","description":"Create a cluster instance and access its attributes."},"warnings":[{"fix":"Use 'from chip.clusters import ...' in your code.","message":"The package name on PyPI is 'home-assistant-chip-clusters' but the import path is 'chip.clusters' (not 'home_assistant_chip_clusters').","severity":"gotcha","affected_versions":"all"},{"fix":"Use Clusters.OnOff.attributes.OnOff.attribute_id instead of integer literals.","message":"In v2025.7.0 some cluster attribute IDs may have changed due to spec updates. Rely on the Attributes object rather than hardcoded IDs.","severity":"breaking","affected_versions":">=2025.0.0"},{"fix":"Do not modify files under site-packages/chip/clusters/. Fork or patch via hooks.","message":"The 'Clusters' module is generated automatically; manual editing of cluster definitions is overwritten on pip upgrade.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Change import to 'from chip.clusters import ...'.","cause":"Wrong import path; the package is installed as 'chip-clusters' but imported as 'chip.clusters'.","error":"ModuleNotFoundError: No module named 'home_assistant_chip_clusters'"},{"fix":"Run 'pip install home-assistant-chip-clusters' again and ensure you use 'from chip.clusters import ...'.","cause":"The required subpackages were not installed or the import fails because 'chip' is not a namespace package.","error":"AttributeError: module 'chip' has no attribute 'clusters'"},{"fix":"Use 'from chip.clusters import Clusters'.","cause":"Trying to import 'Clusters' directly from the top-level 'chip' module instead of 'chip.clusters'.","error":"ImportError: cannot import name 'Clusters' from 'chip'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}