Skip to main content

KEBA KeEnergy API

A Python wrapper for the KEBA KeEnergy API used by the Web HMI.

Note: This is an unofficial community project. It is not affiliated with, endorsed by or supported by KEBA. For support, open an issue, do not contact KEBA.

coverage-badge

CI Typing: strict Code style: Ruff

Getting started​

pip install keba-keenergy-api
import asyncio

from keba_keenergy_api import KebaKeEnergyAPI


async def main():
async with KebaKeEnergyAPI(
host="ap4400.local", username="test", password="test", ssl=True, skip_ssl_verification=True
) as client:
print(await client.system.get_outdoor_temperature())


asyncio.run(main())

See Usage for reading and writing multiple values and sharing a session.

⚠️ Write warnings​

This is a low-level API that allows writing values outside the safe operating range. Improper use can damage heating systems and hardware. Always check the attributes for minimum and maximum values, and write values only as often as the Web HMI would, as frequent writes wear out the built-in flash memory. Use at your own risk! Read the full write warnings before writing values.

KEBAKEBALatest version on PyPI

An asynchronous Python client for the KEBA KeEnergy Web HMI, used by the Home Assistant integration.

A community project, not affiliated with or endorsed by KEBA. KEBA is a registered trademark of its owner.

Requires Python 3.11 or newer.

View source on GitHub
View known issues
Request a feature
View on PyPI
Changelog

Maintainer

@mh-superbox

On this page