---
title: FaceRecognity
emoji: 🐢
colorFrom: pink
colorTo: green
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
python_version: "3.10"
short_description: Facial recognition with InsightFace using Gradio
tags: ["computer-vision", "facial-recognition", "insightface", "gradio"]
fullWidth: true
---

# FaceRecognity 🐢

FaceRecognity is a **facial recognition web app** built with **InsightFace** and **Gradio**, designed to run smoothly on Hugging Face Spaces.  
It allows you to:

- **Extract face embeddings** from any uploaded image.
- **Compare a target face** against multiple candidate images.
- Get **match confidence scores** for similarity.

---

## Features

1. **Extract Embeddings**
   - Upload an image and get a numerical face embedding vector.
   - Useful for storing face representations or running offline comparisons.

2. **Match Faces**
   - Upload a target face image and multiple candidate images.
   - Quickly identify which candidates match the target face.
   - Returns similarity scores (0–100%).

---

## How to Use

1. **Extract Embedding**
   - Go to the "Extract Embedding" tab.
   - Upload an image with a clear face.
   - Click **Extract** to get the embedding.

2. **Match Faces**
   - Go to the "Match Faces" tab.
   - Upload a target image and up to 5 candidate images.
   - Click **Match** to see which candidates match the target.

---

## Requirements

This Space uses the following Python packages:

- `gradio`
- `numpy`
- `opencv-python-headless`
- `insightface`
- `torch`
- `onnxruntime`
- `tensorflow-cpu`

> The `requirements.txt` is already included in the repository for automatic installation.

---

## Notes

- Works best with **single-face images** for extraction and matching.
- Candidate images without a detected face are ignored.
- Runs entirely in-memory—no images are stored on the server.

---

## References

- [InsightFace GitHub](https://github.com/deepinsight/insightface)
- [Gradio Docs](https://gradio.app)
- [Hugging Face Spaces Configuration Reference](https://huggingface.co/docs/hub/spaces-config-reference)