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
Metadata
1 maintainer
Release files for aiohomematic-config 2026.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aiohomematic_config-2026.8.1.tar.gz | 28.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aiohomematic_config-2026.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 58.1 kB
Release files / aiohomematic_config-2026.8.1.tar.gz
| Download URL | aiohomematic_config-2026.8.1.tar.gz |
|---|---|
| Size | 28.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b3f6e6726a896c7a60afeee03d2787483733b877451d9b57f575ca12d4b1bb53
|
|
BLAKE2b-256 checksum How to use checksums |
2c4193a4e75d4cf408a37b279c0c5cc24e624ef55c134cdf84c2be1c029a3c3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 28, 2026.
Transparency logRelease files / aiohomematic_config-2026.8.1-py3-none-any.whl
| Download URL | aiohomematic_config-2026.8.1-py3-none-any.whl |
|---|---|
| Size | 29.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1020d8c0fd4d87c3ff21a42436dc6e7a7a05737f8d1f9aa01c61ee6537ca6866
|
|
BLAKE2b-256 checksum How to use checksums |
40d7055c9ed9316accedf52fc5bc335005837a23e02f947cc935be0171eb02e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 28, 2026.
Transparency log
