README.md

metadata

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
• Gradio Docs
• Hugging Face Spaces Configuration Reference