# hestia: replacing the Keemple smart-home cloud

> hestia reimplements the Keemple gateway's cleartext 0x7e-framed protocol for local smart-home control. A specification derived from observed LAN traffic covers framing, TLVs, handshakes, device commands and reports. The Python server operates as a decoding proxy or a standalone cloud replacement, with a web dashboard and local automation.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/mateusz-klatt/hestia>
- Primary source: <https://github.com/mateusz-klatt/hestia/blob/5566212b09125b529c6b72df0a8f390556ee770d/README.md>
- Catalog page: <https://awesomerea.org/resources/hestia-keemple-case/>
- Record JSON: <https://awesomerea.org/resources/hestia-keemple-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/hestia-keemple-case/index.md)

## Requirements & limits

- **Prerequisites:** Keemple smart-home devices and a local redirect of the gateway connection to the hestia host are required.
- **Testing evidence:** The backend test instructions specify Python 3.14 and dependencies from requirements.txt.
- **Testing evidence:** The author reports 100% line and branch coverage for the backend suite.
- **License:** Apache-2.0 license.

## Primary sources

1. <https://github.com/mateusz-klatt/hestia/blob/5566212b09125b529c6b72df0a8f390556ee770d/README.md>
2. <https://github.com/mateusz-klatt/hestia/blob/5566212b09125b529c6b72df0a8f390556ee770d/docs/PROTOCOL.md>

## More in Protocols

- [gigabyte-gpu-lcd: reconstructing AORUS GPU LCD control](https://awesomerea.org/resources/gigabyte-gpu-lcd-case/index.md) · Case study
- [Ricoh SP 200 Linux CUPS Driver: reconstructing the printer's USB print protocol](https://awesomerea.org/resources/ricoh-sp200-linux-case/index.md) · Case study
- [HyperX QuadCast 2 S: reconstructing RGB control on macOS](https://awesomerea.org/resources/hyperx-quadcast-2s-rgb-case/index.md) · Case study
- [whoop4-ble: reconstructing Whoop 4.0 sensor data access](https://awesomerea.org/resources/whoop4-ble-case/index.md) · Case study
- [MSI Mystic Light RGB Web Control Panel: reconstructing B760M-A lighting control](https://awesomerea.org/resources/msi-mystic-light-web-case/index.md) · Case study
- [Open Trofeo LCD: implementing Thermalright Trofeo USB display control](https://awesomerea.org/resources/open-trofeo-lcd-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.