// the find
RavenSystem/esp-homekit-devices
Advanced firmware to add native Apple HomeKit and custom configurations, compatible with any SoC based on ESP32, ESP32-S, ESP32-C and ESP8266 series. (Shelly, Sonoff, Electrodragon, Tuya...)
HAA (Home Accessory Architect) is firmware that adds native Apple HomeKit support to ESP8266/ESP32 devices — think Shelly, Sonoff, Tuya hardware running your own code instead of the vendor's cloud. It's for people who want local-only smart home control without paying for a hub or trusting a Chinese server. Configuration is JSON-based, so no recompilation needed for most use cases.
Supports a genuinely wide range of ESP chips (ESP8266, ESP32, ESP32-S, ESP32-C) with a single codebase — that's non-trivial cross-platform embedded work. OTA update support means you can flash and forget, then update over WiFi without physically touching the device. The JSON config system is clever: you describe your accessory's services and GPIO mappings without touching C code, which lowers the barrier substantially for non-embedded people. Active maintenance (last push April 2026) on a project that depends on Apple's HAP protocol, which Apple has changed without notice before.
The wolfSSL dependency is pinned to 3.13.0-stable, which is ancient — that version is from around 2017 and has known CVEs. Using outdated TLS on IoT devices is a real problem, not a theoretical one. The wiki is the primary documentation, which means you're one wiki outage or repo deletion away from losing the configuration reference entirely. No automated tests visible anywhere in the tree — for firmware that controls physical hardware (lights, locks, switches), that's a gap you'll feel when a config change breaks a GPIO mapping at 2am. Matter support is listed in topics but it's unclear from the README how complete or stable it actually is.