
ESPectre - 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 de 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 biblioteca de Arduino, 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++ o un sketch de Arduino-ESP32.
Todo se ejecuta en el dispositivo: mide el canal Wi-Fi (información de estado del canal, o CSI) y reporta movimiento y una puntuación de movimiento. No es necesario enviar nada 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í |
|---|---|---|
| Nativa | Sensores autónomos, integraciones MQTT, incluido Home Assistant MQTT Discovery, y aplicaciones personalizadas | Frontend nativo |
| ESPHome | Usuarios de Home Assistant que quieren entidades nativas, aprovisionamiento de ESPHome y actualizaciones con Device Builder | Frontend ESPHome |
| Matter | Controladores Matter con soporte de sensor de ocupación; probado con Google Home, Apple Home y Home Assistant | Frontend Matter |
| Micro-ESPectre | Detección ligera en MicroPython con monitoreo HTTP Direct 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 es posible que Device settings y Monitor no funcionen en él.
Para encontrar tus dispositivos en la red, usa Find devices en las herramientas del navegador o ./espectre devices. Consulta la referencia de descubrimiento para conocer los requisitos y límites.

Estado de Matter: el emparejamiento, las actualizaciones de ocupación y las automatizaciones están probados con Google Home, Apple Home y Home Assistant. Amazon Alexa y Samsung SmartThings aún no se han probado. Google Home requiere una configuración única en Developer Console. Consulta la 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
Descubre las herramientas más usadas por nuestra comunidad.
Sin datos de popularidad aún.