
ESPectre - Sistema de detecção de movimento baseado na análise do espectro Wi-Fi (CSI), com integração com o Home Assistant.
Transforme um ESP32 em um sensor de movimento Wi-Fi privado e local.
Quando alguém se move por um ambiente, altera a forma como os sinais de Wi-Fi se propagam por ele. O ESPectre lê essas alterações e reporta movimento em tempo real. Sem câmera, sem microfone, sem dispositivo vestível e sem hardware de radar dedicado: apenas um ESP32 compatível e a rede Wi-Fi que já está no ambiente.
O ESPectre é uma plataforma de código aberto que reúne firmware pronto para gravação, um SDK C++ integrável, uma biblioteca Arduino, uma implementação em MicroPython, ferramentas de navegador, uma CLI de host, um conjunto de dados aberto, pesos de modelo abertos e o fluxo de trabalho de pesquisa usado para construir e validar os detectores.
Grave pelo seu navegador · Veja as ferramentas ao vivo · Leia a documentação · Explore o SDK
Use o ESPectre para acender luzes ou um display quando alguém entrar, ajustar o aquecimento quando um ambiente estiver em uso ou enviar um alerta quando houver movimento onde não deveria haver ninguém. Ele funciona com o Home Assistant (via ESPHome ou MQTT), aparece como um sensor de ocupação Matter padrão, oferece uma API HTTP local e pode ser incorporado ao seu próprio firmware ESP32 com o SDK C++ ou um sketch Arduino-ESP32.
Tudo é executado no dispositivo: ele mede o canal Wi-Fi (channel state information, ou CSI) e reporta movimento e uma pontuação de movimentação. Nada precisa ir para a nuvem. Uma placa cobre uma área, então planeje uma placa por ambiente.
O ESPectre detecta alterações no ambiente de rádio. Ele não identifica pessoas, não as conta, não comprova que um ambiente está vazio nem substitui um sistema de segurança, médico ou de emergência certificado.
| Caminho | Ideal para | Comece aqui |
|---|---|---|
| Nativo | Sensores autônomos, integrações MQTT, incluindo Home Assistant MQTT Discovery, e aplicações personalizadas | Frontend nativo |
| ESPHome | Usuários do Home Assistant que desejam entidades nativas, provisionamento via ESPHome e atualizações pelo Device Builder | Frontend ESPHome |
| Matter | Controladores Matter com suporte a sensor de ocupação; testado com Google Home, Apple Home e Home Assistant | Frontend Matter |
| Micro-ESPectre | Sensoriamento leve em MicroPython com monitoramento Direct HTTP local e somente leitura | README do Micro-ESPectre |
O caminho mais rápido exige apenas um navegador. Use o Chrome para desktop 151 ou posterior; o Edge consegue gravar, mas as Configurações do dispositivo e o Monitor podem não funcionar nele.
Para encontrar seus dispositivos na rede, use Find devices nas ferramentas do navegador ou ./espectre devices. Consulte a referência de descoberta para requisitos e limites.

Status do Matter: o emparelhamento, as atualizações de ocupação e as automações são testados com Google Home, Apple Home e Home Assistant. Amazon Alexa e Samsung SmartThings ainda não foram testados. O Google Home requer uma configuração única do Developer Console. Consulte Compatibilidade de controladores Matter para a matriz atual.
Para compilar e gravar o firmware a partir deste repositório, comece pelo guia de configuração. Para ver todos os comandos disponíveis, execute:
./espectre --help