heatmiser-neohub

heatmiser-neohub

Python client library and neohub CLI for the IMI Heatmiser NeoHub WebSocket API (port 4243), with LAN discovery via UDP hubseek (port 19790).

Guides

Quick start

Install from PyPI, then:

pip install heatmiser-neohub
cp .env.example .env   # set NEOHUB_TOKEN (host optional if one hub on LAN)
neohub discover
neohub live-data

import asyncio
from heatmiser_neohub import NeoHubClient

async def main() -> None:
    async with NeoHubClient(token="YOUR_TOKEN") as client:  # host auto-discovered
        live = await client.get_live_data()
        print(live.devices[0].zone_name, live.devices[0].actual_temp)

asyncio.run(main())

Reference (secondary)

These pages document the underlying NeoHub protocol. Most application code only needs the CLI or NeoHubClient.