开源 WiFi 感知平台,利用 ESP32 的 CSI 信号无摄像头检测人员存在、呼吸、心率和活动。
francescopace/espectre
把 ESP32 变成本地运行的 Wi-Fi 动态感应器,通过无线信号变化检测移动,无需摄像头或麦克风。
- Star
- 9,665
- Fork
- 733
- 未关闭 Issue
- 14
- 最近提交
- 前天
这是什么?
ESPectre 运行在受支持的 ESP32 开发板上,读取房间内现有 Wi-Fi 信号的信道状态信息(CSI)。有人移动时,信号传播路径随之改变,设备会实时上报移动状态和运动分数。所有处理都在设备端完成,不依赖云服务,也不需要摄像头、麦克风、可穿戴设备或雷达硬件。
项目提供多种固件方案:支持 MQTT 和 Home Assistant MQTT Discovery 的 Native 版本、ESPHome 版本、作为 Matter 占用传感器的版本,以及基于 MicroPython 的 Micro-ESPectre。此外还包括可嵌入的 C++ SDK、本地 HTTP API、浏览器端烧录和监控工具,以及用于管理设备的命令行工具。
仓库公开了 CSI 数据集、训练好的模型权重、记录已测试与被否决实验的特征清单,以及性能报告。ESPectre 只检测无线电环境的变化,不识别或统计人数。代码采用 GPLv3 协议,符合条件的部分另提供商业授权。
核心功能
- 01在 ESP32-C6、C5、C3、S3、S2 及经典 ESP32 上基于 Wi-Fi CSI 检测移动。
- 02所有运算在设备端完成,无需连接云端。
- 03通过 ESPHome 或 MQTT 接入 Home Assistant,也可作为 Matter 占用传感器使用。
- 04提供本地 HTTP API 和可嵌入的 C++ SDK,便于开发自定义固件。
- 05内置浏览器烧录、设备设置和实时监控工具。
适用场景
- 有人进入房间时自动开启灯光或显示屏。
- 根据房间是否有人使用来调节供暖。
- 在本应无人的区域检测到移动时发送提醒。
- 在 Home Assistant 中加入不依赖摄像头的人员活动感知。
快速上手
- 1
在桌面版 Chrome 或 Edge 中打开 Flash 工具
- 2
通过 USB 连接受支持的 ESP32,选择固件并完成 Wi-Fi 配置
- 3
打开 Monitor 查看运动并调整检测参数
使用前须知
- 需要受支持的 ESP32 开发板和 2.4 GHz Wi-Fi 4 网络;每个房间需要一块开发板。
- Matter 控制器兼容性仍然有限,尚未全面测试。
- 适用 GPLv3 copyleft 协议,闭源固件需要单独的商业许可。
标签
常见问题
- espectre 是什么?
- 把 ESP32 变成本地运行的 Wi-Fi 动态感应器,通过无线信号变化检测移动,无需摄像头或麦克风。 ESPectre 运行在受支持的 ESP32 开发板上,读取房间内现有 Wi-Fi 信号的信道状态信息(CSI)。有人移动时,信号传播路径随之改变,设备会实时上报移动状态和运动分数。所有处理都在设备端完成,不依赖云服务,也不需要摄像头、麦克风、可穿戴设备或雷达硬件。
- espectre 可以免费使用吗?用的什么许可证?
- espectre 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
- espectre 还在维护吗?
- 活跃维护中。espectre 最近一次提交是在 2026年10月19日。
- espectre 适合用来做什么?
- 有人进入房间时自动开启灯光或显示屏。 根据房间是否有人使用来调节供暖。 在本应无人的区域检测到移动时发送提醒。 在 Home Assistant 中加入不依赖摄像头的人员活动感知。
- espectre 怎么安装和运行?
- 在桌面版 Chrome 或 Edge 中打开 Flash 工具 通过 USB 连接受支持的 ESP32,选择固件并完成 Wi-Fi 配置 打开 Monitor 查看运动并调整检测参数
- 在哪里获取 espectre?
- 源代码和安装说明在 GitHub 上:https://github.com/francescopace/espectre
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
基于 ESP32 的开源低成本迷你四足机器人,可 3D 打印,带 OLED 表情屏。
用于在 ESP32 开发板和 Raspberry Pi 等 Linux 设备上自制 Muse 小工具的开源 SDK 与固件。
一款 ESP32 桌面显示屏,展示 Claude Code 用量限额,并在会话需要你处理时提醒。
面向微控制器等资源受限设备的精简 Python 3 实现,并提供硬件外设访问模块。