English Summary: A lightweight, pure Python-based DSP engine and Web UI for Wi-Fi CSI spatial sensing, bypassing the heavy Rust/Docker/AI stack of the original project.
中文简介: 一个轻量级的纯 Python Wi-Fi CSI 空间感知雷达引擎与 Web UI，彻底摆脱原项目沉重的 Rust/Docker/AI 环境依赖。
This project utilizes the compiled .bin firmware from the outstanding open-source radar project @ruvnet/RuView to capture raw ESP32 CSI (Channel State Information) data. Huge thanks to the original team for their incredible work on the ESP-IDF network stack! We did not modify their low-level firmware; we built a lightweight Python DSP layer on top of it.
本项目底层的 ESP32 CSI 抓取固件直接使用了顶级开源项目 @ruvnet/RuView 的官方 .bin 文件。感谢原团队在底层网络栈上的卓越贡献！ 我们没有修改底层固件，而是以此为基站，重构了上层的 Python 信号处理引擎。
[EN] The original RuView is incredibly powerful but requires compiling Rust, setting up Docker, and running heavy neural networks. This sets a high barrier for beginners. RuView Radar Lite replaces all of that with ~100 lines of Python code. Two $3 ESP32 boards and a few Python libraries are all you need to experience "through-wall" Wi-Fi sensing in 3 minutes.
[CN] 原版极其强大，但复杂的 Rust 编译链、Docker 环境和 AI 模型直接劝退了大部分想体验无线电感知（RF Sensing）的玩家。RuView Radar Lite 用 100 多行 Python 代码平替了这一切。两块十几块钱的 ESP32，拔枪即用！
- Amplitude Demodulation (复数振幅解算): Mathematically strips away phase drift caused by unsynchronized clocks between nodes. (物理级剥离双节点时钟不同步带来的相位漂移，提取纯净波动。)
- Top-K Peak Capture (Top-K 顶峰捕捉算法): Focuses only on the most volatile subcarriers, crushing the "motion dilution" effect and achieving ultra-high SNR. (只锁定波动最剧烈的子载波，彻底粉碎动作稀释效应，极高信噪比。)
- Zero-Latency Web Sonar UI (零延迟声呐 UI): Full-duplex communication via Flask + Socket.IO for a cyberpunk, deep-sea sonar visual experience. (基于 Flask + Socket.IO 提供极具压迫感的视觉交互。)
- Interactive CLI & Demo Mode (交互终端与幽灵模拟器): Auto-scans serial ports. No hardware? No problem. Use
Demo Modeto simulate radar intrusions immediately! (全自动扫描串口。没带硬件？直接开启“幽灵模式”体验虚拟雷达报警！)
- [EN] Flash the 4
.binfiles provided in thefirmware/folder to your ESP32 TX and RX boards usingesptool.py. (Note:nvs.binis explicitly removed for privacy. The board will prompt you to set up your Wi-Fi upon first boot). - [CN] 使用
esptool.py将firmware/文件夹内的 4 个.bin文件烧录到收发两块 ESP32 上。(注：为保护隐私，已剔除包含 Wi-Fi 密码的nvs.bin，首次开机需按原版流程配网)。
git clone [https://github.com/YourUsername/RuView_Radar_Lite.git](https://github.com/YourUsername/RuView_Radar_Lite.git)
cd RuView_Radar_Lite
pip install -r requirements.txtPlug the RX ESP32 into your computer and run: (将接收端 ESP32 插入电脑，运行：)
python app.py- Follow the interactive CLI to select your COM port (or choose Demo Mode). (跟随交互提示选择串口，或选择 Demo 模式。)
- Open your browser and navigate to
http://127.0.0.1:5000. (打开浏览器访问网页。)
- Multi-node localization support (多节点定位)
- UI sensitivity slider (前端灵敏度调节)
- C++ Edge Computing rewrite (边缘计算脱机版重构)
- ESP32-CAM Vision-Language Model Integration (接入视觉大模型实现多模态联动)