francescopace/espectreESPectre - Sistema de detección de movimiento basado en el análisis del espectro Wi-Fi (CSI), con integración de Home Assistant.
Convierte un ESP32 en un sensor de movimiento Wi-Fi privado y local.
Cuando alguien se mueve por una habitación, cambia la forma en que las señales Wi-Fi viajan a través de ella. ESPectre lee esos cambios y reporta movimiento en tiempo real. Sin cámara, sin micrófono, sin dispositivo wearable y sin hardware radar dedicado: solo un ESP32 compatible y la red Wi-Fi que ya está en la habitación.
ESPectre es una plataforma de código abierto que reúne firmware listo para flashear, un SDK de C++ embebible, una implementación en MicroPython, herramientas de navegador, una CLI de host, un conjunto de datos abierto, pesos de modelo abiertos y el flujo de trabajo de investigación utilizado para construir y validar los detectores.
Flashear desde tu navegador · Ver las herramientas en vivo · Leer la documentación · Explorar el SDK
Usa ESPectre para encender luces o una pantalla cuando alguien entra, ajustar la calefacción cuando una habitación está en uso, o enviar una alerta cuando hay movimiento donde no debería haber nadie. Funciona con Home Assistant (a través de ESPHome o MQTT), aparece como un sensor de ocupación Matter estándar, ofrece una API HTTP local y puede integrarse en tu propio firmware ESP32 con el SDK de C++.
Todo se ejecuta en el dispositivo: mide el canal Wi-Fi (channel state information, o CSI) y reporta movimiento y una puntuación de movimiento. Nada necesita ir a la nube. Una placa cubre una zona, así que planifica una placa por habitación.
ESPectre detecta cambios en el entorno radioeléctrico. No identifica personas, no las cuenta, no demuestra que una habitación esté vacía ni sustituye a un sistema de seguridad, médico o de emergencia certificado.
| Ruta | Ideal para | Empieza aquí |
|---|---|---|
| Native | Sensores autónomos, integraciones MQTT, incluido Home Assistant MQTT Discovery, y aplicaciones personalizadas | Frontend Native |
| ESPHome | Usuarios de Home Assistant que quieren entidades nativas, aprovisionamiento ESPHome y actualizaciones de Device Builder | Frontend ESPHome |
| Matter | Controladores Matter con soporte de sensor de ocupación; la validación de controladores aún es limitada | Frontend Matter |
| Micro-ESPectre | Detección ligera en MicroPython con monitoreo Direct HTTP local y de solo lectura | README de Micro-ESPectre |
La forma más rápida solo necesita un navegador. Usa Chrome 151 o posterior de escritorio; Edge puede flashear, pero Device settings y Monitor pueden no funcionar en él.
Para encontrar tus dispositivos en la red, usa Find devices en las herramientas de navegador o ./espectre devices. Consulta la referencia de descubrimiento para requisitos y límites.
Estado de Matter: El soporte de Matter aún se está probando con los diferentes ecosistemas de controladores. Es posible que un controlador que admita sensores de ocupación aún no se haya probado con ESPectre. Consulta Compatibilidad de controladores Matter para ver la matriz actual.
Para compilar y flashear desde este repositorio, empieza con la guía de configuración. Para ver todos los comandos disponibles, ejecuta:
./espectre --help