pypck

What it is and what it does

pypck is a Python async library that implements the LCN-PCK protocol to communicate with LCN (local control network) systems—a vendor-specific home automation platform. It abstracts the low-level protocol details into a connection manager and device objects, allowing you to control LCN modules (switches, dimmers, sensors) over a network connection. The library is actively maintained and used by Home Assistant's LCN integration.

To use pypck, you need an LCN-PCHK coupling software license and a hardware coupler device. The library provides async/await patterns for non-blocking control operations, making it suitable for integration into event-driven home automation systems. It has no external runtime dependencies beyond Python itself, keeping deployment simple.

Use it for:

• Integrate LCN home automation systems into Home Assistant or other Python-based home automation platforms
• Build custom control applications to remotely switch and dim LCN module outputs over the network
• Monitor and control LCN sensors and actuators from a Python application without blocking on I/O
• Automate lighting, heating, or other LCN-controlled devices via async event handlers

Worth the install?

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

pypck is an asynchronous Python library for connecting to LCN (local control network) systems using the LCN-PCK protocol, enabling remote control of LCN modules.

Yes, if you own or manage an LCN system and need Python-based control. The library is actively maintained, has no external dependencies, and is proven in production use via Home Assistant. Requires Python 3.13+, an LCN-PCHK license, and a hardware coupler—verify those prerequisites before installing.

Install

pypck on PyPI

pip install pypck

uv add pypck

poetry add pypck

Installing pypck

Before you install

Low install friction; pure Python wheel with no runtime dependencies. Active maintenance with recent release (44 days ago) and ongoing repository activity.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both commercial and open-source projects.

Quickstart

pip install pypck

import asyncio
from pypck.connection import PchkConnectionManager
from pypck.lcn_addr import LcnAddr

async def main():
    async with PchkConnectionManager("192.168.2.41", 4114, username="lcn", password="lcn") as pck_client:
        module = pck_client.get_device_connection(LcnAddr(0, 10, False))
        await module.dim_output(0, 100, 0)

asyncio.run(main())

Requires Python 3.13+; also requires an LCN-PCHK coupling software license and hardware coupler to connect to an actual LCN system.

Verify before relying

• Whether the LCN-PCHK coupling software license and hardware coupler are freely available or require separate purchase
• Performance characteristics and scalability limits for controlling large numbers of LCN modules
• Whether the library supports all LCN-PCK protocol versions or specific versions only

Package facts

Evidence: pypck-0.9.14-py3-none-any.whl

Keywords: lcn, pck

Tags

More Home Automation packages