aiohomematic-config
Presentation-layer library for Homematic device configuration UI.
Transforms Homematic device paramset descriptions into UI-optimized structures. No RPC knowledge, no CCU access -- operates purely on data structures from aiohomematic.
Installation
pip install aiohomematic-config
Quick Start
from aiohomematic_config import FormSchemaGenerator
generator = FormSchemaGenerator(locale="en")
schema = generator.generate(
descriptions=descriptions,
current_values=current_values,
channel_type="HEATING_CLIMATECONTROL_TRANSCEIVER",
)
# schema is a Pydantic model, JSON-serializable
print(schema.model_dump_json(indent=2))
Key Components
| Component | Purpose |
|---|---|
FormSchemaGenerator |
ParameterData + values -> JSON form schemas |
ParameterGrouper |
Flat parameter list -> grouped sections |
LabelResolver |
Technical parameter IDs -> human-readable labels |
ConfigSession |
Change tracking, undo/redo, dirty state |
ConfigExporter |
Serialize/deserialize device configurations |
WidgetType mapping |
ParameterType -> appropriate UI widget |
Development
Parts of aiohomematic-config are developed with agentic AI assistance, primarily Claude Code. Incoming issues are also triaged and analysed with agentic help. Every change is still reviewed by a human maintainer and must pass the project's test suite before it lands -- the AI speeds up the work, it does not replace the review gate.
For the rules that apply to AI-assisted contributions, see the AI Contribution Policy.
License
MIT License - see LICENSE for details.
Acknowledgments
This library builds on the data structures of aiohomematic and the wider Homematic Python ecosystem. Special thanks to Daniel Perna, whose original work on pyhomematic and hahomematic laid the foundation for this ecosystem.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aiohomematic_config-2026.8.0.tar.gz.
File metadata
- Download URL: aiohomematic_config-2026.8.0.tar.gz
- Upload date:
- Size: 28.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a182fc0f33a1be0c733b0863754d1737f19ee5675c8288298c89d1b933fafc07
|
|
| MD5 |
1c5031dca2d7cbd958cf70380a9b7c72
|
|
| BLAKE2b-256 |
6dcce5d434d0a0d848cc0eddd7957e212b9eb4f36e2a32027915d3a1ac58895f
|
Provenance
The following attestation bundles were made for aiohomematic_config-2026.8.0.tar.gz:
Publisher:
python-publish.yml on SukramJ/aiohomematic-config
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aiohomematic_config-2026.8.0.tar.gz -
Subject digest:
a182fc0f33a1be0c733b0863754d1737f19ee5675c8288298c89d1b933fafc07 - Sigstore transparency entry: 2313555477
- Sigstore integration time:
-
Permalink:
SukramJ/aiohomematic-config@aa4b6d6c06fa1ec45d5ad00b24d466a7e1575ef9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SukramJ
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@aa4b6d6c06fa1ec45d5ad00b24d466a7e1575ef9 -
Trigger Event:
repository_dispatch
-
Statement type:
File details
Details for the file aiohomematic_config-2026.8.0-py3-none-any.whl.
File metadata
- Download URL: aiohomematic_config-2026.8.0-py3-none-any.whl
- Upload date:
- Size: 29.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba13a0f4f13872c9388ca350ab0208364720753f235bb6d4d100872a19a830fd
|
|
| MD5 |
cfc90cde18031108de897ac972959789
|
|
| BLAKE2b-256 |
7cff4d0c6994b120861ec71fa8e2a15e2c8d0d1de097daa9e23d2cc593698b67
|
Provenance
The following attestation bundles were made for aiohomematic_config-2026.8.0-py3-none-any.whl:
Publisher:
python-publish.yml on SukramJ/aiohomematic-config
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aiohomematic_config-2026.8.0-py3-none-any.whl -
Subject digest:
ba13a0f4f13872c9388ca350ab0208364720753f235bb6d4d100872a19a830fd - Sigstore transparency entry: 2313555498
- Sigstore integration time:
-
Permalink:
SukramJ/aiohomematic-config@aa4b6d6c06fa1ec45d5ad00b24d466a7e1575ef9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SukramJ
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@aa4b6d6c06fa1ec45d5ad00b24d466a7e1575ef9 -
Trigger Event:
repository_dispatch
-
Statement type:
