---
id: openccu-loom-client
version: "2026.8.12"
license: MIT
license_treatment: permissive
maintenance: active
---

# openccu-loom-client — Async Python REST + WebSocket client for the openccu-loom daemon

License: permissive · Maintenance: active · Downloads: 257.0K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: capped_below_current
- Install friction: low
- Maintenance: active
- Downloads: 257.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

homematic ccu client library, openccu-loom daemon client, async rest websocket ccu, home assistant homematic backend, homematicip local alternative, ccu device control python, homematic data point access, homematic-ccu, home-assistant-backend, async-websocket

[View on SkillFed](https://skillfed.io/packages/openccu-loom-client) · [View on PyPI](https://pypi.org/project/openccu-loom-client/)