RavenSystem/esp-homekit-devices

Free

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...)

FreeFree tier

Type

Open Source

Visit Website GitHub (38 stars)

About RavenSystem/esp-homekit-devices

HAA (Home Accessory Architect) is an open-source firmware that brings native Apple HomeKit support to ESP32, ESP32-S, ESP32-C, and ESP8266 microcontrollers. It supports a wide variety of HomeKit service types with extensive customization options, allowing users to integrate devices like Shelly, Sonoff, Electrodragon, and Tuya directly into Apple Home without additional bridges. The project features companion apps for device management (HAA Home for HomeKit Matter) and performance testing (Home Bench). With over 480 releases and an active community, HAA is a mature solution for DIY home automation enthusiasts.

Key Features

Native Apple HomeKit support without hubs or bridges

Compatible with ESP32, ESP32-S, ESP32-C, and ESP8266 microcontrollers

Wide range of HomeKit service types and custom configurations

Open source firmware with frequent releases (482 releases)

Companion app HAA Home for batch updates and management

Home Bench app for Apple Home performance testing

Supports popular devices: Shelly, Sonoff, Electrodragon, Tuya

Active GitHub community with 3k stars and 370 forks

C-based firmware with high performance and low overhead

Pros & Cons

Pros

Open source and completely free
Native HomeKit support eliminates need for extra hubs or bridges
Supports a wide variety of ESP-based MCUs and popular smart home hardware
Active development with hundreds of releases and responsive community
Companion apps enhance management and performance testing capabilities

Cons

Requires technical knowledge to flash firmware onto microcontrollers
Limited to ESP32 and ESP8266 based devices only
No official support for non-ESP platforms (e.g., Raspberry Pi, Arduino)

Best For

Add native HomeKit compatibility to existing ESP-based smart home devicesDIY home automation projects requiring direct Apple Home integrationRetrofitting non-HomeKit IoT devices (e.g., Sonoff, Shelly) to work with Apple HomeCustom smart home setups with advanced service type configuration

FAQ

What devices are compatible with this firmware?

The firmware is compatible with any SoC based on the ESP32, ESP32-S, ESP32-C, and ESP8266 series, including popular smart home devices like Shelly, Sonoff, Electrodragon, and Tuya.

Is the firmware open source?

Yes, it is open source and licensed under a license visible in the GitHub repository.

How do I install the firmware?

Installation involves flashing the firmware onto your ESP device. Detailed instructions are available in the project's Wiki on GitHub.

What is HAA?

HAA stands for Home Accessory Architect, the firmware that provides native Apple HomeKit support and custom configurations for ESP-based devices.