openccu-loom-client

What it is and what it does

openccu-loom-client is an async Python client library that bridges Home Assistant to HomeMatic CCU devices through the openccu-loom daemon instead of direct XML-RPC/JSON-RPC. It wraps the daemon's full REST API surface and WebSocket event stream with Pydantic-typed models, providing both high-level facades (device/datapoint/schedule management) and low-level operation modules (auth, diagnostics, backups, system control). The package includes a compatibility shim that lets existing homematicip_local Home Assistant imports work unchanged during migration, reusing aiohomematic's routing and protocol logic while routing all CCU contact through the daemon.

The library handles transport concerns (HTTP retry/backoff, RFC 9457 problem+json parsing, WebSocket reconnection with cursor-based resume) and maintains an in-memory event bus and data store. It ships with typed models for all push-event payloads (DataPointValueChanged, CustomDataPointStateChanged, CentralStateChanged, etc.) and wraps daemon operations across devices, channels, data points, programs, sysvars, schedules, links, firmware, climate profiles, and system maintenance.

Use it for:

• Migrate a Home Assistant homematicip_local setup from direct CCU contact to daemon-mediated access without changing existing automations.
• Build custom Python automation or monitoring tools that query CCU device state, trigger programs, or manage sysvars through a typed async API.
• Implement real-time event handling for device state changes, trigger/keypress events, and optimistic rollback notifications from a CCU.
• Manage CCU administration tasks (user provisioning, config backups, firmware updates, diagnostics) programmatically via admin modules.
• Develop a Matter bridge or custom Home Assistant component that needs reliable, resumable WebSocket event streaming from a CCU.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Async Python REST and WebSocket client for the openccu-loom daemon, providing typed access to CCU devices, data points, and system operations through an alternative backend for Home Assistant integration.

Yes, with conditions. Install if you are running openccu-loom daemon and need a typed async client for Home Assistant integration or custom CCU automation — low install friction, active maintenance, no known vulnerabilities, and MIT licensing are all favorable. Do not install if you require Python below 3.14 or if you need stable (non-Alpha) APIs; the package is functional but explicitly marked WIP and may see breaking changes.

Install

openccu-loom-client on PyPI

pip install openccu-loom-client

uv add openccu-loom-client

poetry add openccu-loom-client

Installing openccu-loom-client

Before you install

Low friction: pure-Python wheel with five runtime dependencies (aiohomematic, aiohttp, openccu-loom-types, pydantic, python-slugify). Active maintenance with a release 2 days old. Requires Python 3.14 or later.

License in practice

MIT permissive license means you can use, modify, and redistribute freely with minimal restrictions — suitable for both proprietary and open-source projects.

Quickstart

pip install openccu-loom-client

from openccu_loom_client import LoomClient

client = LoomClient(base_url='http://example.com')
await client.bootstrap()
devices = await client.devices.get_all()

Requires Python 3.14 or later; requires a running openccu-loom daemon instance.

Verify before relying

• Stability guarantees and expected timeline for moving out of Alpha status.
• Performance characteristics under high-frequency event loads or large device counts.
• Compatibility matrix with specific Home Assistant versions and homematicip_local custom component releases.
• Whether the daemon must be running on localhost or can be accessed remotely.

Package facts

Evidence: openccu_loom_client-2026.8.12-py3-none-any.whl

Tags

More Home Automation packages