RuView Applications
What RuView can sense, and how to run each one. Assumes you have either the Docker demo (simulated CSI) or a live ESP32 sink (see ruview-quickstart / ruview-hardware-setup).
Application catalogue
| Application |
What it does |
Entry point |
| Presence / occupancy |
Detect people through walls, count them, track entries/exits (trained model + PIR fusion, ~0.012 ms latency) |
sensing-server live mode; examples/environment/ |
| Vital signs |
Breathing 6–30 BPM (bandpass 0.1–0.5 Hz), heart rate 40–120 BPM (bandpass 0.8–2.0 Hz), contactless while sleeping/sitting |
wifi-densepose-vitals crate (ADR-021); examples/medical/ |
| Activity recognition |
Walking, sitting, gestures, falls — from temporal CSI patterns |
RuvSense gesture.rs (DTW), pose_tracker.rs; scripts/gait-analyzer.js |
| Pose estimation |
17 COCO keypoints via WiFlow architecture; dual-modal webcam+WiFi fusion demo |
cargo run -p wifi-densepose-sensing-server + pose-fusion demo (ADR-059); see ruview-model-training to train |
| Sleep monitoring |
Overnight monitoring, sleep-stage classification, apnea screening |
examples/sleep/; scripts/apnea-detector.js |
| Environment mapping |
RF fingerprinting identifies rooms, detects moved furniture, spots new objects |
sensing-server --build-index env; RuvSense field_model.rs, cross_room.rs |
| Mass Casualty Assessment (MAT) |
Disaster survivor detection — find people in rubble/smoke |
wifi-densepose-mat crate; docs/wifi-mat-user-guide.md; examples/medical/ |
| 3D point cloud (optional fusion) |
Camera depth (MiDaS) + WiFi CSI + mmWave radar → unified spatial model (~22 ms, 19K+ pts/frame) |
scripts/mmwave_fusion_bridge.py; ADR-094 (GitHub Pages deploy) |
| Novel RF apps |
Passive radar, material classification, device fingerprinting, mincut person-counting |
scripts/passive-radar.js, material-classifier.js, device-fingerprint.js, mincut-person-counter.js (ADR-077/078) |
Quick recipes
# Docker demo — everything, simulated CSI
docker run -p 3000:3000 ruvnet/wifi-densepose:latest # http://localhost:3000
# Live sensing server (consumes ESP32 UDP CSI)
cd v2 && cargo run -p wifi-densepose-sensing-server
# Live RF room scan (Cognitum Seed on :5006)
node scripts/rf-scan.js --port 5006
node scripts/snn-csi-processor.js --port 5006
# Embed a trained model + build an environment index
cd v2
cargo run -p wifi-densepose-sensing-server -- --model model.rvf --embed
cargo run -p wifi-densepose-sensing-server -- --model model.rvf --build-index env
# Python live demo
python examples/ruview_live.py
# Spectrogram / graph visualisers
node scripts/csi-spectrogram.js
node scripts/csi-graph-visualizer.js
Picking the right modality
- Through a wall, no line of sight → presence + activity; expect ≤5 m depth (Fresnel-zone geometry).
- Person stationary (sleeping / sitting) → vitals (breathing first, heart rate needs cleaner signal) + sleep staging.
- Need skeletons → pose (WiFlow). Camera-free works but is modest; camera-supervised gets 92.9% PCK@20 — train it (
ruview-model-training).
- Search & rescue → MAT (
docs/wifi-mat-user-guide.md).
- "What changed in this room?" → environment mapping / RF fingerprint index.
- Best spatial accuracy → 2+ ESP32 nodes + cross-viewpoint fusion (
ruview-advanced-sensing), optionally + Cognitum Seed.
Examples directory map
examples/environment/ · examples/medical/ · examples/sleep/ · examples/stress/ · examples/happiness-vector/ · examples/ruview_live.py — each has a README.
Reference
README.md — feature matrix, latency/throughput numbers
docs/user-guide.md, docs/wifi-mat-user-guide.md
- ADRs: 021 (vitals), 024 (AETHER contrastive embeddings), 027 (MERIDIAN domain generalization), 041 (edge modules), 059 (live ESP32 pipeline), 077/078 (novel RF apps), 082 (pose tracker output filter), 094 (point cloud)
- RuvSense modules:
v2/crates/wifi-densepose-signal/src/ruvsense/ (14 modules)
Source: ruvnet/RuView → plugins/ruview/skills/ruview-applications/SKILL.md
1---2name: ruview-applications3description: "Run RuView sensing applications — presence/occupancy, breathing & heart rate, activity & fall detection, 17-keypoint pose estimation (WiFlow), sleep monitoring & apnea screening, environment mapping, Mass Casualty Assessment (MAT), and the 3D point-cloud fusion demo. Use when someone wants to actually *do* something with a working RuView setup."4allowed-tools: "Bash Read Write Edit Glob Grep"5category: devops-and-infra6source_repo: ruvnet/RuView7source_path: "plugins/ruview/skills/ruview-applications/SKILL.md"8source_url: https://github.com/ruvnet/RuView/blob/HEAD/plugins/ruview/skills/ruview-applications/SKILL.md9metadata:10 source: https://skillmd.com/skills/ruvnet/ruview-applications11---121314# RuView Applications1516What RuView can sense, and how to run each one. Assumes you have either the Docker demo (simulated CSI) or a live ESP32 sink (see `ruview-quickstart` / `ruview-hardware-setup`).1718## Application catalogue1920| Application | What it does | Entry point |21|-------------|--------------|-------------|22| **Presence / occupancy** | Detect people through walls, count them, track entries/exits (trained model + PIR fusion, ~0.012 ms latency) | sensing-server live mode; `examples/environment/` |23| **Vital signs** | Breathing 6–30 BPM (bandpass 0.1–0.5 Hz), heart rate 40–120 BPM (bandpass 0.8–2.0 Hz), contactless while sleeping/sitting | `wifi-densepose-vitals` crate (ADR-021); `examples/medical/` |24| **Activity recognition** | Walking, sitting, gestures, falls — from temporal CSI patterns | RuvSense `gesture.rs` (DTW), `pose_tracker.rs`; `scripts/gait-analyzer.js` |25| **Pose estimation** | 17 COCO keypoints via WiFlow architecture; dual-modal webcam+WiFi fusion demo | `cargo run -p wifi-densepose-sensing-server` + pose-fusion demo (ADR-059); see `ruview-model-training` to train |26| **Sleep monitoring** | Overnight monitoring, sleep-stage classification, apnea screening | `examples/sleep/`; `scripts/apnea-detector.js` |27| **Environment mapping** | RF fingerprinting identifies rooms, detects moved furniture, spots new objects | sensing-server `--build-index env`; RuvSense `field_model.rs`, `cross_room.rs` |28| **Mass Casualty Assessment (MAT)** | Disaster survivor detection — find people in rubble/smoke | `wifi-densepose-mat` crate; `docs/wifi-mat-user-guide.md`; `examples/medical/` |29| **3D point cloud** *(optional fusion)* | Camera depth (MiDaS) + WiFi CSI + mmWave radar → unified spatial model (~22 ms, 19K+ pts/frame) | `scripts/mmwave_fusion_bridge.py`; ADR-094 (GitHub Pages deploy) |30| **Novel RF apps** | Passive radar, material classification, device fingerprinting, mincut person-counting | `scripts/passive-radar.js`, `material-classifier.js`, `device-fingerprint.js`, `mincut-person-counter.js` (ADR-077/078) |3132## Quick recipes3334```bash35# Docker demo — everything, simulated CSI36docker run -p 3000:3000 ruvnet/wifi-densepose:latest # http://localhost:30003738# Live sensing server (consumes ESP32 UDP CSI)39cd v2 && cargo run -p wifi-densepose-sensing-server4041# Live RF room scan (Cognitum Seed on :5006)42node scripts/rf-scan.js --port 500643node scripts/snn-csi-processor.js --port 50064445# Embed a trained model + build an environment index46cd v247cargo run -p wifi-densepose-sensing-server -- --model model.rvf --embed48cargo run -p wifi-densepose-sensing-server -- --model model.rvf --build-index env4950# Python live demo51python examples/ruview_live.py5253# Spectrogram / graph visualisers54node scripts/csi-spectrogram.js55node scripts/csi-graph-visualizer.js56```5758## Picking the right modality5960- **Through a wall, no line of sight** → presence + activity; expect ≤5 m depth (Fresnel-zone geometry).61- **Person stationary (sleeping / sitting)** → vitals (breathing first, heart rate needs cleaner signal) + sleep staging.62- **Need skeletons** → pose (WiFlow). Camera-free works but is modest; camera-supervised gets 92.9% PCK@20 — train it (`ruview-model-training`).63- **Search & rescue** → MAT (`docs/wifi-mat-user-guide.md`).64- **"What changed in this room?"** → environment mapping / RF fingerprint index.65- **Best spatial accuracy** → 2+ ESP32 nodes + cross-viewpoint fusion (`ruview-advanced-sensing`), optionally + Cognitum Seed.6667## Examples directory map6869`examples/environment/` · `examples/medical/` · `examples/sleep/` · `examples/stress/` · `examples/happiness-vector/` · `examples/ruview_live.py` — each has a README.7071## Reference7273- `README.md` — feature matrix, latency/throughput numbers74- `docs/user-guide.md`, `docs/wifi-mat-user-guide.md`75- ADRs: 021 (vitals), 024 (AETHER contrastive embeddings), 027 (MERIDIAN domain generalization), 041 (edge modules), 059 (live ESP32 pipeline), 077/078 (novel RF apps), 082 (pose tracker output filter), 094 (point cloud)76- RuvSense modules: `v2/crates/wifi-densepose-signal/src/ruvsense/` (14 modules)7778---7980**Source:** [`ruvnet/RuView`](https://github.com/ruvnet/RuView) → `plugins/ruview/skills/ruview-applications/SKILL.md`