Case study
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.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 3
- Last commit
- 2026-10-22
- Language
- Python
- License (GitHub)
- Apache-2.0
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a demo observed; no download method found.
- Checked
- 2026-11-08
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.
Cite
BibTeX
@misc{hestia-keemple-case,
title = {{hestia: replacing the Keemple smart-home cloud}},
howpublished = {\url{https://github.com/mateusz-klatt/hestia}},
url = {https://github.com/mateusz-klatt/hestia},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/hestia-keemple-case/}}
}Plain text
hestia: replacing the Keemple smart-home cloud. https://github.com/mateusz-klatt/hestia (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/hestia-keemple-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · mateusz-klatt/hestia · Revision 5566212
- docs/PROTOCOL.md GitHub · mateusz-klatt/hestia · Revision 5566212
More in Protocols
- gigabyte-gpu-lcd: reconstructing AORUS GPU LCD control · Case study
- Ricoh SP 200 Linux CUPS Driver: reconstructing the printer's USB print protocol · Case study
- HyperX QuadCast 2 S: reconstructing RGB control on macOS · Case study
- whoop4-ble: reconstructing Whoop 4.0 sensor data access · Case study
- MSI Mystic Light RGB Web Control Panel: reconstructing B760M-A lighting control · Case study
- Open Trofeo LCD: implementing Thermalright Trofeo USB display control · Case study