Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FaceTrace

FaceTrace is an AI-powered system designed to help identify and locate missing individuals using facial recognition and intelligent search capabilities. The platform enables users to report missing persons, perform image-based searches, and receive potential matches through an efficient and scalable pipeline.


🚀 Features

  • 🔍 Face Recognition Search
    Upload an image to find visually similar faces using AI-based embeddings.

  • 📄 Missing Person Reports
    Create and manage detailed reports with images and metadata.

  • Fast Similarity Matching
    Efficient comparison using vector-based search techniques.

  • 🔐 Secure Authentication
    User authentication and protected routes using JWT.

  • 📊 Scalable Architecture
    Designed to handle large datasets and real-time queries.


🛠️ Tech Stack

Frontend

  • Next.js
  • TypeScript
  • Tailwind CSS

Backend

  • Node.js
  • Express.js
  • MongoDB

AI Service

  • FastAPI
  • Face Recognition (DeepFace / FaceNet)
  • OpenCV

📂 Project Structure

facetrace/ ├── frontend/ # Next.js application ├── backend/ # Node.js + Express API ├── ai-service/ # FastAPI AI service


⚙️ Getting Started

Prerequisites

  • Node.js (v18+)
  • MongoDB
  • Python 3.9+

Installation

1. Clone the repository

git clone https://github.com/your-username/facetrace.git
cd facetrace
  1. Setup Backend cd backend npm install npm run dev
  2. Setup Frontend cd ../frontend npm install npm run dev
  3. Setup AI Service cd ../ai-service python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt python app.py 🌐 Running the Application Frontend: http://localhost:3000 Backend: http://localhost:5000 AI Service: http://localhost:8000 🔑 Core Workflow User uploads an image AI service generates facial embeddings Backend stores and indexes the data Search queries return the most similar matches 🤝 Contributing

Contributions are welcome. Feel free to fork the repository and submit a pull request.

📌 Note

This project is intended for educational and research purposes focused on applying AI for social good.


If you want next level upgrade, I can:

  • Add system design diagram section
  • Add API endpoints
  • Make it FAANG-level polished README
  • Or write LinkedIn post for this project launch 🚀

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages