RvFACE

rvFACE

**Rust + WebAssembly face recognition** — a complete port of the [Faceplugin Open-Source-Face-Recognition-SDK](https://github.com/Faceplugin-ltd/Open-Source-Face-Recognition-SDK) (Python/PyTorch) to Rust, running natively and in the browser on **WebGPU or CPU**, with a web UI.


Analyze: detection · 68 landmarks · pose	1:1 compare: score gauge · threshold-75 verdict

Pipeline

image ─► slim-320 SSD detector ─► 68-pt MobileFaceNet landmarks ─► head pose
                                        │
                                        ▼
                          eyes-level alignment (128×128)
                                        │
                                        ▼
                       embedding CNN ─► L2-normalized feature
                                        │
                                        ▼
                     similarity = (dot + 1) × 50   (match > 75)

Workspace

Path	What
crates/rvface-core	Framework-free pipeline math (priors, NMS, alignment, pose, similarity, image ops)
crates/rvface-models	Burn ports of the three CNNs (CPU: ndarray · WebGPU: wgpu)
crates/rvface-cli	Native CLI (rvface detect, rvface compare)
crates/rvface-wasm	Browser bindings (wasm-bindgen)
web/	Web UI (Vite + TS): upload/webcam, overlays, 1:1 compare, backend toggle
tools/	Python: weight conversion → safetensors, golden parity fixtures
docs/adrs/	Architecture decision records (start at 0001)

Quick start

# native
cd rvface
python3 tools/fetch_and_convert.py          # download + convert weights → models/
cargo run -p rvface-cli --release -- compare a.jpg b.png

# browser
cd web && npm install && npm run dev        # weights serv