espectre 是什么?

ESPectre 把支持的 ESP32 变成局域网内的 Wi-Fi CSI 运动传感器。它在设备上处理信号,可通过 ESPHome、MQTT、Matter 或本地 HTTP 接入自动化系统,不采集图像和音频。

⭐ 8,401 Stars 🍴 640 Forks Python GPL-3.0 作者: francescopace
来源:github.com/francescopace/espectre;https://github.com/francescopace/es… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方仓库当前约 9400 星,2026-09-22 仍在更新,并发布了 v3.0.0-rc2;关注度来自本地 Wi-Fi 感知与多前端支持,不能把仓库热度写成本站流量。

来源:github.com/francescopace/espectre;https://github.com/francescopace/es…

核心功能

本地 CSI 运动检测

设备读取 Wi-Fi 信道状态变化并输出运动状态与分数,原始 CSI 不必上传云端。

来源:github.com/francescopace/espectre/blob/main/README.md
多种固件前端

提供 Native、ESPHome、Matter 和 MicroPython 路线,分别面向独立传感器、Home Assistant、Matter 控制器和研究。

来源:github.com/francescopace/espectre/blob/main/README.md;https://github.…
浏览器安装与监视

桌面 Chrome 或 Edge 可通过 Web Serial 刷写,Device settings 和 Monitor 用于配网、诊断和调参。

来源:github.com/francescopace/espectre/blob/main/docs/SETUP.md
公开验证材料

仓库提供数据集、模型权重、训练流程、性能报告和失败实验记录,便于检查项目方结论。

来源:github.com/francescopace/espectre/blob/main/README.md

技术架构

C++ 实现分为 frontend、runtime 和 core。前端负责 ESPHome、Native 或 Matter 接口,runtime 处理 CSI 输入、校准、事件与网络生命周期,core 保存可移植检测器和特征逻辑。Micro-ESPectre 提供另一条 MicroPython 路线。

来源:github.com/francescopace/espectre/blob/main/docs/ARCHITECTURE.md

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 受支持的 ESP32 USB 数据线 2.4 GHz Wi-Fi;ESP32-C5 可用 5 GHz但检测质量尚未刻画2.4 GHz Wi-Fi… 桌面 Chrome 或 Edge(浏览器刷写)桌面 Chrome 或… 本地 CSI 运动检测 多种固件前端 浏览器安装与监视 公开验证材料 espectre 项目本体 核心功能 关键依赖

技术栈

语言C++、Python/MicroPython、浏览器工具框架ESP-IDF、ESPHome、Matter、MQTT、Direct HTTP
受支持的 ESP32USB 数据线2.4 GHz Wi-Fi;ESP32-C5 可用 5 GHz但检测质量…桌面 Chrome 或 Edge(浏览器刷写)
每个感知区域通常需要一块板;浏览器与设备需能在局域网通信
来源:github.com/francescopace/espectre/blob/main/README.md;https://github.…

快速上手

先用单独的测试网络和一块支持的 ESP32。打开官方 Flash 工具,选择 Release 通道,核对设备和是否擦除数据后再刷写;完成 Wi-Fi 配置后,用 Monitor 检查 CSI 包、校准状态、运动响应和恢复到 idle。不要把 Preview 或 Development 当稳定固件。
来源:github.com/francescopace/espectre/blob/main/docs/SETUP.md

使用场景

适合房间级灯光、空调和非安全关键提醒。它只能检测无线环境变化,不能识别人、计数、证明房间无人,也不能替代经过认证的安防、医疗或应急系统。

来源:github.com/francescopace/espectre/blob/main/README.md

优势与局限

优势

  • 不采集图像或音频
  • 本地处理且不强制云端
  • 支持多种固件与 Home Assistant 接入
  • 公开数据、模型和验证报告

局限

  • 家具、墙体、天线、接入点和频道变化会影响结果
  • 每个感知区域通常需要一块板
  • Matter 控制器兼容性仍在验证
  • 运动数据仍能泄露作息和是否在家,部署需告知并取得必要同意
  • GPLv3 之外的闭源嵌入需要商业许可;本轮未刷写硬件
来源:github.com/francescopace/espectre/blob/main/README.md;https://github.…

最新版本

当前稳定版 v2.8.0 发布于 2026-05-21。最新预发布 v3.0.0-rc2 发布于 2026-09-16,加入下载签名验证、Native/ESPHome 签名 OTA、CSI capture profile 和独立 SDK 构建等变化;RC 版含破坏性变更。

来源:github.com/francescopace/espectre/releases/tag/2.8.0;https://github.c…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对 README、Setup、Architecture、Licensing、v2.8.0 与 v3.0.0-rc2 Release  |  limitations: 未连接 ESP32、未打开 Web Serial、未刷写固件、未采集 CSI,也未复现项目方性能数据  |  observed_output: 稳定版为 v2.8.0;最新预发布为 v3.0.0-rc2,加入签名固件目录、CSI capture profile 和 SDK 构建变化。官方 Setup 列出支持芯片与浏览器要求

来源:github.com/francescopace/espectre/releases/tag/2.8.0;https://github.c…

同类项目对比

Espressif 的 esp-csi 仓库提供 Wi-Fi CSI 的底层示例和人体检测、定位等参考应用。ESPectre 在此类底层能力上增加现成固件、校准、检测器、Home Assistant/Matter 接口和浏览器工具。研究 CSI 原理可从 esp-csi 开始;需要房间运动传感器工作流时评估 ESPectre。

来源:github.com/espressif/esp-csi;https://github.com/francescopace/espectr…

总结评价

ESPectre 提供了比底层 CSI 示例更完整的房间级运动传感器路线。先在非安全关键区域用稳定固件测试误报、漏报和网络变化,并处理同意与数据访问;医疗、安防和人员识别场景不应依赖它。

来源:github.com/francescopace/espectre/blob/main/README.md;https://github.…

常见问题

ESPectre v3.0.0-rc2 是稳定版吗?

不是。它是 2026-09-16 发布的候选版;当前稳定版仍是 v2.8.0。普通安装应在 Flash 工具中选择 Release 通道。

ESPectre 能识别房间里是谁吗?

不能。官方说明它检测无线环境变化,不识别人、不计数,也不能证明房间为空。

ESPectre 一定要把数据上传云端吗?

不需要。检测在 ESP32 本地完成,原始 CSI 采集是可选功能;运动状态可通过局域网接口接入 Home Assistant。

闭源产品可以直接使用 ESPectre 吗?

开源代码默认受 GPLv3 约束。无法满足源码公开义务的闭源固件需与项目方洽谈商业许可,而且 ESPHome 前端仍只提供 GPLv3 路线。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件