📡 RuView
用普通 WiFi 信号实现空间智能感知，零摄像头、零穿戴设备
⭐ 76,620+ Stars
🦀 Rust 核心引擎
📅 2025年创建
📜 MIT 开源
🔒 隐私优先
🦀 Rust 核心引擎
📅 2025年创建
📜 MIT 开源
🔒 隐私优先
🎯 项目简介
RuView 是一个革命性的无接触式 WiFi 感知平台，由 ruvnet 团队开发。它利用普通商用 WiFi 信号（ESP32 芯片或家用路由器）实现实时空间智能、生命体征监测和人员存在检测——全程无需摄像头、无需可穿戴设备，从根源上杜绝隐私泄露风险。
RuView 是一个革命性的无接触式 WiFi 感知平台，由 ruvnet 团队开发。它利用普通商用 WiFi 信号（ESP32 芯片或家用路由器）实现实时空间智能、生命体征监测和人员存在检测——全程无需摄像头、无需可穿戴设备，从根源上杜绝隐私泄露风险。
🚀 核心功能
📍 空间感知
- 穿墙人员检测（可穿透墙壁）
- 多房间人数统计
- 人员进出记录与追踪
- 17 关键点人体姿态估计
💓 生命体征监测
- 无接触呼吸率检测（6-30 BPM，精度 ±1）
- 心率监测（40-120 BPM）
- 整夜睡眠监测 + 呼吸暂停筛查
- 支持静坐、睡眠、运动状态
🏠 智能家居集成
- 原生支持 Apple HomeKit
- 对接 Home Assistant（21 个实体）
- 支持 Google Home / Alexa
- 通过 Siri 查询房间状态
🤖 AI 智能体集成
- 标准 MCP 协议接口
- 支持 Claude Code / Codex 调用
- Python / TypeScript SDK
- 105+ 开箱即用边缘模块
⚙️ 安装要求与环境
| 项目 | 要求 |
|---|---|
| 核心语言 | Rust 1.85+（感知引擎）、Python 3.10+（SDK/脚本） |
| 硬件选项 | ESP32-S3（~$9）/ ESP32-C6（~$6）/ 普通家用 WiFi 路由器 |
| 内存要求 | 最低 512MB RAM（树莓派可运行） |
| 许可协议 | MIT License（完全开源可商用） |
| 支持平台 | Docker / macOS / Windows / Linux / Home Assistant |
📦 快速安装步骤
方式一：Docker 快速体验（推荐新手）
# 拉取官方镜像 docker pull ruvnet/wifi-densepose:latest # 启动服务，访问 http://localhost:3000 docker run -p 3000:3000 ruvnet/wifi-densepose:latest
方式二：npm 包安装（AI 集成推荐）
# 安装核心 CLI 工具 npx -y @ruvnet/ruview # 安装智能体 MCP 服务包 npx -y @ruvnet/rvagent
方式三：Python SDK（二次开发）
pip install ruview # 可选：安装 WebSocket + MQTT 客户端扩展 pip install "ruview[client]"
方式四：ESP32 硬件部署（最低成本 $9）
# 1. 烧录固件（替换 COM9 为你的设备端口） python -m esptool --chip esp32s3 --port COM9 --baud 460800 \ write_flash 0x0 bootloader.bin 0x8000 partition-table.bin \ 0xf000 ota_data_initial.bin 0x20000 esp32-csi-node.bin # 2. 配置 WiFi 和上报地址 python firmware/esp32-csi-node/provision.py --port COM9 \ --ssid "你的WiFi名称" --password "WiFi密码" --target-ip 上报服务器IP
💡 典型使用场景
场景一：智能家居无感联动
将 RuView 接入 Home Assistant 后，可自动暴露 21 个实体（11 个原始信号 + 10 个语义状态），实现：
- 🏠 人员存在触发：有人进入房间自动开灯、开空调
- 😴 睡眠监测：检测入睡后自动关闭灯光、开启白噪音
- 👴 老人看护：异常长时间无移动自动推送告警
- 🚿 浴室占用：检测浴室有人时自动开启排气扇
通过 Siri 可语音查询：”嘿 Siri，卧室有没有人？”
场景二：隐私优先的安防监控
传统安防摄像头存在隐私泄露风险，且无法穿墙感知。RuView 的优势：
- 📡 穿墙感知：WiFi 信号可穿透木质/石膏板墙壁
- 🔒 零视频采集：从根源上避免隐私泄露，符合 GDPR/HIPAA 监管
- 🌙 黑暗环境工作：无需任何光照条件
- 💰 极低成本：ESP32 芯片约 $9，远低于热成像方案
配套边缘模块 intrusion（非法入侵检测）、perimeter-breach（周界入侵检测）可直接使用。
场景三：AI 智能体调用（MCP 协议）
在 Claude Code 中配置 RuView MCP 服务后，可直接通过自然语言查询：
> "现在客厅有没有人？呼吸和心率正常吗？" > 智能体会自动调用 ruview.presence.now、ruview.vitals.get_all 接口返回结果。 > "帮我统计今天各房间的人员进出记录" > 自动生成日报，包含各时段人员分布热力图。
RuView 提供标准 MCP 接口，支持 Claude Code / Codex / Cursor 等主流 AI 编程助手。
🌟 推荐理由
为什么 RuView 值得关注？
- 🔬 技术原理极其优雅：利用 WiFi 信号在空间中传播的 CSI（信道状态信息），通过反射、折射和散射特征推断人体状态。整个过程完全在本地处理，原始 CSI 数据不会上传云端。
- 🔒 隐私保护从设计开始：与摄像头方案根本不同——RuView 不产生任何视频/图像数据。支持 BFLD 隐私分级，可配置仅输出匿名化结果。对于医院、养老院、卧室等隐私敏感场景，这是唯一合规的智能化方案。
- 💰 成本极低、部署简单：ESP32-S3 芯片约 $9，加上普通家用路由器即可搭建完整系统。Docker 一键启动，npm 包即装即用。相比毫米波雷达、热成像等方案，成本降低 10 倍以上。
- 🏠 智能家居生态原生支持：Apple HomeKit、Home Assistant、Google Home、Amazon Alexa 四大生态全覆盖。接入后自动暴露 21 个实体，配套 3 个 HA 自动化蓝图，真正实现”即插即用”。
- 🤖 AI 智能体时代的最佳拍档：提供标准 MCP 协议接口，可被 Claude Code、Codex 等各类 AI 智能体调用。预训练模型已发布在 HuggingFace（
ruvnet/wifi-densepose-pretrained），开箱即用。
个人使用心得：RuView 代表了一个重要趋势——空间计算 + 隐私优先的融合。在 AI 智能体全面渗透的 2026 年，RuView 让”感知层”变得触手可及。如果你在搭建智能家居、做健康监测产品、或研究 WiFi 感知技术，这个项目绝对值得深入研究。
📥 下载地址
📌 技术笔记
- 项目仍处于 Beta 阶段，API 和固件可能会有变动
- 预训练模型量化后最小仅 4KB，可在树莓派上微秒级运行
- 提供 105 个开箱即用的边缘模块，涵盖健康、安防、楼宇、零售等场景
- 支持 182 篇架构决策记录（ADR），适合学习系统设计
- GitHub 趋势榜常客，14 天克隆量达 27,887 次
标签: #RuView #WiFi感知 #空间智能 #智能家居 #隐私优先 #Rust #MIT许可 #AI开源