Spaces:
Sleeping
Sleeping
| title: Face Tracker Demo | |
| emoji: 🎥 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: gradio | |
| sdk_version: "5.9.1" | |
| app_file: app.py | |
| python_version: "3.10" | |
| pinned: false | |
| license: apache-2.0 | |
| short_description: Real-time multi-person face detection, tracking & ID | |
| # Face Tracker Demo (web) | |
| Browser demo of the pipeline in `../app`: live webcam → InsightFace detection | |
| → ArcFace embedding → ByteTrack → FAISS identity match → boxes/IDs drawn in | |
| your browser. Nothing is recorded or stored; state lives only in your tab for | |
| the session and is discarded on reload. | |
| This is **not** the NUC/production app - it's a lightweight, standalone copy | |
| tuned for a shared free CPU (smaller `buffalo_s` model pack, 320px detection, | |
| 2 ONNX Runtime threads by default). See `../app/README.md` for the real | |
| RTSP/webcam app this demonstrates. | |
| ## Deploying | |
| 1. Create a new Space at https://huggingface.co/new-space with SDK "Gradio". | |
| 2. Push the contents of this folder (not the whole repo) to the Space's git | |
| remote: | |
| ```bash | |
| cd webdemo | |
| git init | |
| git remote add space https://huggingface.co/spaces/<your-username>/<space-name> | |
| git add -A | |
| git commit -m "Face tracker web demo" | |
| git push space main | |
| ``` | |
| 3. The Space builds automatically from `requirements.txt` and launches | |
| `app.py`. First build takes a few minutes (downloads the `buffalo_s` model | |
| pack on first request). | |
| ## Local test before deploying | |
| ```bash | |
| cd webdemo | |
| pip install -r requirements.txt | |
| python app.py | |
| ``` | |
| Opens at http://127.0.0.1:7860 - allow webcam access in the browser. | |
| ## Tuning via environment variables | |
| Set these as Space secrets/variables, or env vars for local testing: | |
| | Variable | Default | Notes | | |
| |---|---|---| | |
| | `DET_SIZE` | `320` | detector input size | | |
| | `MODEL_NAME` | `buffalo_s` | or `buffalo_l` for more accuracy, slower | | |
| | `ONNX_THREADS` | `2` | match the Space's CPU tier core count | | |
| | `MATCH_THRESHOLD` | `0.38` | cosine similarity for matching a face to an existing ID | | |