Repolode
Enviar
francescopace

francescopace/espectre

Convierte un ESP32 en un sensor de movimiento Wi-Fi privado y local que detecta movimiento a partir de cambios en las señales Wi-Fi, sin cámara ni micrófono.

Ver en GitHubSitio web
Estrellas
9,665
Forks
733
Issues abiertos
14
Último commit
anteayer

¿Qué es?

ESPectre funciona en placas ESP32 compatibles y lee información del estado del canal (CSI) de las señales Wi-Fi presentes en una habitación. Cuando alguien se mueve, las rutas de la señal cambian y el dispositivo informa del movimiento y de una puntuación de movimiento en tiempo real. El procesamiento se realiza en el dispositivo, por lo que no se necesita ningún servicio en la nube ni se requieren cámara, micrófono, dispositivo wearable o hardware de radar.

El proyecto ofrece varias opciones de firmware: un frontend Native con MQTT y Home Assistant MQTT Discovery, un frontend ESPHome, un frontend de sensor de ocupación Matter y una implementación de MicroPython llamada Micro-ESPectre. También incluye un SDK C++ integrable, una API HTTP local, herramientas de monitorización y flasheo desde el navegador, y una CLI para gestionar dispositivos.

El repositorio publica un conjunto de datos CSI, pesos de modelos entrenados, un registro de características con experimentos probados y descartados, e informes de rendimiento. ESPectre solo detecta cambios en el entorno de radio; no identifica ni cuenta personas. El código está licenciado bajo GPLv3 y algunas partes cuentan con una licencia comercial disponible para quienes cumplan los requisitos.

Funciones clave

  • 01Detecta movimiento mediante CSI de Wi-Fi en placas ESP32-C6, C5, C3, S3, S2 y ESP32 clásico.
  • 02Se ejecuta íntegramente en el dispositivo, sin necesidad de conexión a la nube.
  • 03Se integra con Home Assistant mediante ESPHome o MQTT y aparece como un sensor de ocupación Matter.
  • 04Ofrece una API HTTP local y un SDK C++ integrable para firmware personalizado.
  • 05Incluye flasheo desde el navegador, ajustes del dispositivo y un monitor en tiempo real.

Casos de uso

  • Encender luces o una pantalla cuando alguien entra en una habitación.
  • Ajustar la calefacción según si se está usando una habitación.
  • Enviar una alerta cuando se detecta movimiento en una zona que debería estar vacía.
  • Añadir detección de presencia a una instalación de Home Assistant sin cámaras.

Inicio rápido

  1. 1

    Abre la herramienta Flash en Chrome o Edge para escritorio

  2. 2

    Conecta por USB un ESP32 compatible, elige el firmware y completa la configuración de Wi-Fi

  3. 3

    Abre Monitor para observar el movimiento y ajustar la detección

Antes de usarlo

  • Se necesita una placa ESP32 compatible y una red Wi-Fi 4 de 2,4 GHz; prevé una placa por habitación.
  • La compatibilidad con controladores Matter sigue siendo limitada y no se ha probado por completo.
  • Se aplica el copyleft de GPLv3, por lo que el firmware de código cerrado requiere una licencia comercial independiente.

Temas

#wifi-sensing#esp32#motion-detection#home-assistant#iot#embedded#matter#esphome#csi#diy

Preguntas frecuentes

¿Qué es espectre?
Convierte un ESP32 en un sensor de movimiento Wi-Fi privado y local que detecta movimiento a partir de cambios en las señales Wi-Fi, sin cámara ni micrófono. ESPectre funciona en placas ESP32 compatibles y lee información del estado del canal (CSI) de las señales Wi-Fi presentes en una habitación. Cuando alguien se mueve, las rutas de la señal cambian y el dispositivo informa del movimiento y de una puntuación de movimiento en tiempo real. El procesamiento se realiza en el dispositivo, por lo que no se necesita ningún servicio en la nube ni se requieren cámara, micrófono, dispositivo wearable o hardware de radar.
¿espectre es gratuito? ¿Qué licencia tiene?
espectre es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿espectre sigue mantenido?
Mantenimiento activo. El último commit de espectre fue el 19 oct 2026.
¿Para qué puedo usar espectre?
Encender luces o una pantalla cuando alguien entra en una habitación. Ajustar la calefacción según si se está usando una habitación. Enviar una alerta cuando se detecta movimiento en una zona que debería estar vacía. Añadir detección de presencia a una instalación de Home Assistant sin cámaras.
¿Cómo se instala espectre?
Abre la herramienta Flash en Chrome o Edge para escritorio Conecta por USB un ESP32 compatible, elige el firmware y completa la configuración de Wi-Fi Abre Monitor para observar el movimiento y ajustar la detección
¿Dónde consigo espectre?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/francescopace/espectre

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados