Sync from GitHub via hub-sync

README.md

@@ -1,12 +1,69 @@
 ---
-title: Faceverification
-emoji: 📉
+title: Face Verification
+emoji: 🧠
 colorFrom: blue
 colorTo: green
 sdk: gradio
 sdk_version: 6.14.0
 python_version: '3.11'
 app_file: app.py
+short_description: "Face verification demo with FaceNet and VectorDB"
 pinned: false
 license: mit
----
+---
+
+# Face Verification
+
+AI Engineering Demo project demonstrating an end-to-end face verification workflow with FaceNet embeddings, ChromaDB vector search, and an interactive Gradio interface.
+
+The app lets users add known people to a local embeddings database and verify whether a new face image matches one of the stored identities.
+
+## Features
+
+- Face detection and preprocessing from uploaded images
+- FaceNet embedding extraction with PyTorch
+- Similarity search with ChromaDB
+- Interactive Gradio UI with add-person and verify-identity flows
+- Hugging Face Spaces deployment-ready structure
+
+## Tech Stack
+
+- Python
+- PyTorch
+- FaceNet / facenet-pytorch
+- ChromaDB
+- Gradio
+- Hugging Face Spaces
+
+## Run Locally
+
+Using uv:
+
+```bash
+uv sync
+uv run python app.py
+```
+
+Using pip:
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+## Project Structure
+
+```text
+src/faceverification/
+  app.py
+  config.py
+  core/
+    image_processor.py
+    vectordb.py
+  services/
+    face_verification.py
+```
+
+## Demo Focus
+
+This project highlights practical AI engineering skills: model-based feature extraction, vector database integration, application packaging, automated deployment, and a simple user-facing ML interface.

app.py

@@ -1,3 +1,8 @@
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent / "src"))
+
 from faceverification.app import FV_gr
 
 if __name__ == "__main__":

requirements.txt

@@ -1,6 +1,5 @@
 # This file was autogenerated by uv via the following command:
 #    uv export --locked --no-hashes --format requirements.txt --output-file requirements.txt
--e .
 aiohappyeyeballs==2.6.1
     # via aiohttp
 aiohttp==3.13.5