https://github.com/superbox-dev/keba_keenergy
A Home Assistant integration for heat pumps with a KEBA KeEnergy control system.
https://github.com/superbox-dev/keba_keenergy
bartl custom-integration hacs hacs-integration hass hautec home-assistant home-assistant-integration homeassistant ino keba keba-keenergy keenergy m-tec windhager
Last synced: about 1 month ago
JSON representation
A Home Assistant integration for heat pumps with a KEBA KeEnergy control system.
- Host: GitHub
- URL: https://github.com/superbox-dev/keba_keenergy
- Owner: superbox-dev
- License: apache-2.0
- Created: 2025-07-05T11:32:20.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-04-23T06:10:41.000Z (about 2 months ago)
- Last Synced: 2026-04-23T07:26:14.987Z (about 2 months ago)
- Topics: bartl, custom-integration, hacs, hacs-integration, hass, hautec, home-assistant, home-assistant-integration, homeassistant, ino, keba, keba-keenergy, keenergy, m-tec, windhager
- Language: Python
- Homepage:
- Size: 5.36 MB
- Stars: 12
- Watchers: 4
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# KEBA KeEnergy – Home Assistant Integration for KEBA heat pumps
**KEBA KeEnergy Integration** is a powerful custom **Home Assistant integration** that allows you to connect
and monitor KEBA-based heat pumps directly within your smart home. The integration exposes data from the KEBA KeEnergy
web interface as Home Assistant entities for monitoring, control, and automation of heating and hot water systems.
[](docs/assets/dashboard.png)
> Take a look at the [example page][wiki-examples] in the Wiki to create awesome dashboards in Home Assistant.
[wiki-examples]: https://superbox.one/keba-keenergy/home-assistant/wiki/examples/
## With the KEBA KeEnergy Home Assistant Integration, you can
* Connects to your **KEBA heat pump** via the KeEnergy Web HMI API using host and port
* Monitor temperatures, operating states and system settings
* Control operating modes and parameters directly from Home Assistant
* Build automations based on heating demand, energy usage or schedules
* This turns your heat pump into a fully integrated smart-home component
## Features
* Automatic discovery of KEBA KeEnergy-based systems
* Compatible with multiple KEBA-controlled heat pumps
* Works as a Home Assistant custom integration (HACS supported)
* Provides a full set of entities – sensors, binary sensors, number and select entities for:
* Heat pump
* Heating circuit
* Solar circuit
* Hot water tank
* Buffer tank
* External heat source
> Looking for more information? The [Wiki][wiki-supported-devices] contains in-depth documentation.
## Supported systems
The KEBA KeEnergy Integration works with heat pumps that provide a KEBA KeEnergy Web HMI interface. It is successfully
used with devices from [manufacturers][wiki-supported-devices] such as M-TEC, Windhager and ino,
as well as other systems based on KEBA controls.
[wiki-supported-devices]: https://superbox.one/keba-keenergy/home-assistant/wiki/supported-devices/
## Requirements
* A running instance of Home Assistant with [HACS](https://hacs.xyz/) installed for managing custom integrations.
* Network connectivity from the Home Assistant host to the KEBA heat pump’s Web HMI interface,
including proper host/IP and port access.
## Getting started
[][redirect-hacs]
1. Install this integration with HACS (search for "KEBA KeEnergy") or copy the contents of this repository into the
`custom_components/keba_keenergy` directory.
2. Restart Home Assistant after installation completes.
3. Start the configuration flow: go to `Configuration` -> `Integrations`, click the `+ Add Integration` and select
`KEBA KeEnergy` from the list.
4. Add IP address or hostname of your KEBA KeEnergy device.
5. Read the [FAQ](https://superbox.one/keba-keenergy/home-assistant/wiki/faq/) and enjoy :-)
[redirect-hacs]: https://my.home-assistant.io/redirect/hacs_repository/?owner=mh-superbox&repository=keba_keenergy&category=integration
## Donation
I put a lot of time into this project. If you like it, you can support me with a donation.
[][kofi]
[kofi]: https://ko-fi.com/F2F0KXO6D
## Related projects
* [KEBA KeEnergy API](https://github.com/superbox-dev/keba_keenergy_api) is a Python wrapper for the KEBA KeEnergy API.
* [Lovelace Mini Graph Card](https://github.com/kalkih/mini-graph-card) is a minimalistic graph card for
Home Assistant Lovelace UI
## Changelog
The changelog lives in the [CHANGELOG.md](CHANGELOG.md) document.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## Get Involved
The **KEBA KeEnergy Integration** is an open-source project and contributions are welcome. You can:
* Report [issues](https://github.com/superbox-dev/keba_keenergy/issues/new/choose) or request new features
* Improve documentation or translations
* Contribute code
* Support the project by starring it on GitHub ⭐
I'm happy about your contributions to the project!
You can get started by reading the [CONTRIBUTING.md](CONTRIBUTING.md).
[][workflow-ci]
![Typing: strict][typing-strict]
![Code style: black][code-black]
![Code style: Ruff][code-ruff]
[workflow-ci]: https://github.com/superbox-dev/keba_keenergy/actions/workflows/ci.yml
[typing-strict]: https://img.shields.io/badge/typing-strict-green.svg
[code-black]: https://img.shields.io/badge/code%20style-black-black
[code-ruff]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json