🚧 Facial Recognition Missing Person Finder

An intelligent tool leveraging facial recognition to locate missing persons.

Final Year Project | Software Engineering at AASTU

This project aims to help in search and rescue operations by leveraging facial recognition technology to assist in finding missing persons. The system supports image-based searches, filtering, and real-time notifications.

---

📑 Table of Contents

🧐 About

✨ Key Features

💻 Technologies Used

⚙ Getting Started

🚀 Usage

🤝 Contributing

📜 License

---

🧐 About

This repository contains the source code and documentation for the Facial Recognition Missing Person Finder, a tool developed as part of the final year project for a Bachelor's degree in Software Engineering at AASTU.

The goal is to leverage advanced facial recognition and text matching to locate missing individuals. It serves as a valuable tool for search and rescue teams, enhancing their efficiency and outreach.

---

✨ Key Features

📄 Submit Missing Person Posts: Easily create a post about a missing person, visible to everyone.

💬 Profile Chatting: Message the person who posted the missing case directly from the profile.

🔍 Image & Feature-Based Search: Search for missing persons using image recognition or by filtering based on age, name, gender, and more.

🎛 Filtering Options: Narrow down your search by specifying features such as age, weight, gender, and skin color.

🔗 Matching: Input individual descriptions to receive possible matches with a confidence score based on database entries.

⚙️ Case Management: Keep track of all the cases you’ve posted and update them as necessary.

📬 Notifications: Receive real-time updates when new cases are added, or statuses change.

🛠 Admin Dashboard: Allows admins to manage users, monitor cases, and review logs.

---

💻 Technologies Used

Frontend:

🟦 React

🎨 Tailwind CSS

📱 Flutter

🔥 Firebase

Backend:

🟩 Node.js

🍃 MongoDB

Facial Recognition:

🖼 Open-source face-api.js for facial recognition

Description Matching:

📝 Transformers for text and description matching

---

⚙ Getting Started

Here’s how to get a local copy of the project running on your machine.

Prerequisites

Ensure you have the following installed:

• Node.js
• MongoDB
• Flutter SDK

Installation

1. Clone the repository:

   git clone https://github.com/CapStoneProject-Missing-People/Missing-individual.git
   cd Missing-individual

2. Backend Setup:

   • Navigate to missingFeature:

     cd missingFeature
     npm install

   • Create a .env file with the following:

     dbUri=your-mongodb-connection-string
     PORT=4000
     PRIV_KEY=your-private-key-for-jwt
     ACCESS_TOKEN_SECRET=your-access-token-secret
     

   • Start the backend server:

     npm start

   • Open a new terminal and navigate to face-recognition/:

     cd face-recognition
     npm install

   • Create another .env file:

     dbUri=your-mongodb-connection-string
     PORT=6000
     

   • Start the face recognition service:

     npm start

3. Frontend Setup:

   • Navigate to the Flutter app directory:

     cd Frontend/missingpersonapp
     flutter pub clean
     flutter pub get

   • In Frontend/missingpersonapp/lib/features/authentication/utils/constants.dart, add:

     const String postUri = 'http://localhost:4000';
     const String faceApi = 'http://localhost:6000';
     const String wsUri = 'localhost:4000';

   • Run the Flutter app:

     flutter run

Note: If using a physical device, ensure it is connected to the same Wi-Fi as the server and replace localhost with your machine’s IP address.

---

🚀 Usage

How to Use the App

1. Post a Case: Navigate to the Post Case section, upload a photo and enter the missing person's details.
2. Search for a Missing Person: Search by uploading a photo or entering details like name, age, and gender.
3. Receive Notifications: Get notifications on case updates or status changes.

---

🤝 Contributing

We welcome contributions! Feel free to open issues or submit pull requests to improve this project.

---

Screenshots and Demo

---

🎥 Watch the demo on Youtube:

Note: If you'd like to open the video or link in a new tab, you can right-click the link and select "Open link in new tab", or use Ctrl + Click (on Windows/Linux) or Cmd + Click (on macOS).

click here

---

Contact:

1. Leulseged B. Ayalew
2. Dawit Yenew

📜 License

Apache-2.0 license