103,758
Stars
13,472
Forks
910
Watchers
562
Open Issues
MIT
许可证
Rust
语言
2025-06-07
创建时间
2026-11-10
最近更新
项目能做什么
RuView 无需摄像头画面，利用普通 WiFi 信号即可实现实时空间感知、人体存在检测以及呼吸心率等生命体征监测。
来源：AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
项目简介
π RuView 是一款利用普通商用 WiFi 信号实现空间智能感知的开源平台。无需摄像头（不采集任何视频像素），也无需佩戴任何穿戴设备，仅通过物理射频信号即可实现穿墙探测、人体存在感知以及生命体征监测。
项目通过低成本的 ESP32 硬件节点采集 WiFi 的信道状态信息（CSI，Channel State Information）。人在空间内的走动、静坐乃至呼吸都会对无线电电磁场产生微弱扰动，RuView 通过捕获并分析这些扰动信号，将其转化为空间内人员状态的结构化数据。
核心功能
- 存在与占用感知（Presence and Occupancy）：穿墙检测人体存在、人数统计以及进出房间追踪。
- 非接触生命体征监测（Vital Signs）：在静坐或睡眠状态下，非接触式测量呼吸率与心率。
- 活动与动作识别（Activity Recognition）：基于 CSI 时序模式识别行走、坐下、手势动作以及跌倒事件。
- 无摄像头姿态估计（Camera-free Pose）：仅凭 WiFi CSI 估算人体 17 个关键点骨骼姿态。
- 环境地图与指纹（Environment Mapping）：利用射频指纹（RF fingerprinting）识别不同房间、感知家具移动或新物体进入。
- 睡眠质量分析（Sleep Quality）：夜间监测并进行睡眠分期分类，提供睡眠呼吸暂停筛查。
- 全生态智能家居接入：
- 原生支持 Home Assistant：通过
--mqtt参数即可自动发现并上报。每个节点提供 21 个实体（包含 11 个原始信号与 10 个推断语义状态，如someone-sleeping、fall-risk-elevated、bathroom-occupied等）。 - 支持 Apple Home / HomePod（HAP-1.1 桥接模式），以及通过 Matter / HA 桥接接入 Google Home、Amazon Alexa、SmartThings。
- 内置模型工作流与本地自动化：支持录制 CSI、训练模型、加载 RVF 权重文件、切换 LoRA 配置；内置 HOMECORE 提供本地状态机与 Wasm 插件化自动化能力。
适合谁用
- 智能家居爱好者：希望实现高精度人体存在感应（解决传统人体传感器静止误判问题），且介意摄像头隐私泄露的用户。
- 健康看护与智慧养老开发者：需要居家跌倒检测、离床警报、夜间心率与呼吸健康看护的场景。
- 物联网与射频感知研究者：对 WiFi CSI 信号处理、无线感知算法及 ESP32 嵌入式开发感兴趣的技术人员。
安装步骤
此部分原文未说明完整环境搭建步骤，请查看原仓库。
从已有文档信息可知，项目包含以下组件：
1. 硬件固件：位于 firmware/esp32-csi-node，需烧录至兼容的 ESP32 节点用于采集 CSI 信号。
2. 预训练模型：托管于 Hugging Face（ruvnet/wifi-densepose-pretrained）。
3. AI 工具链与运行环境：位于 harness/ruview。
配置说明
- Home Assistant 接入：通过添加
--mqtt运行参数快速对接 MQTT Broker，系统会自动生成实体并提供开箱即用的 Blueprint 联动模板。 - 生态桥接：可作为 Matter Bridge 或 Apple HAP-1.1 桥接器直接配对至各大语音助手平台，无需编写自定义技能（Skills）即可查询各房间人员存在与体征信息。
- 其余具体配置文件与参数项原文未完整说明，请查看原仓库文档。
常见问题
此部分原文未说明，请查看原仓库。
原始 README 摘录（英文原文，节选前 3000 字符）
# π RuView
<p align="center">
<a href="https://cognitum.one/seed">
<img src="assets/ruview-hero-h3-v3.gif" alt="RuView - WiFi DensePose — animated visualization of real-time pose estimation, breathing, and heart-rate sensing through WiFi" width="100%">
</a>
</p>
[](docs/user-guide.md)
<table>
<tr>
<td align="center" width="33%"><a href="docs/user-guide.md"><img src="assets/readme/nav-start-spatial-v4.svg" width="180" alt="Start here" /></a><br/><a href="docs/user-guide.md">Start here</a></td>
<td align="center" width="33%"><a href="firmware/esp32-csi-node/README.md"><img src="assets/readme/nav-hardware-spatial-v4.svg" width="180" alt="Hardware" /></a><br/><a href="firmware/esp32-csi-node/README.md">Hardware</a></td>
<td align="center" width="33%"><a href="https://huggingface.co/ruvnet/wifi-densepose-pretrained"><img src="assets/readme/nav-models-spatial-v4.svg" width="180" alt="Models" /></a><br/><a href="https://huggingface.co/ruvnet/wifi-densepose-pretrained">Models</a></td>
</tr>
<tr>
<td align="center" width="33%"><a href="harness/ruview/README.md"><img src="assets/readme/nav-agents-spatial-v4.svg" width="180" alt="AI toolkit" /></a><br/><a href="harness/ruview/README.md">AI toolkit</a></td>
<td align="center" width="33%"><a href="docs/integrations/home-assistant.md"><img src="assets/readme/nav-home-spatial-v4.svg" width="180" alt="Smart home" /></a><br/><a href="docs/integrations/home-assistant.md">Smart home</a></td>
<td align="center" width="33%"><a href="https://cognitum.one/seed"><img src="assets/readme/nav-seed-spatial-v4.svg" width="180" alt="Cognitum Seed" /></a><br/><a href="https://cognitum.one/seed">Cognitum Seed</a></td>
</tr>
</table>
<p align="center">
<a href="https://ruos.cognitum.one">
<img src="assets/ruos-animated.svg" alt="RuView — WiFi becomes spatial awareness, with Ruflo coordination and a ruOS sensing workspace" width="100%">
</a>
</p>
## **See through walls with WiFi** ##
**Turn ordinary WiFi into a spatial intelligence / sensing system.** Detect people, measure breathing and heart rate, track movement, and monitor rooms — through walls, in the dark, with no cameras or wearables. Just physics.
Works natively with the four major smart-home ecosystems: **[Home Assistant](docs/integrations/home-assistant.md)** via the HA-DISCO MQTT publisher, **[Apple Home & HomePod](docs/user-guide-apple-homepod.md)** as a discoverable HAP-1.1 bridge, **[Google Home](docs/integrations/home-assistant.md)** + **[Amazon Alexa](docs/integrations/home-assistant.md)** via the same HA bridge or a [Matter](docs/adr/ADR-122-bfld-ruview-ha-matter-exposure.md) endpoint. Siri, Google Assistant, and Alexa can voice presence and vitals by room with zero custom skills.
[](docs/in
阅读完整原文
商业机会分析 AI 生成
预烧录即用型 WiFi 空间雷达硬件套件与伴侣 App
| 产品构想 | 针对动手能力有限但有居家监测需求的用户，提供预刷 RuView 固件的 ESP32 开箱即用节点套件，搭配简易配网工具及原生 Home Assistant / Apple Home 一键接入服务。 |
| 核心功能 | 预刷稳定固件的 ESP32 硬件、自动化配网蓝牙通道、Matter/HAP/MQTT 即插即用、房间 RF 场标定向导 |
| 目标用户 | Home Assistant 玩家、数码爱好者、对隐私敏感的家庭安防用户 |
| 难度/周期 | 中等 · 2 - 3 个月 · 成本：硬件采购打样、外壳 3D 打印/开模、小规模库存流动资金 |
| 收费模式 | 硬件销售差价（如 3 节点起售价 $69-$99）及高阶云端分析增值包 |
| 竞争风险 | 供应链管理复杂；ESP32 接收天线差异及多径干扰导致不同户型下识别精度不稳定 |
| 依据 | 已验证事实 |
独居老人居家康养异常监护系统 (Turnkey SaaS)
| 产品构想 | 面向银发居家照料场景，利用 RuView 提取的'跌倒风险预警'、'夜间离床未归'、'异常失动'、'呼吸心率异常'等语义状态，向照料人手机端提供非侵入式健康警报与日报。 |
| 核心功能 | 浴室/卧室无死角无盲区无摄监护、跌倒与呼吸异常电话/短信强提醒、离床时间分析、健康周报与睡眠质量评估 |
| 目标用户 | 独居老人子女、社区日间照料中心、家庭看护服务机构 |
| 难度/周期 | 高 · 4 - 6 个月 · 成本：算法鲁棒性优化调优、短信与电话告警网关成本、合规及测试验证 |
| 收费模式 | 软硬件捆绑销售 + 按月家庭健康监护订阅费（例如 $15-$29/月） |
| 竞争风险 | 医疗与安全责任风险（漏报跌倒或虚假警报可能引发纠纷）；算法抗宠物和多人在场干扰难度极高（推测） |
| 依据 | 数据支持的判断 |
商业楼宇与联合办公空间占用及节能中继网关
| 产品构想 | 将 RuView 封装为面向商业楼宇空间优化的 API 网关，无需改装昂贵的专用红外/毫米波雷达，复用现有网络或部署低功耗节点采集会议室占用率、工位使用率，联动 HVAC/照明节能。 |
| 核心功能 | 高密度空间占用统计 API、会议室自动签到/释放联动、HVAC 与照明自适应能耗联动接口、多节点拓扑管理面板 |
| 目标用户 | 企业行政运维、联合办公运营方、智能建筑弱电工程商 |
| 难度/周期 | 中等偏高 · 3 - 5 个月 · 成本：B端对接与现场协议适配开发、演示样板间搭建与测试 |
| 收费模式 | 按节点或按面积收取年化授权费，私有部署集成服务费 |
| 竞争风险 | B端决策周期长；商用环境下 WiFi 射频干扰复杂导致 CSI 噪声过大（推测） |
| 依据 | 尚需验证的假设 |
AI 基于仓库公开数据分析生成，含推测成分，不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| x1958075990h-pixel/RuView_Radar_Lite | 面向 ESP32 Wi-Fi CSI 空间感知的轻量级纯 Python DSP 引擎。 | 167 | Python |
| DevvGwardo/openclaw-ruview-presence | 基于 RuView WiFi 感知、为智能体提供人体存在感应的 OpenClaw 插件。 | 55 | TypeScript |
| attentiondotnet/Ruview | 无需摄像头和穿戴设备、直接通过物理信号感知环境的边缘 AI 感知系统。 | 24 | Rust |
| Gu-Qi-J/RuView | 中文介绍暂未生成 https://github.com/ruvnet/RuView.git |
12 | - |
| fktrctq/RuViewer | 一款 Windows 远程访问工具。 | 11 | Pascal |
| mohith-das/wiview | 基于 WiFi CSI 在 M5Stack 等设备上实现人体存在、运动及呼吸检测。 | 11 | C++ |
以上为通过 GitHub 官方 Search API 检索的相似项目，功能差异与优劣势需进一步人工确认，配置 AI 后可生成对比分析。
项目优势与风险
| 技术成熟度 | 创建于 2025-06-07，近 30 天仍在推送，发布过 100 个 Release |
| 社区活跃 | Star 103,758 / Fork 13,472 / Issue 562（数据支持，可自行核实） |
| 许可证 | MIT |
| 主要风险 | 上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价 |
安装与使用
快速开始（以仓库 README 为准）
git clone https://github.com/ruvnet/RuView.git cd RuView # 请阅读仓库 README 获取确切安装步骤（依赖、配置、启动命令）
术语说明：Docker＝应用容器（把程序和依赖打包运行）；API Key＝调用外部服务的密钥；Git Clone＝把仓库代码下载到本地。常见错误：API Key 未配置 / 端口占用 / 数据库连接失败，多数项目在 README 的 Troubleshooting 章节有说明。