pyhems 0.2.0

ECHONET Lite library for Home Energy Management System (HEMS)

pyhems

ECHONET Lite library for Home Energy Management System (HEMS).

🇯🇵 日本語ドキュメント

Features

• ECHONET Lite frame encoding/decoding
• UDP multicast device discovery
• Async runtime client with event subscription
• Entity definitions based on MRA data
• Full type hints (py.typed)

Requirements

• Python 3.13+
• bidict>=0.23.0

License

MIT License

Installation

pip install pyhems

Quick Start

import asyncio
from pyhems.runtime import HemsClient, HemsInstanceListEvent

async def main():
    client = HemsClient(interface="0.0.0.0")
    await client.start()

    def on_event(event):
        if isinstance(event, HemsInstanceListEvent):
            print(f"Node: {event.node_id}, Instances: {event.instances}")

    unsubscribe = client.subscribe(on_event)
    await asyncio.sleep(60)
    unsubscribe()
    await client.stop()

asyncio.run(main())