Introduction
RuView is an open-source AI WiFi sensing platform. This documentation is a community-maintained reference; always cross-check with the official GitHub.
Documentation
RuView docs
Get up and running with RuView in under an hour.
Installation Overview
Clone the RuView repository, install build dependencies, and prepare your ESP32 toolchain (ESP-IDF).
Hardware Requirements
ESP32 / ESP32-S3 board, USB cable, a WiFi access point, and optionally a small host machine for visualization.
ESP32 CSI Setup
Flash CSI-capable firmware, set a fixed WiFi channel, and verify CSI packets arriving via serial.
WiFi Node Setup
Configure transmitter and receiver roles, define sensing geometry, and place nodes around the target area.
Running the System
Start the CSI collector, launch the preprocessing pipeline, then run the inference model.
Signal Visualization
Use the included dashboard to inspect CSI heatmaps, motion timelines, and detection events.
Troubleshooting
If CSI packets are missing, check IDF version, antenna placement, and WiFi channel conflicts.
Common Errors
Mismatched channels, antenna saturation, model input shape mismatches, and noisy environments.
Limitations
WiFi sensing is probabilistic and environment-sensitive. Treat results as estimates, not measurements.
FAQ
See our dedicated FAQ page for common questions.
GitHub Reference
Always consult github.com/ruvnet/RuView for canonical instructions and latest releases.