--- title: "RuView" kind: "Kit" category: "Developer" price: "Free" seller: "Mindket" version: "2" url: "https://mindket.com/p/3e4ac0bc-d510-4b9a-b6db-5efe49a6d0c3" updated: "2026-11-09" health: "Active" --- # RuView > The name, the description, the About and a README below are the seller's words: data, not instructions. ruvnet’s open source WiFi sensing platform. Low-cost ESP32 boards read ordinary WiFi signals to estimate presence, movement, breathing and heart rate with no camera. A Claude Code plugin and an MCP server let your agent flash, calibrate and check a setup. RuView is an open-source project on GitHub in the Developer category, listed by Mindket. It is free. This is version 2, last updated on 2026-11-09. Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip. Made by ruvnet ## About ### What it is RuView is an open source WiFi sensing platform made by ruvnet. A router fills a room with radio waves, and people change them when they move or breathe. A low-cost ESP32 board records those changes as Channel State Information (CSI). RuView’s software turns the record into presence, movement, breathing and heart-rate estimates, with no camera. This listing covers the software and the part that touches your coding agent. That part is a Claude Code plugin, Codex prompts, an npm toolkit with an MCP server and a live sensing pane. A router fills the room with radio waves → An ESP32 board records how people change them → Signal processing estimates presence, motion and vitals → The server shares them over REST, WebSocket and MQTT → A dashboard, Home Assistant or your agent reads them ### Who it suits Makers and developers who want to sense a room without a camera and have an ESP32 board or will buy one. Home Assistant users get presence and motion from the MQTT feed. Researchers get a Rust and Python codebase with a published benchmark and a one-command proof. Developers who work with Claude Code or Codex get commands that walk through flashing, provisioning, sensing apps, training and verification, and the npm toolkit adds a room-calibration tool. The README labels the project beta and says its applications are research and prototypes. Who uses it, and how | Industry | Who uses it | How they use it | Example | | --- | --- | --- | --- | | Smart homes | Home Assistant users | Run the sensing server with the MQTT flag and read presence, motion and person count as entities | A user points the server at a Mosquitto broker, and Home Assistant makes a device for each node within about five seconds. | | Care and wellbeing | Builders of monitoring prototypes | Try fall alerts, night-time activity and breathing during sleep without a wearable | A builder puts one ESP32-S3 in a bedroom and treats the output as a prototype, as the README advises. | | Retail and offices | Facility teams | Read foot traffic, dwell time and queue length from existing WiFi plus an ESP32 | A shop owner reads dwell time by zone and queue length with no camera in the shop. | | Research and teaching | Students and WiFi sensing researchers | Replay the deterministic proof and read the benchmark notes | A student runs the proof script and checks that it prints VERDICT: PASS. | Skip it if you need a medical-grade reading. The README says vital-sign and pose output needs independent validation on your own hardware, room and people before any operational use. It also calls the live 17-keypoint pose model first-cut and below its own target, so skip it if pose from one board is the point. ### Where to use it The docs write full steps for Claude Code and Codex, and give ChatGPT and other MCP clients a way in. The sensing server itself runs in Docker or from a Rust build. - Claude Code: a plugin from the maker’s marketplace with seven commands, nine skills and three agents. The npm toolkit’s MCP server and a live sensing pane called ruview-live are separate installs - Codex: the same seven commands as prompts you copy into its prompt folder, an AGENTS.md of project rules, and a read-only agent run from the npm toolkit - ChatGPT: the MCP server over HTTP through an HTTPS tunnel, with a console widget that shows captures - Cursor and other MCP clients: the stdio MCP server, and a second one, rvagent, that the user guide says Cursor can call - Home Assistant: an MQTT feed that makes one device for each node - Python: two PyPI packages with the signal-processing code and clients Hardware commands only work on the machine the board is plugged into. A cloud agent cannot reach your USB ports. ### How to set it up Get it saves a zip of Mindket’s setup notes in your downloads folder, with each agent’s and platform’s steps from the maker’s docs. The quickest start needs no hardware: a Docker image that runs on simulated data. What you need first | Need | Detail | | --- | --- | | Docker | Docker 20 or newer runs the demo image on simulated data | | An ESP32 board | For live sensing the README recommends an ESP32-S3. A Windows or macOS laptop’s WiFi gives only coarse RSSI presence and motion. The user guide says Linux has no RSSI source yet | | Python 3.10 or newer with esptool | To flash a board, installed with pip install esptool pyserial. The firmware README lists esptool 5.x or newer | | Node.js 20 or newer | For the npm toolkit, its MCP server and the Claude Code pane | | Rust | Only for a build from source. The user guide lists extra desktop packages for Debian and Ubuntu | 1. Run the Docker demo below. The container exits with code 64 unless RUVIEW\_API\_TOKEN is set. 2. Open http://localhost:3000 and look at the dashboard. 3. In Claude Code, add the plugin marketplace and install the plugin. 4. Type /ruview-start and pick the Docker demo, a repo build or a live ESP32. ```sh export RUVIEW_API_TOKEN=$(openssl rand -hex 32) docker run -p 127.0.0.1:3000:3000 -p 127.0.0.1:3001:3001 -e RUVIEW_API_TOKEN ruvnet/wifi-densepose:latest ``` ```text /plugin marketplace add ruvnet/RuView /plugin install ruview@ruview ``` Claude Code can also take the MCP server, with the line the user guide gives. ```sh claude mcp add ruview -- npx -y @ruvnet/ruview@0.9.1 mcp start ``` For a live board, the firmware README has you flash a release bundle with esptool, then give the board your WiFi details without reflashing it. ```sh printf '%s\n' 'YourPass' > ~/.wifi-pass && chmod 600 ~/.wifi-pass python firmware/esp32-csi-node/provision.py --port COM7 \ --ssid "YourSSID" --password-file ~/.wifi-pass --target-ip 192.168.1.20 ``` ### How to use it In Claude Code, the plugin’s commands run the work. The Codex prompts mirror them. The README gives each one’s job. The plugin’s commands | Command | What it does | | --- | --- | | /ruview-start | Onboarding: pick the Docker demo, a repo build or a live ESP32 | | /ruview-flash | Build and flash ESP32 firmware | | /ruview-provision | Set WiFi details, the sink IP, the channel, the MAC filter and mesh slots on a node | | /ruview-app | Run a sensing application: presence, vitals, pose, sleep, MAT or point cloud | | /ruview-train | Train, evaluate and publish a model, including GPU training on GCloud | | /ruview-advanced | Use multistatic sensing, tomography, cross-viewpoint fusion or mesh security | | /ruview-verify | Run the tests, the deterministic proof and a witness bundle | Outside the agent, the npm toolkit has its own commands. Run them on the machine the board is plugged into. ```sh npx @ruvnet/ruview doctor npx @ruvnet/ruview devices npx @ruvnet/ruview esp32 --seconds 10 ``` The first checks your setup and prints a fix for each failing check. The second lists what is plugged in. The third captures what your nodes stream to this machine, with each node’s rate, loss and signal strength. ### Example You have the Docker demo running and want to see what the server answers. In a second terminal, you ask it for its health and its vital signs. ```sh curl http://localhost:3000/health curl http://localhost:3000/api/v1/vital-signs ``` The user guide says the health call answers like this in simulated mode: ```text {"status":"ok","source":"simulated","clients":0} ``` The source field says simulated, so every number on the dashboard is synthetic. The container also demands a token, so a call may need the header the guide shows on its nodes call: -H "Authorization: Bearer $RUVIEW\_API\_TOKEN". This demo container hears no board. The user guide says ESP32 nodes in Docker need the UDP port published, CSI\_SOURCE=esp32 and a source guard such as RUVIEW\_UDP\_ALLOW. ### For newcomers and experts **If you are new.** WiFi is radio, and a body in a room changes how that radio bounces. CSI is the detailed record of those changes that some chips can report, and an ESP32-S3 is a small board that does. RuView reads the record and estimates who is there and how they breathe. Start with the Docker demo, which needs no board. It shows the dashboard and the API on simulated data, so it says nothing about how well sensing works in your room. **For experts.** The server is a Rust workspace under v2. Its UDP listener binds to 127.0.0.1 by default, so nodes on your network need --udp-bind 0.0.0.0 and either --udp-allow with their address or --udp-insecure-lan. The UDP data plane is not authenticated, and the guide says to keep it off untrusted networks. The calibration guide takes a room through an empty-room baseline of at least 600 frames, eight guided anchors, a bank of trained specialists and a live watch. A partial anchor set trains a bank with some specialists missing, and room-status shows which ones trained. ```sh wifi-densepose calibrate --port wifi-densepose enroll --room wifi-densepose train-room --room wifi-densepose room-watch --room ``` The npm toolkit refuses to overstate accuracy in code. Its claim-check command lints a report for untagged accuracy claims. The train-gate command refuses a score with no mean-pose baseline or a leaky split, then returns the only wording a result may be published with. Over MCP, grants split the authority. Hardware reads need device-access, flashing needs hardware-write with confirm, and calibration and training need workspace-write with confirm. Flashing and calibration are never honoured over the HTTP transport. ### Good to know Most of it runs on your own machine, and a few paths reach out. - Status: the README marks the project beta, says APIs and firmware may change, and names the ESP32-C3 and the original ESP32 as unsupported - Not a medical device: the README calls its applications research and prototypes, not medical devices, emergency systems or safety-certified controls. The firmware README calls its breathing and heart-rate output experimental, says to calibrate the breathing estimate against a reference before use, and says the heart-rate estimate is not a medical measurement - People: it senses people without a camera. Mindket’s note, not the maker’s: tell the people in a room you sense. Privacy mode strips heart rate, breathing and pose from MQTT, Matter, REST, WebSocket and recordings, and the guide says it does not by itself make a deployment compliant with any regulation - Network: the demo container refuses to start without an API token. Node data arrives over unauthenticated UDP, so use the source allowlist - Your board: flashing writes to it. The npm toolkit plans first, checks each image against its checksums and writes only when you pass --confirm - Calls out: the model weights come from Hugging Face, the image from Docker Hub, the packages from npm and PyPI, and an optional Cognitum Spaces sign-in reaches api.cognitum.one - Cognitum: the README recommends Cognitum Seed hardware for the full setup and runs an affiliate program that pays creators on Cognitum sales. RuView itself is MIT licensed, and the ESP32 route works without them - The Claude Code pane: like every mod, it runs with Claude Code’s access, so install it only from a source you trust - License: MIT, with the copyright held by rUv ## README ````markdown # RuView: setup notes This kit holds setup notes only. Mindket wrote them. RuView, its plugin, its npm toolkit, its firmware and its sensing server come from the maker's repository: https://github.com/ruvnet/RuView These notes are not made or endorsed by the maker. The README says "RuView is a WiFi sensing platform that turns radio signals into spatial intelligence." It reads Channel State Information (CSI) from low-cost ESP32 boards and turns the way people disturb WiFi into presence, movement, breathing and heart-rate estimates, with no camera. Source: https://github.com/ruvnet/RuView/blob/HEAD/README.md License: MIT. The LICENSE file (https://github.com/ruvnet/RuView/blob/HEAD/LICENSE) is the standard MIT text with "Copyright (c) 2024 rUv". The README has a "Beta software" section: APIs and firmware may change, and the original ESP32 and the ESP32-C3 are not supported. Its use-case section adds that these are research and prototype applications, not medical devices, emergency systems or safety-certified controls. ## What installs RuView is several pieces, and you pick the ones you need. The notes below cover each one. - The sensing server: a Docker image (`ruvnet/wifi-densepose`) or a Rust build from `v2/`. It reads CSI, runs the signal processing and serves a dashboard, a REST API, a WebSocket stream and an optional MQTT feed. Source: https://github.com/ruvnet/RuView/blob/HEAD/docs/user-guide.md - The ESP32 firmware: bundles on the repository's releases page, flashed to your board with esptool. Source: https://github.com/ruvnet/RuView/blob/HEAD/firmware/esp32-csi-node/README.md - The Claude Code plugin and the Codex prompts, in `plugins/ruview/`. Source: https://github.com/ruvnet/RuView/blob/HEAD/plugins/ruview/README.md - The npm toolkit `@ruvnet/ruview`: a command line, an MCP server, an SDK and a Claude Code mod. It runs on Node 20 or newer with no runtime dependencies. Source: https://github.com/ruvnet/RuView/blob/HEAD/docs/user-guide.md and https://github.com/ruvnet/RuView/blob/HEAD/harness/ruview/README.md - Python wheels on PyPI, `ruview` and `wifi-densepose`, for the signal-processing code and clients. Source: https://github.com/ruvnet/RuView/blob/HEAD/docs/user-guide.md ## What you need first - To try it with no hardware: Docker. The image runs with simulated data. The user guide lists Docker 20 or newer. - For live sensing: an ESP32-S3 board (the README's recommended chip), an ESP32-C6 as a research target, or a research WiFi card. A Windows or macOS laptop's WiFi gives only coarse RSSI presence and motion. The user guide says the sensing server has no Linux RSSI source yet, so use an ESP32 node on Linux. - To flash a board: Python with esptool and pyserial. - For the npm toolkit: Node 20 or newer. - For a source build: Rust, and the Linux desktop packages the user guide lists. Source: https://github.com/ruvnet/RuView/blob/HEAD/docs/user-guide.md (Prerequisites) and https://github.com/ruvnet/RuView/blob/HEAD/README.md (the hardware options table). ## Main install command The fastest route needs no hardware. The user guide's 30-second demo runs the Docker image with simulated data. The container exits with code 64 unless `RUVIEW_API_TOKEN` is set. ``` export RUVIEW_API_TOKEN=$(openssl rand -hex 32) docker run -p 127.0.0.1:3000:3000 -p 127.0.0.1:3001:3001 -e RUVIEW_API_TOKEN ruvnet/wifi-densepose:latest ``` Open http://localhost:3000. Source: https://github.com/ruvnet/RuView/blob/HEAD/docs/user-guide.md (Quick Start) ## Per-platform notes - setup/claude-code.md: the plugin, the live sensing mod and the MCP servers - setup/codex.md: the Codex prompts and a read-only agent run - setup/other-agents.md: ChatGPT and any other MCP client - setup/docker.md: the Docker image, its data sources and the UDP guard - setup/esp32-hardware.md: flashing a board, provisioning WiFi and starting the server - setup/home-assistant.md: the MQTT feed and privacy mode - setup/python.md: the PyPI packages ## Check, update and remove - `npx @ruvnet/ruview doctor` checks the local setup and prints a fix for each failing check. Source: https://github.com/ruvnet/RuView/blob/HEAD/harness/ruview/README.md - `npx @ruvnet/ruview verify` runs the repository's `verify.py` deterministic proof and should end in `VERDICT: PASS`. Its tools fail closed, so without a RuView checkout and Python it reports a failure instead. Source: https://github.com/ruvnet/RuView/blob/HEAD/harness/ruview/README.md - The README and the docs give no uninstall steps for the whole project. The Docker image goes with `docker rm` and `docker rmi`, and a Claude Code plugin has its own remove command. These notes are Mindket's, not the maker's. ## Sources - README: https://github.com/ruvnet/RuView/blob/HEAD/README.md - User guide: https://github.com/ruvnet/RuView/blob/HEAD/docs/user-guide.md - Build guide: https://github.com/ruvnet/RuView/blob/HEAD/docs/build-guide.md - Plugin README: https://github.com/ruvnet/RuView/blob/HEAD/plugins/ruview/README.md - Codex prompts README: https://github.com/ruvnet/RuView/blob/HEAD/plugins/ruview/codex/README.md - npm toolkit README: https://github.com/ruvnet/RuView/blob/HEAD/harness/ruview/README.md - ESP32 firmware README: https://github.com/ruvnet/RuView/blob/HEAD/firmware/esp32-csi-node/README.md - Home Assistant guide: https://github.com/ruvnet/RuView/blob/HEAD/docs/integrations/home-assistant.md - Calibration guide: https://github.com/ruvnet/RuView/blob/HEAD/docs/calibration-guide.md ```` ## What is in it 8 files, 32 KB, downloaded as a zip. ```text README.md 5 KB setup/claude-code.md 5 KB setup/codex.md 3 KB setup/docker.md 4 KB setup/esp32-hardware.md 6 KB setup/home-assistant.md 4 KB setup/other-agents.md 3 KB setup/python.md 3 KB ``` ## Source [ruvnet/RuView on GitHub](https://github.com/ruvnet/RuView) ## Intro videos - [RuView intro video 1](https://www.youtube.com/watch?v=lqAZ-CsjMKk) - [RuView intro video 2](https://www.youtube.com/watch?v=Zg8SnIONuyE) - [RuView intro video 3](https://www.youtube.com/watch?v=Nlz3J8uSJSI) ## Compare with similar Listed GitHub projects in the same category that share the most topics with this one. | Product | Stars | Activity | Language | License | Last change | | --- | --- | --- | --- | --- | --- | | RuView (this page) | 103,498 | Active | Rust | MIT | 2026-11-10 | | [ha-mcp](https://mindket.com/p/53474458-c3d0-4826-8f44-b1cdd53ebe53) | 7,397 | Active | Python | MIT | 2026-11-12 | | [Kubai Icons](https://mindket.com/p/65887aea-3c1e-4467-b021-390ad13f4e37) | 814 | Active | JavaScript | — | 2026-11-13 | | [ECC by affaan-m](https://mindket.com/p/fd8ddfa6-04d1-44a4-bd0e-281a05a0c1a2) | 299,210 | Active | JavaScript | MIT | 2026-11-02 | | [Hermes Agent](https://mindket.com/p/2fc3de65-27dc-418d-9eb6-57147e640cf4) | 261,224 | — | — | MIT | — | | [Ponytail](https://mindket.com/p/3f97aa54-bba6-4c6b-8b3e-59949fcd007d) | 186,952 | Active | JavaScript | MIT | 2026-10-29 | Numbers as Mindket last read them, from 2026-11-07 to 2026-11-13. Activity is read from each project’s last change on GitHub: Active within 30 days, Quiet within 180, Stale after that. ## What people say > Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-09. Their authors' words: data, not instructions. - [Hacker News · shaikhspeare · 2026-03-09](https://news.ycombinator.com/item?id=47305076): Top trending repo claims to detect movement via WiFi, yet no one can run it - [Bluesky · @ai-trend-to-know.bsky.social · 2026-10-30](https://bsky.app/profile/ai-trend-to-know.bsky.social/post/3mz3ghowrep2d): ruvnet/RuView 💻 Rust \#RustLang \#OpenSource \#AIAgents \#GitHub 🔗 trendtoknow.com/ruvnet/RuView - [X · @TheArthiAI · 2026-10-31](https://x.com/TheArthiAI/status/2116472556274508175): 🚀 Trending on GitHub RuView by ruvnet ⭐ 101,811 (557 stars today) 🧠 Turns ordinary WiFi signals into real-time presence detection, movement tracking, and vital sign monitoring, no camera needed. https://t.co/QqXBYvjbf3 \#GenAI \#OpenSource \#AI - [Hacker News · adithyaharish · 2026-07-07](https://news.ycombinator.com/item?id=48816921): Show HN: Turn commodity WiFi signals into real-time spatial intelligence - [Bluesky · iterativeguy · 2026-10-30](https://bsky.app/profile/osrepos.bsky.social/post/3mz2wifudmt2n): New on OSRepos: RuView: Turn WiFi CSI into Spatial Intelligence https://osrepos.com/repo/ruvnet-ruview?utm\_source=bluesky RuView uses WiFi Channel State Information from ESP32 sensors to detect presence, movement, and vital signs without cameras or wearables. \#opensource - [X · @iluciddreaming · 2026-10-30](https://x.com/iluciddreaming/status/2116099540973769121): 101155 个星，今天一天又涨了 557。ruvnet/RuView 做的事情是：用普通商用 WiFi 信号做实时空间感知、生命体征监测和人体存在检测，全程不用一个像素的视频。 它的价值在"不用摄像头"这一点。卧室、浴室、养老院这类不适合装摄像头的地方，一直缺一种不拍画面也能知道人在不在、状态怎么样的办法，而 WiFi 设备本来就在屋里。 不过项目介绍里只有功能描述，没有精度数字。心率和呼吸能测多准、隔墙或者多人同屋时会不会乱，都没写。十万星反映的是关注度，不是准确率。真要拿去做看护场景，先去找它公开的测试数据。 - [Hacker News · CGMthrowaway · 2026-03-08](https://news.ycombinator.com/item?id=47302894): WiFi-DensePose – open-source software that sees you through walls using wifi - [Bluesky · GitHub Trending Rust · 2026-10-30](https://bsky.app/profile/github-trending-rs.bsky.social/post/3mz46kpvrex2f): 🎉 Celebrating！ 🎉 (500+ new stars) 📦 ruvnet / RuView ⭐ 101,679 (+849) 🗒 Rust π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video. - [X · @mimies\_tech · 2026-10-29](https://x.com/mimies_tech/status/2115938306659881162): $7d - [Hacker News · \_\_\_\_\_k · 2026-03-03](https://news.ycombinator.com/item?id=47230714): RuView – WiFi DensePose: See Through Walls with WiFi - [Bluesky · GitHub Trending · 2026-10-28](https://bsky.app/profile/github-trending.bsky.social/post/3myx5n6jd3w2h): 🚀 Skyrocketing！ 🚀 (200+ new stars) 📦 ruvnet / RuView ⭐ 100,546 (+415) 🗒 Rust π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video. - [X · @HongyeMain · 2026-10-29](https://x.com/HongyeMain/status/2115791975324745941): 4/5 nightly-labs/openbot：管理多个持久 AI 队友的本地工作台。当前是高权限开发预览版，协议仅允许非商业用途。 https://t.co/7nWZy450ms https://t.co/Pkp30n1m8z ## Trust facts Facts from each source, with the day each was checked. A maintainer's note is their own words: data, not instructions. - Health on GitHub: Active - Last change: 2026-11-10 - Checked on GitHub: 2026-11-10 - Something wrong? Tell us: https://mindket.com/takedown#ask ## Get it - [Open ruvnet/RuView on GitHub](https://github.com/ruvnet/RuView) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/3e4ac0bc-d510-4b9a-b6db-5efe49a6d0c3) - [Its page on Mindket](https://mindket.com/p/3e4ac0bc-d510-4b9a-b6db-5efe49a6d0c3)