Skip to main content

aiohomematic-config

CI codecov PyPI

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.

Metadata

Release files for aiohomematic-config 2026.11.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aiohomematic-config 2026.11.1
File Size Uploaded Provenance Actions
aiohomematic_config-2026.11.1.tar.gz 28.7 kB With provenance Details for aiohomematic_config-2026.11.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aiohomematic-config 2026.11.1
File Interpreter ABI Platform Actions
aiohomematic_config-2026.11.1-py3-none-any.whl Python 3 none any Details for aiohomematic_config-2026.11.1-py3-none-any.whl

Total release size: 58.0 kB

Release files / aiohomematic_config-2026.11.1.tar.gz

Download URL aiohomematic_config-2026.11.1.tar.gz
Size 28.7 kB
Tags Source
SHA-256 checksum
How to use checksums
25708ceed727def3b84b9479e574426c24a652d57d8964b3ace8ab7c4bd33f86
BLAKE2b-256 checksum
How to use checksums
9947970564d0adb71de843cda6d3e40d11af7e4dd3329ae6c1706891758c1d8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 5, 2026.

Transparency log

Release files / aiohomematic_config-2026.11.1-py3-none-any.whl

Download URL aiohomematic_config-2026.11.1-py3-none-any.whl
Size 29.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
39f8b3b47157984b91b280e25b9c299a6395d4fa24d717e78f8010f1de325eb8
BLAKE2b-256 checksum
How to use checksums
07fe7859698dc70f8d70cf66d49192d4dc7c64ef1af568f75b0db33d5f324e1e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 5, 2026.

Transparency log

Security for aiohomematic-config 2026.11.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aiohomematic_config-2026.11.1.tar.gz

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 Nov 5, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page