Interactive Notebooks
Run UniFace examples directly in your browser with Google Colab, or download and run locally with Jupyter.
Available Notebooks
| Notebook | Colab | Kaggle | Description |
|---|---|---|---|
| Face Detection | Detect faces and 5-point landmarks | ||
| Face Alignment | Align faces for recognition | ||
| Face Verification | Compare faces for identity | ||
| Face Search | Find a person in group photos | ||
| Face Analyzer | Unified face analysis | ||
| Face Parsing | Semantic face segmentation | ||
| Face Anonymization | Privacy-preserving blur | ||
| Gaze Estimation | Gaze direction estimation | ||
| Face Segmentation | Face segmentation with XSeg | ||
| Face Vector Store | FAISS-backed face database | ||
| Head Pose Estimation | 3D head orientation estimation | ||
| Face Recognition | Standalone face recognition pipeline | ||
| Portrait Matting | Portrait matting with MODNet | ||
| Face Attributes | Face states (eyes, glasses, sunglasses, mask) | ||
| Face Mesh | 468 / 478-point dense 3D mesh |
Running Locally
Download and run notebooks on your machine:
# Clone the repository
git clone https://github.com/yakhyo/uniface.git
cd uniface
# Install dependencies
pip install "uniface[cpu]" jupyter # or uniface[gpu] for CUDA
# Launch Jupyter
jupyter notebook examples/
Running on Google Colab
Click any "Open in Colab" badge above. The notebooks automatically:
- Install UniFace via pip
- Clone the repository to access test images
- Set up the correct working directory
GPU Acceleration
In Colab, go to Runtime → Change runtime type → GPU for faster inference.
Next Steps
- Quickstart - Code snippets for common use cases
- Tutorials - Step-by-step workflow guides
- API Reference - Detailed module documentation