# AIO Homematic (hahomematic)
A lightweight Python 3 library that powers Home Assistant integrations for controlling and monitoring [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](https://www.homematic-ip.com/en/start.html) devices. Some third‑party devices/gateways (e.g., Bosch, Intertechno) may be supported as well.
This project is the modern successor to [pyhomematic](https://github.com/danielperna84/pyhomematic), focusing on automatic entity creation, fewer manual device definitions, and faster startups.
## How it works
Unlike pyhomematic, which required manual device mappings, aiohomematic automatically creates entities for each relevant parameter on every device channel (unless blacklisted). To achieve this it:
- Fetches and caches device paramsets (VALUES) for fast successive startups.
- Provides hooks for custom entity classes where complex behavior is needed (e.g., thermostats, lights, covers, climate, locks, sirens).
- Includes helpers for robust operation, such as automatic reconnection after CCU restarts.
## Key features
- Automatic entity discovery from device/channel parameters.
- Extensible via custom entity classes for complex devices.
- Caching of paramsets to speed up restarts.
- Designed to integrate with Home Assistant.
## Installation (with Home Assistant)
Install via the custom component: [Homematic(IP) Local](https://github.com/sukramj/homematicip_local).
Follow the installation guide: https://github.com/sukramj/homematicip_local/wiki/Installation
## Requirements
Due to a bug in earlier CCU2/CCU3 firmware, aiohomematic requires at least the following versions when used with HomematicIP devices:
- CCU2: 2.53.27
- CCU3: 3.53.26
See details here: https://github.com/jens-maus/RaspberryMatic/issues/843. Other CCU‑like platforms using the buggy HmIPServer version are not supported.
## Useful links
- Examples: see example.py in this repository.
- Changelog: see changelog.md.
- Source code and documentation: this repository (docs/ directory may contain additional information).
Raw data
{
"_id": null,
"home_page": "https://github.com/sukramj/aiohomematic",
"name": "aiohomematic",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13.0",
"maintainer_email": null,
"keywords": "home, automation, homematic",
"author": null,
"author_email": "SukramJ <sukramj@icloud.com>, Daniel Perna <danielperna84@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c4/f0/b068781a2166b63a3d4ca5c0734593377ccbed8c2e9bc4ea571ce1b6f0aa/aiohomematic-2025.8.9.tar.gz",
"platform": null,
"description": "# AIO Homematic (hahomematic)\n\nA lightweight Python 3 library that powers Home Assistant integrations for controlling and monitoring [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](https://www.homematic-ip.com/en/start.html) devices. Some third\u2011party devices/gateways (e.g., Bosch, Intertechno) may be supported as well.\n\nThis project is the modern successor to [pyhomematic](https://github.com/danielperna84/pyhomematic), focusing on automatic entity creation, fewer manual device definitions, and faster startups.\n\n## How it works\n\nUnlike pyhomematic, which required manual device mappings, aiohomematic automatically creates entities for each relevant parameter on every device channel (unless blacklisted). To achieve this it:\n\n- Fetches and caches device paramsets (VALUES) for fast successive startups.\n- Provides hooks for custom entity classes where complex behavior is needed (e.g., thermostats, lights, covers, climate, locks, sirens).\n- Includes helpers for robust operation, such as automatic reconnection after CCU restarts.\n\n## Key features\n\n- Automatic entity discovery from device/channel parameters.\n- Extensible via custom entity classes for complex devices.\n- Caching of paramsets to speed up restarts.\n- Designed to integrate with Home Assistant.\n\n## Installation (with Home Assistant)\n\nInstall via the custom component: [Homematic(IP) Local](https://github.com/sukramj/homematicip_local).\n\nFollow the installation guide: https://github.com/sukramj/homematicip_local/wiki/Installation\n\n## Requirements\n\nDue to a bug in earlier CCU2/CCU3 firmware, aiohomematic requires at least the following versions when used with HomematicIP devices:\n\n- CCU2: 2.53.27\n- CCU3: 3.53.26\n\nSee details here: https://github.com/jens-maus/RaspberryMatic/issues/843. Other CCU\u2011like platforms using the buggy HmIPServer version are not supported.\n\n## Useful links\n\n- Examples: see example.py in this repository.\n- Changelog: see changelog.md.\n- Source code and documentation: this repository (docs/ directory may contain additional information).\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Homematic interface for Home Assistant running on Python 3.",
"version": "2025.8.9",
"project_urls": {
"Bug Reports": "https://github.com/sukramj/aiohomematic/issues",
"Docs: Dev": "https://github.com/sukramj/aiohomematic",
"Forum": "https://github.com/sukramj/aiohomematic/discussions",
"Homepage": "https://github.com/sukramj/aiohomematic",
"Source Code": "https://github.com/sukramj/aiohomematic"
},
"split_keywords": [
"home",
" automation",
" homematic"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ba0863ef84cef6d1f77272fb3b998480e6daa4b37d5134a75e16d621463771e9",
"md5": "b9dd3e0289a6e1543daee7d2e8f9d69f",
"sha256": "aeeab22b5b842365dad603a83519250ebb713c6469f3d01ac35796fa2b5ea6c4"
},
"downloads": -1,
"filename": "aiohomematic-2025.8.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b9dd3e0289a6e1543daee7d2e8f9d69f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13.0",
"size": 198885,
"upload_time": "2025-08-24T16:41:37",
"upload_time_iso_8601": "2025-08-24T16:41:37.703854Z",
"url": "https://files.pythonhosted.org/packages/ba/08/63ef84cef6d1f77272fb3b998480e6daa4b37d5134a75e16d621463771e9/aiohomematic-2025.8.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c4f0b068781a2166b63a3d4ca5c0734593377ccbed8c2e9bc4ea571ce1b6f0aa",
"md5": "729a7bc591f153bc9aec84efcbe200ed",
"sha256": "24b1950b9fbfd5f1a7920991cada8d5d54714a12017a4be1e7cb06d914b8c21f"
},
"downloads": -1,
"filename": "aiohomematic-2025.8.9.tar.gz",
"has_sig": false,
"md5_digest": "729a7bc591f153bc9aec84efcbe200ed",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13.0",
"size": 198645,
"upload_time": "2025-08-24T16:41:39",
"upload_time_iso_8601": "2025-08-24T16:41:39.716831Z",
"url": "https://files.pythonhosted.org/packages/c4/f0/b068781a2166b63a3d4ca5c0734593377ccbed8c2e9bc4ea571ce1b6f0aa/aiohomematic-2025.8.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-24 16:41:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sukramj",
"github_project": "aiohomematic",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "aiohttp",
"specs": [
[
">=",
"3.12.15"
]
]
},
{
"name": "orjson",
"specs": [
[
">=",
"3.11.2"
]
]
},
{
"name": "python-slugify",
"specs": [
[
">=",
"8.0.4"
]
]
},
{
"name": "voluptuous",
"specs": [
[
">=",
"0.15.2"
]
]
}
],
"lcname": "aiohomematic"
}
JSON
