feat: Add guided installer with hardware detection and RVF build profiles
- install.sh: 7-step interactive installer detecting system, toolchains, WiFi hardware (interfaces, ESP32 USB, Intel CSI debug), and recommending the best build profile (verify/python/rust/browser/iot/docker/field/full) - Rust is the primary recommended runtime (810x faster than Python) - Makefile: 15+ targets including make install, make check, make build-rust, make build-wasm, make bench, make run-api, make run-viz - README: Updated installation section with Rust-primary ordering, removed mock testing references, added v2.2.0 changelog entry https://claude.ai/code/session_01Ki7pvEZtJDvqJkmyn6B714
This commit is contained in:
Claude
@@ -1,23 +1,23 @@
|
|||||||
{
|
{
|
||||||
"running": true,
|
"running": true,
|
||||||
"startedAt": "2026-02-28T05:42:41.387Z",
|
"startedAt": "2026-02-28T13:34:03.423Z",
|
||||||
"workers": {
|
"workers": {
|
||||||
"map": {
|
"map": {
|
||||||
"runCount": 40,
|
"runCount": 41,
|
||||||
"successCount": 40,
|
"successCount": 41,
|
||||||
"failureCount": 0,
|
"failureCount": 0,
|
||||||
"averageDurationMs": 1.1500000000000001,
|
"averageDurationMs": 1.1707317073170733,
|
||||||
"lastRun": "2026-02-28T09:12:41.502Z",
|
"lastRun": "2026-02-28T13:34:03.434Z",
|
||||||
"nextRun": "2026-02-28T09:12:41.494Z",
|
"nextRun": "2026-02-28T13:49:03.434Z",
|
||||||
"isRunning": false
|
"isRunning": false
|
||||||
},
|
},
|
||||||
"audit": {
|
"audit": {
|
||||||
"runCount": 35,
|
"runCount": 36,
|
||||||
"successCount": 0,
|
"successCount": 0,
|
||||||
"failureCount": 35,
|
"failureCount": 36,
|
||||||
"averageDurationMs": 0,
|
"averageDurationMs": 0,
|
||||||
"lastRun": "2026-02-28T09:04:41.452Z",
|
"lastRun": "2026-02-28T13:41:03.432Z",
|
||||||
"nextRun": "2026-02-28T09:14:41.452Z",
|
"nextRun": "2026-02-28T13:51:03.432Z",
|
||||||
"isRunning": false
|
"isRunning": false
|
||||||
},
|
},
|
||||||
"optimize": {
|
"optimize": {
|
||||||
@@ -26,16 +26,16 @@
|
|||||||
"failureCount": 27,
|
"failureCount": 27,
|
||||||
"averageDurationMs": 0,
|
"averageDurationMs": 0,
|
||||||
"lastRun": "2026-02-28T09:11:41.441Z",
|
"lastRun": "2026-02-28T09:11:41.441Z",
|
||||||
"nextRun": "2026-02-28T09:26:41.441Z",
|
"nextRun": "2026-02-28T13:38:03.426Z",
|
||||||
"isRunning": false
|
"isRunning": true
|
||||||
},
|
},
|
||||||
"consolidate": {
|
"consolidate": {
|
||||||
"runCount": 18,
|
"runCount": 19,
|
||||||
"successCount": 18,
|
"successCount": 19,
|
||||||
"failureCount": 0,
|
"failureCount": 0,
|
||||||
"averageDurationMs": 0.6111111111111112,
|
"averageDurationMs": 0.631578947368421,
|
||||||
"lastRun": "2026-02-28T08:49:41.451Z",
|
"lastRun": "2026-02-28T13:41:03.438Z",
|
||||||
"nextRun": "2026-02-28T09:18:41.402Z",
|
"nextRun": "2026-02-28T14:10:03.427Z",
|
||||||
"isRunning": false
|
"isRunning": false
|
||||||
},
|
},
|
||||||
"testgaps": {
|
"testgaps": {
|
||||||
@@ -44,7 +44,7 @@
|
|||||||
"failureCount": 22,
|
"failureCount": 22,
|
||||||
"averageDurationMs": 0,
|
"averageDurationMs": 0,
|
||||||
"lastRun": "2026-02-28T09:10:41.422Z",
|
"lastRun": "2026-02-28T09:10:41.422Z",
|
||||||
"nextRun": "2026-02-28T09:30:41.423Z",
|
"nextRun": "2026-02-28T13:42:03.426Z",
|
||||||
"isRunning": false
|
"isRunning": false
|
||||||
},
|
},
|
||||||
"predict": {
|
"predict": {
|
||||||
@@ -131,5 +131,5 @@
|
|||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
"savedAt": "2026-02-28T09:12:41.503Z"
|
"savedAt": "2026-02-28T13:41:03.438Z"
|
||||||
}
|
}
|
||||||
@@ -1 +1 @@
|
|||||||
211
|
166
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
{
|
{
|
||||||
"timestamp": "2026-02-28T09:12:41.502Z",
|
"timestamp": "2026-02-28T13:34:03.432Z",
|
||||||
"projectRoot": "/home/user/wifi-densepose",
|
"projectRoot": "/home/user/wifi-densepose",
|
||||||
"structure": {
|
"structure": {
|
||||||
"hasPackageJson": false,
|
"hasPackageJson": false,
|
||||||
@@ -7,5 +7,5 @@
|
|||||||
"hasClaudeConfig": true,
|
"hasClaudeConfig": true,
|
||||||
"hasClaudeFlow": true
|
"hasClaudeFlow": true
|
||||||
},
|
},
|
||||||
"scannedAt": 1772269961502
|
"scannedAt": 1772285643433
|
||||||
}
|
}
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
{
|
{
|
||||||
"timestamp": "2026-02-28T08:49:41.450Z",
|
"timestamp": "2026-02-28T13:41:03.437Z",
|
||||||
"patternsConsolidated": 0,
|
"patternsConsolidated": 0,
|
||||||
"memoryCleaned": 0,
|
"memoryCleaned": 0,
|
||||||
"duplicatesRemoved": 0
|
"duplicatesRemoved": 0
|
||||||
|
|||||||
107
Makefile
107
Makefile
@@ -1,8 +1,42 @@
|
|||||||
# WiFi-DensePose Makefile
|
# WiFi-DensePose Makefile
|
||||||
# ============================================================
|
# ============================================================
|
||||||
|
|
||||||
.PHONY: verify verify-verbose verify-audit help
|
.PHONY: verify verify-verbose verify-audit install install-verify install-python \
|
||||||
|
install-rust install-browser install-docker install-field install-full \
|
||||||
|
check build-rust build-wasm test-rust bench run-api run-viz clean help
|
||||||
|
|
||||||
|
# ─── Installation ────────────────────────────────────────────
|
||||||
|
# Guided interactive installer
|
||||||
|
install:
|
||||||
|
@./install.sh
|
||||||
|
|
||||||
|
# Profile-specific installs (non-interactive)
|
||||||
|
install-verify:
|
||||||
|
@./install.sh --profile verify --yes
|
||||||
|
|
||||||
|
install-python:
|
||||||
|
@./install.sh --profile python --yes
|
||||||
|
|
||||||
|
install-rust:
|
||||||
|
@./install.sh --profile rust --yes
|
||||||
|
|
||||||
|
install-browser:
|
||||||
|
@./install.sh --profile browser --yes
|
||||||
|
|
||||||
|
install-docker:
|
||||||
|
@./install.sh --profile docker --yes
|
||||||
|
|
||||||
|
install-field:
|
||||||
|
@./install.sh --profile field --yes
|
||||||
|
|
||||||
|
install-full:
|
||||||
|
@./install.sh --profile full --yes
|
||||||
|
|
||||||
|
# Hardware and environment check only (no install)
|
||||||
|
check:
|
||||||
|
@./install.sh --check-only
|
||||||
|
|
||||||
|
# ─── Verification ────────────────────────────────────────────
|
||||||
# Trust Kill Switch -- one-command proof replay
|
# Trust Kill Switch -- one-command proof replay
|
||||||
verify:
|
verify:
|
||||||
@./verify
|
@./verify
|
||||||
@@ -15,12 +49,75 @@ verify-verbose:
|
|||||||
verify-audit:
|
verify-audit:
|
||||||
@./verify --verbose --audit
|
@./verify --verbose --audit
|
||||||
|
|
||||||
|
# ─── Rust Builds ─────────────────────────────────────────────
|
||||||
|
build-rust:
|
||||||
|
cd rust-port/wifi-densepose-rs && cargo build --release
|
||||||
|
|
||||||
|
build-wasm:
|
||||||
|
cd rust-port/wifi-densepose-rs && wasm-pack build crates/wifi-densepose-wasm --target web --release
|
||||||
|
|
||||||
|
build-wasm-mat:
|
||||||
|
cd rust-port/wifi-densepose-rs && wasm-pack build crates/wifi-densepose-wasm --target web --release -- --features mat
|
||||||
|
|
||||||
|
test-rust:
|
||||||
|
cd rust-port/wifi-densepose-rs && cargo test --workspace
|
||||||
|
|
||||||
|
bench:
|
||||||
|
cd rust-port/wifi-densepose-rs && cargo bench --package wifi-densepose-signal
|
||||||
|
|
||||||
|
# ─── Run ─────────────────────────────────────────────────────
|
||||||
|
run-api:
|
||||||
|
uvicorn v1.src.api.main:app --host 0.0.0.0 --port 8000
|
||||||
|
|
||||||
|
run-api-dev:
|
||||||
|
uvicorn v1.src.api.main:app --host 0.0.0.0 --port 8000 --reload
|
||||||
|
|
||||||
|
run-viz:
|
||||||
|
python3 -m http.server 3000 --directory ui
|
||||||
|
|
||||||
|
run-docker:
|
||||||
|
docker compose up
|
||||||
|
|
||||||
|
# ─── Clean ───────────────────────────────────────────────────
|
||||||
|
clean:
|
||||||
|
rm -f .install.log
|
||||||
|
cd rust-port/wifi-densepose-rs && cargo clean 2>/dev/null || true
|
||||||
|
|
||||||
|
# ─── Help ────────────────────────────────────────────────────
|
||||||
help:
|
help:
|
||||||
@echo "WiFi-DensePose Build Targets"
|
@echo "WiFi-DensePose Build Targets"
|
||||||
@echo "============================================================"
|
@echo "============================================================"
|
||||||
@echo ""
|
@echo ""
|
||||||
@echo " make verify Run the trust kill switch (proof replay)"
|
@echo " Installation:"
|
||||||
@echo " make verify-verbose Verbose mode with feature details"
|
@echo " make install Interactive guided installer"
|
||||||
@echo " make verify-audit Full verification + codebase audit"
|
@echo " make install-verify Verification only (~5 MB)"
|
||||||
@echo " make help Show this help"
|
@echo " make install-python Full Python pipeline (~500 MB)"
|
||||||
|
@echo " make install-rust Rust pipeline with ~810x speedup"
|
||||||
|
@echo " make install-browser WASM for browser (~10 MB)"
|
||||||
|
@echo " make install-docker Docker-based deployment"
|
||||||
|
@echo " make install-field WiFi-Mat disaster kit (~62 MB)"
|
||||||
|
@echo " make install-full Everything available"
|
||||||
|
@echo " make check Hardware/environment check only"
|
||||||
|
@echo ""
|
||||||
|
@echo " Verification:"
|
||||||
|
@echo " make verify Run the trust kill switch"
|
||||||
|
@echo " make verify-verbose Verbose with feature details"
|
||||||
|
@echo " make verify-audit Full verification + codebase audit"
|
||||||
|
@echo ""
|
||||||
|
@echo " Build:"
|
||||||
|
@echo " make build-rust Build Rust workspace (release)"
|
||||||
|
@echo " make build-wasm Build WASM package (browser)"
|
||||||
|
@echo " make build-wasm-mat Build WASM with WiFi-Mat (field)"
|
||||||
|
@echo " make test-rust Run all Rust tests"
|
||||||
|
@echo " make bench Run signal processing benchmarks"
|
||||||
|
@echo ""
|
||||||
|
@echo " Run:"
|
||||||
|
@echo " make run-api Start Python API server"
|
||||||
|
@echo " make run-api-dev Start API with hot-reload"
|
||||||
|
@echo " make run-viz Serve 3D visualization (port 3000)"
|
||||||
|
@echo " make run-docker Start Docker dev stack"
|
||||||
|
@echo ""
|
||||||
|
@echo " Utility:"
|
||||||
|
@echo " make clean Remove build artifacts"
|
||||||
|
@echo " make help Show this help"
|
||||||
@echo ""
|
@echo ""
|
||||||
|
|||||||
128
README.md
128
README.md
@@ -152,8 +152,10 @@ cargo test --package wifi-densepose-mat
|
|||||||
- [WiFi-Mat Disaster Response](#-wifi-mat-disaster-response-module)
|
- [WiFi-Mat Disaster Response](#-wifi-mat-disaster-response-module)
|
||||||
- [System Architecture](#️-system-architecture)
|
- [System Architecture](#️-system-architecture)
|
||||||
- [Installation](#-installation)
|
- [Installation](#-installation)
|
||||||
- [Using pip (Recommended)](#using-pip-recommended)
|
- [Guided Installer (Recommended)](#guided-installer-recommended)
|
||||||
- [From Source](#from-source)
|
- [Install Profiles](#install-profiles)
|
||||||
|
- [From Source (Rust)](#from-source-rust--primary)
|
||||||
|
- [From Source (Python)](#from-source-python)
|
||||||
- [Using Docker](#using-docker)
|
- [Using Docker](#using-docker)
|
||||||
- [System Requirements](#system-requirements)
|
- [System Requirements](#system-requirements)
|
||||||
- [Quick Start](#-quick-start)
|
- [Quick Start](#-quick-start)
|
||||||
@@ -189,7 +191,7 @@ cargo test --package wifi-densepose-mat
|
|||||||
- [Testing](#-testing)
|
- [Testing](#-testing)
|
||||||
- [Running Tests](#running-tests)
|
- [Running Tests](#running-tests)
|
||||||
- [Test Categories](#test-categories)
|
- [Test Categories](#test-categories)
|
||||||
- [Mock Testing](#mock-testing)
|
- [Testing Without Hardware](#testing-without-hardware)
|
||||||
- [Continuous Integration](#continuous-integration)
|
- [Continuous Integration](#continuous-integration)
|
||||||
- [Deployment](#-deployment)
|
- [Deployment](#-deployment)
|
||||||
- [Production Deployment](#production-deployment)
|
- [Production Deployment](#production-deployment)
|
||||||
@@ -266,24 +268,73 @@ WiFi DensePose consists of several key components working together:
|
|||||||
|
|
||||||
## 📦 Installation
|
## 📦 Installation
|
||||||
|
|
||||||
### Using pip (Recommended)
|
### Guided Installer (Recommended)
|
||||||
|
|
||||||
WiFi-DensePose is now available on PyPI for easy installation:
|
The interactive installer detects your hardware, checks your environment, and builds the right profile automatically:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install the latest stable version
|
./install.sh
|
||||||
pip install wifi-densepose
|
|
||||||
|
|
||||||
# Install with specific version
|
|
||||||
pip install wifi-densepose==1.0.0
|
|
||||||
|
|
||||||
# Install with optional dependencies
|
|
||||||
pip install wifi-densepose[gpu] # For GPU acceleration
|
|
||||||
pip install wifi-densepose[dev] # For development
|
|
||||||
pip install wifi-densepose[all] # All optional dependencies
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### From Source
|
It walks through 7 steps:
|
||||||
|
1. **System detection** — OS, RAM, disk, GPU
|
||||||
|
2. **Toolchain detection** — Python, Rust, Docker, Node.js, ESP-IDF
|
||||||
|
3. **WiFi hardware detection** — interfaces, ESP32 USB, Intel CSI debug
|
||||||
|
4. **Profile recommendation** — picks the best profile for your hardware
|
||||||
|
5. **Dependency installation** — installs what's missing
|
||||||
|
6. **Build** — compiles the selected profile
|
||||||
|
7. **Summary** — shows next steps and verification commands
|
||||||
|
|
||||||
|
#### Install Profiles
|
||||||
|
|
||||||
|
| Profile | What it installs | Size | Requirements |
|
||||||
|
|---------|-----------------|------|-------------|
|
||||||
|
| `verify` | Pipeline verification only | ~5 MB | Python 3.8+ |
|
||||||
|
| `python` | Full Python API server + sensing | ~500 MB | Python 3.8+ |
|
||||||
|
| `rust` | Rust pipeline (~810x faster) | ~200 MB | Rust 1.70+ |
|
||||||
|
| `browser` | WASM for in-browser execution | ~10 MB | Rust + wasm-pack |
|
||||||
|
| `iot` | ESP32 sensor mesh + aggregator | varies | Rust + ESP-IDF |
|
||||||
|
| `docker` | Docker-based deployment | ~1 GB | Docker |
|
||||||
|
| `field` | WiFi-Mat disaster response kit | ~62 MB | Rust + wasm-pack |
|
||||||
|
| `full` | Everything available | ~2 GB | All toolchains |
|
||||||
|
|
||||||
|
#### Non-Interactive Install
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install a specific profile without prompts
|
||||||
|
./install.sh --profile rust --yes
|
||||||
|
|
||||||
|
# Just run hardware detection (no install)
|
||||||
|
./install.sh --check-only
|
||||||
|
|
||||||
|
# Or use make targets
|
||||||
|
make install # Interactive
|
||||||
|
make install-verify # Verification only
|
||||||
|
make install-python # Python pipeline
|
||||||
|
make install-rust # Rust pipeline
|
||||||
|
make install-browser # WASM browser build
|
||||||
|
make install-docker # Docker deployment
|
||||||
|
make install-field # Disaster response kit
|
||||||
|
make install-full # Everything
|
||||||
|
make check # Hardware check only
|
||||||
|
```
|
||||||
|
|
||||||
|
### From Source (Rust — Primary)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/ruvnet/wifi-densepose.git
|
||||||
|
cd wifi-densepose
|
||||||
|
|
||||||
|
# Install Rust pipeline (810x faster than Python)
|
||||||
|
./install.sh --profile rust --yes
|
||||||
|
|
||||||
|
# Or manually:
|
||||||
|
cd rust-port/wifi-densepose-rs
|
||||||
|
cargo build --release
|
||||||
|
cargo test --workspace
|
||||||
|
```
|
||||||
|
|
||||||
|
### From Source (Python)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/ruvnet/wifi-densepose.git
|
git clone https://github.com/ruvnet/wifi-densepose.git
|
||||||
@@ -292,6 +343,16 @@ pip install -r requirements.txt
|
|||||||
pip install -e .
|
pip install -e .
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Using pip (Python only)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install wifi-densepose
|
||||||
|
|
||||||
|
# With optional dependencies
|
||||||
|
pip install wifi-densepose[gpu] # For GPU acceleration
|
||||||
|
pip install wifi-densepose[all] # All optional dependencies
|
||||||
|
```
|
||||||
|
|
||||||
### Using Docker
|
### Using Docker
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -301,19 +362,23 @@ docker run -p 8000:8000 ruvnet/wifi-densepose:latest
|
|||||||
|
|
||||||
### System Requirements
|
### System Requirements
|
||||||
|
|
||||||
- **Python**: 3.8 or higher
|
- **Rust**: 1.70+ (primary runtime — install via [rustup](https://rustup.rs/))
|
||||||
|
- **Python**: 3.8+ (for verification and legacy v1 API)
|
||||||
- **Operating System**: Linux (Ubuntu 18.04+), macOS (10.15+), Windows 10+
|
- **Operating System**: Linux (Ubuntu 18.04+), macOS (10.15+), Windows 10+
|
||||||
- **Memory**: Minimum 4GB RAM, Recommended 8GB+
|
- **Memory**: Minimum 4GB RAM, Recommended 8GB+
|
||||||
- **Storage**: 2GB free space for models and data
|
- **Storage**: 2GB free space for models and data
|
||||||
- **Network**: WiFi interface with CSI capability
|
- **Network**: WiFi interface with CSI capability (optional — installer detects what you have)
|
||||||
- **GPU**: Optional but recommended (NVIDIA GPU with CUDA support)
|
- **GPU**: Optional (NVIDIA CUDA or Apple Metal)
|
||||||
|
|
||||||
## 🚀 Quick Start
|
## 🚀 Quick Start
|
||||||
|
|
||||||
### 1. Basic Setup
|
### 1. Basic Setup
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Install the package
|
# Install the package (Rust — recommended)
|
||||||
|
./install.sh --profile rust --yes
|
||||||
|
|
||||||
|
# Or Python legacy
|
||||||
pip install wifi-densepose
|
pip install wifi-densepose
|
||||||
|
|
||||||
# Copy example configuration
|
# Copy example configuration
|
||||||
@@ -891,17 +956,16 @@ pytest tests/performance/ # Performance tests
|
|||||||
- Memory usage profiling
|
- Memory usage profiling
|
||||||
- Stress testing
|
- Stress testing
|
||||||
|
|
||||||
### Mock Testing
|
### Testing Without Hardware
|
||||||
|
|
||||||
For development without hardware:
|
For development without WiFi CSI hardware, use the deterministic reference signal:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Enable mock mode
|
# Verify the full signal processing pipeline (no hardware needed)
|
||||||
export MOCK_HARDWARE=true
|
./verify
|
||||||
export MOCK_POSE_DATA=true
|
|
||||||
|
|
||||||
# Run tests with mocked hardware
|
# Run Rust tests (all use real signal processing, no mocks)
|
||||||
pytest tests/ --mock-hardware
|
cd rust-port/wifi-densepose-rs && cargo test --workspace
|
||||||
```
|
```
|
||||||
|
|
||||||
### Continuous Integration
|
### Continuous Integration
|
||||||
@@ -1304,6 +1368,16 @@ SOFTWARE.
|
|||||||
|
|
||||||
## Changelog
|
## Changelog
|
||||||
|
|
||||||
|
### v2.2.0 — 2026-02-28
|
||||||
|
|
||||||
|
- **Guided installer** — `./install.sh` with 7-step hardware detection, WiFi interface discovery, toolchain checks, and environment-specific RVF builds (verify/python/rust/browser/iot/docker/field/full profiles)
|
||||||
|
- **Make targets** — `make install`, `make check`, `make install-rust`, `make build-wasm`, `make bench`, and 15+ other targets
|
||||||
|
- **Real-only inference** — `forward()` and hardware adapters return explicit errors without weights/hardware instead of silent empty data
|
||||||
|
- **5.7x Doppler FFT speedup** — Phase cache ring buffer reduces full pipeline from 719us to 254us per frame
|
||||||
|
- **Trust kill switch** — `./verify` with SHA-256 proof replay, `--audit` mode, and production code integrity scan
|
||||||
|
- **Security hardening** — 10 vulnerabilities fixed (hardcoded creds, JWT bypass, NaN panics), 12 dead code instances removed
|
||||||
|
- **SOTA research** — Comprehensive WiFi sensing + RuVector analysis with 30+ citations and 20-year projection (docs/research/)
|
||||||
|
|
||||||
### v2.1.0 — 2026-02-28
|
### v2.1.0 — 2026-02-28
|
||||||
|
|
||||||
- **RuVector RVF integration** — Architecture Decision Records (ADR-002 through ADR-013) defining integration of RVF cognitive containers, HNSW vector search, SONA self-learning, GNN pattern recognition, post-quantum cryptography, distributed consensus, WASM edge runtime, and witness chains
|
- **RuVector RVF integration** — Architecture Decision Records (ADR-002 through ADR-013) defining integration of RVF cognitive containers, HNSW vector search, SONA self-learning, GNN pattern recognition, post-quantum cryptography, distributed consensus, WASM edge runtime, and witness chains
|
||||||
|
|||||||
1071
install.sh
Executable file
1071
install.sh
Executable file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user