---
title: My Gradio Space
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: gradio
python_version: 3.12
---

# Hugging Face Space setup

## Files
- `app.py`
- `requirements.txt`

## Notes
- This app stores registered faces under `face_db/`
- Processed videos are written to `outputs/`
- For better speed, use a GPU Space if available
- First run may take time because RetinaFace / DeepFace need model downloads
- ESRGAN enhancement can be toggled from checkbox before embedding for webcam/register images and video face crops
- First ESRGAN use may take additional time because Real-ESRGAN will download `RealESRGAN_x4plus.pth` into `weights/`
- Runtime is pinned to Python 3.12 and `numpy<2` to avoid OpenCV import issues

## Suggested Space settings
- SDK: Gradio
- Python entry file: `app.py`

## Optional folders to keep in repo
- `face_db/.gitkeep`
- `outputs/.gitkeep`
- `temp_faces/.gitkeep`