openccu-loom-client
Async Python REST + WebSocket client for the openccu-loom daemon
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.14 or later; requires a running openccu-loom daemon instance.
- 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.
License · maintenance · safety
MIT (permissive) — MIT permissive license means you can use, modify, and redistribute freely with minimal restrictions — suitable for both proprietary and open-source projects.
last release 2026-08-12 (2 days) · last repo commit 2026-08-12
0 known vulnerabilities (OSV.dev, 2026-08-14) · 257,011 downloads/mo, #8,451 on PyPI
Alternatives
Verify before relying
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()- 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.
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 on it.
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
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.
Requires Python 3.14 or later; requires a running openccu-loom daemon instance.
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()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 the current Python release >=3.14 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesaiohomematicaiohttpopenccu-loom-typespydanticpython-slugify |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 257,011 / month, #8,451 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaFramework :: AsyncIOLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.14Topic :: Home AutomationTyping :: Typed |
Evidence: openccu_loom_client-2026.8.12-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “homematic ccu client library”
- openccu-loom-clientAsync Python REST and WebSocket client for the openccu-loom daemon,…
- aiohomematicAn async Python library for controlling and monitoring Homematic and…
- openccu-dataExtracts and distributes Homematic CCU configuration metadata…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also openccu-data · openccu-loom-types · aiohomekit · py-unifi-access · aiohomematic-config · ha-ffmpeg · clamav-client · homematicip · aiohasupervisor