
espectre snapshot-dev
ESPectre - Sistema de detección de movimiento basado en el análisis del espectro Wi-Fi (CSI), con integración de Home Assistant.
ESPectre 
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
Aplicaciones e integraciones
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.
Hardware compatible
- ESP32-C6, ESP32-C5, ESP32-C3, ESP32-S3, ESP32-S2 y ESP32 clásico
- una red Wi-Fi 4 (802.11n) normal en 2,4 GHz
Elige una ruta de firmware
| 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 |
Inicio rápido
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.
- Abre Flash en Chrome o Edge de escritorio.
- Conecta un ESP32 compatible por USB y, a continuación, elige un firmware y un canal de versión.
- Completa el aprovisionamiento Wi-Fi en pantalla, o comisiona Matter con un controlador compatible.
- Opcionalmente, abre Device settings para fijar un punto de acceso preferido o configurar MQTT.
- Abre Monitor para observar el movimiento, ajustar la detección e inspeccionar el dispositivo.
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.
Configuración local
Para compilar y flashear desde este repositorio, empieza con la guía de configuración. Para ver todos los comandos disponibles, ejecuta:
./espectre --help