Introducing a new way to review your PRs.

Read the announcement

ruvnet / ruview

π RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.

View on GitHub

13 documents · Updated Nov 19, 2026

overview

Knowledge Base updated: 2026-11-19

Knowledge Base Index

Orientation

ruvnet/ruview is a multi-surface WiFi sensing, spatial intelligence, governance, and Homecore automation repository. The highest-level flow is: hardware/CSI capture and scripts feed WiFi DensePose/Ruview processing, which surfaces results through Rust runtimes, Python bindings, dashboards, integrations, and deployment/observability assets.

Main parts:

  • v2/ Rust workspace — Homecore, Ruview governance/spatial intelligence, WiFi DensePose processing, runtime apps, and neural/model crates.
  • python/ — Python package and Rust extension bindings.
  • dashboard/ and ui/ — TypeScript/Vite and legacy browser UIs for live data, control, and visualization.
  • scripts/, tools/, benchmarks/, data/ — collection, training, replay, benchmark, proof, release, and operational flows.
  • firmware/ and hardware harnesses — embedded ESP32/OpenWrt/PrivShield targets and validation paths.
  • integrations/, plugins/, monitoring/, logging/, wifi-veil/ — external integrations, plugin packaging, observability/deployment, and a standalone subproject.

Critical state is mostly file/workspace based in this repository: datasets and generated fixtures under data/, aether-arena/fixtures/, and benchmark artifacts; model/training and replay inputs under scripts/, benchmarks/, and v2/examples/; operational configuration under monitoring/, logging/, docker/, and integration/plugin directories.

Architecture diagrams

flowchart TD
  subgraph Hardware
    FW[firmware]
    Harness[harness]
  end

  subgraph Processing
    DensePose[v2 wifi-densepose crates]
    Ruview[ruview kernel and spatial crates]
    Homecore[homecore crates]
  end

  subgraph Apps
    Runtime[CLI desktop server WASM]
    Python[python bindings]
    Dashboard[dashboard]
    LegacyUI[ui]
  end

  subgraph Ops
    Scripts[scripts tools benchmarks]
    Integrations[integrations plugins]
    Observability[monitoring logging docker]
    WifiVeil[wifi-veil]
  end

  FW --> Harness
  Harness --> DensePose
  Scripts --> DensePose
  DensePose --> Ruview
  Ruview --> Homecore
  DensePose --> Runtime
  Ruview --> Runtime
  Runtime --> Python
  Runtime --> Dashboard
  Runtime --> LegacyUI
  Runtime --> Integrations
  Observability --> Runtime
  WifiVeil --> Ops
flowchart LR
  CSI[CSI and RF inputs] --> Firmware[ESP32 OpenWrt PrivShield firmware]
  Firmware --> Capture[scripts capture relay replay]
  Capture --> Signal[v2 wifi-densepose signal core engine]
  Signal --> Inference[pose occupancy vitals models]
  Inference --> RuviewState[ruview tracks spatial memory evidence]
  RuviewState --> Apps[servers UI Python integrations]
flowchart TD
  Evidence[observations and evidence] --> Kernel[ruview-kernel]
  Kernel --> Auth[auth attest certify witness]
  Kernel --> Policy[policy scorecard]
  Kernel --> Spatial[fusion track memory twin]
  Policy --> Unified[ruview-unified]
  Spatial --> Unified
  Unified --> Consumers[Homecore apps dashboards integrations]
flowchart LR
  Scripts[collection training scripts] --> Data[data benchmarks fixtures]
  Data --> Train[v2 train nn occworld]
  Train --> Runtime[wifi-densepose runtime crates]
  Runtime --> Web[dashboard and ui]
  Runtime --> Python[python package]
  Runtime --> Deploy[integrations plugins monitoring]

Glossary

  • Ruview — the repository’s core sensing, evidence, governance, and spatial-intelligence system.
  • WiFi DensePose — WiFi/RF-based sensing stack for pose, occupancy, vitals, calibration, and related inference.
  • Homecore — automation/server/plugin platform crates in v2/crates/homecore*.
  • PrivShield — privacy-preserving hardware/firmware and DensePose subsystem used across firmware and wifi-densepose-privshield paths.
  • Aether Arena — calibration/space/ledger assets under aether-arena/ and related DensePose/Ruview support paths.

Codebase-wide invariants

  • The primary Rust workspace is organized under v2/Cargo.toml with member crates in v2/crates/**; separate Rust package surfaces also exist under python/Cargo.toml and wifi-veil/Cargo.toml.
  • Browser-facing code is split between a Vite/TypeScript app in dashboard/ (dashboard/package.json, dashboard/src/**) and a legacy/static UI in ui/ (ui/app.js, ui/components/**, ui/services/**).
  • Operational flows are script-first and live mostly under scripts/**, with root orchestration helpers in Makefile, install.sh, deploy.sh, and verify.
  • Embedded and hardware-specific code is separated from desktop/server runtimes under firmware/**, with validation and QEMU helpers in scripts/qemu*.sh, scripts/qemu_swarm.py, and ESP32-related scripts.

Routing table