{"id":29431713,"url":"https://github.com/soumilgit/real-time-missing-persons-detection","last_synced_at":"2026-02-04T07:09:55.522Z","repository":{"id":290250269,"uuid":"973507496","full_name":"Soumilgit/Real-Time-Missing-Persons-Detection","owner":"Soumilgit","description":"An MVP utilizing a custom API, where authorized users upload images to match individuals from a custom dataset of 50+ images.","archived":false,"fork":false,"pushed_at":"2025-07-03T22:20:09.000Z","size":188,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-03T23:26:10.670Z","etag":null,"topics":["amazon-rekognition","api-gateway","aws-serverless","cloudfront","disaster-response","emergency-response","face-recognition","image-matching","missing-persons","python-lambda","route53","s3-storage"],"latest_commit_sha":null,"homepage":"https://d1hn8ps4i2629d.cloudfront.net/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Soumilgit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"Soumilgit","buy_me_a_coffee":"SoumilnpM","custom":"https://github.com/sponsors/Soumilgit/"}},"created_at":"2025-04-27T06:15:53.000Z","updated_at":"2025-07-03T22:28:33.000Z","dependencies_parsed_at":"2025-07-03T23:22:14.882Z","dependency_job_id":"1c96feba-fdab-4744-83c0-4c0cad45fd03","html_url":"https://github.com/Soumilgit/Real-Time-Missing-Persons-Detection","commit_stats":null,"previous_names":["soumilgit/real-time-missing-persons-detection"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Soumilgit/Real-Time-Missing-Persons-Detection","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumilgit%2FReal-Time-Missing-Persons-Detection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumilgit%2FReal-Time-Missing-Persons-Detection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumilgit%2FReal-Time-Missing-Persons-Detection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumilgit%2FReal-Time-Missing-Persons-Detection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Soumilgit","download_url":"https://codeload.github.com/Soumilgit/Real-Time-Missing-Persons-Detection/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumilgit%2FReal-Time-Missing-Persons-Detection/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265050262,"owners_count":23703667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon-rekognition","api-gateway","aws-serverless","cloudfront","disaster-response","emergency-response","face-recognition","image-matching","missing-persons","python-lambda","route53","s3-storage"],"created_at":"2025-07-12T20:40:08.907Z","updated_at":"2026-01-20T16:40:24.728Z","avatar_url":"https://github.com/Soumilgit.png","language":"HTML","readme":"# Real-Time Missing Persons Detection\n## AWS Architecture\n![image](https://github.com/user-attachments/assets/168b0638-4e1a-4186-aa71-9560be5f521c)\n\n## Overview\n\nThis **serverless** project uses **Amazon Rekognition** for real-time missing person detection. Users can upload images (photos or CCTV frames),fill a few form details and the system matches them with a database of missing persons.\n\nThe goal is to **automate face-matching**, reducing delays and human error, enabling fast action by citizens and authorities.\n\n---\n\n## Key Features\n\n- **Real-Time Face Matching**: Upload an image or CCTV snapshot to get instant results via **Amazon Rekognition**.\n- **Enhanced Upload Form** *(NEW)*: Collects detailed information like time, location, and description to aid in analysis.\n- **Fast \u0026 Accurate**: Eliminates manual search with AI-powered facial comparison.\n- **Serverless Architecture**: Scales seamlessly using **AWS Lambda**, **API Gateway**,  **S3**, **CloudFront** and **Route 53**.\n\n---\n\n## AWS Rekognition Terminal Output – Single Dataset Entry\n![Screenshot 2025-04-27 040306](https://github.com/user-attachments/assets/9ed439e2-eff7-4957-8cc1-b997add07c0c)\n![Screenshot 2025-04-27 040316](https://github.com/user-attachments/assets/71469c60-ced0-4bac-a2b9-61e2603cd2eb)\n\n---\n\n##  Problem\n\n### Manual Process:\n- Civilians browse websites and manually compare faces.\n- Time-consuming, error-prone, and inefficient.\n\n### Our Solution:\n- Upload a single image, and fill few form details.\n- Automatically match against missing persons.\n- Instant, accurate, and user-friendly, also stores user data via Formspree.\n\n---\n\n## 🆕 What’s New?\n\n### Upload Form Enhancements:\n- Added fields: **Location**, **Date \u0026 time**, **Name**, **Email**, **Phone**, **Additional Details**, etc.\n- Data stored securely via **Formspree** for later analysis by investigators.\n- Usage of **CloudFront** \u0026 **Route 53** services for secure deployment.\n\n---\n\n## 💼 Real-World Use Cases\n\n- **Civilians**: Upload images using mobile or camera footage.\n- **Law Enforcement**: Cross-check faces with missing person records in real-time.\n\n---\n\n## 🛠️ Technologies Used\n\n### Frontend:\n- **HTML5**, **CSS3**, **Vanilla JS**\n- **TailwindCSS** for fast, responsive UI design\n\n### Backend:\n- **AWS Lambda (Python)** for processing logic\n- **Amazon Rekognition** for facial matching\n- **Amazon API Gateway** for custom REST API endpoints\n- **Amazon S3** for storing images and results\n- **CloudFront** \u0026 **Route 53** for secure deployment.\n- **Formspree** for handling form submissions with added fields\n\n---\n\n## How It Works\n\n1. **Image Upload**: User uploads a photo and fills out the enhanced form.\n2. **Face Matching**: Rekognition compares the face with the missing persons dataset.\n3. **Results**: Matches (or no matches) returned instantly.\n4. **Formspree**: Metadata is stored for further analysis.\n\n---\n\n## Project Flow\n\n### Old Method:\n- Open website\n- Manually search using filters\n- Visually compare entries\n\n### New Method:\n1. **Login/Signup** with validation \u0026 forgot password options\n2. **Fill the enhanced form** with contextual fields\n3. **Upload a photo**\n4. **Instant result** via Rekognition\n5. **Formspree stores details** for backend processing\n\n---\n\n## Testing \u0026 Validation\n\n- **AWS Lambda** tested with base64 image payloads and test events.\n- **Postman** used to verify deployed API endpoints with JSON inputs.\n- **Video Demo** available showing the updated upload form in action : https://youtu.be/kIx9YpGx90E .\n\n---\n\n## Installation \u0026 Setup\n\n### Prerequisites:\n- AWS Account with access to **Lambda**, **Rekognition**, **API Gateway**, **S3**, **CloudFront** \u0026 **Route 53** .\n- **Formspree** account for form data storage .\n\n### Setup Steps:\n\n```bash\ngit clone https://github.com/Soumilgit/Real-Time-Missing-Persons-Detection.git\n  ```\n\n2. **Set up AWS services**:\n   - Create an **S3 bucket** for storing images and feedback.\n   - Set up **Lambda functions** for face recognition.\n   - Use **API Gateway** to link the frontend to the backend.\n\n3. **Deploy Frontend**:\n   - Upload HTML, CSS, JS files to S3 or use Vercel/Netlify for deployment.\n\n4. **Test the system**:\n   - Upload an image, fill additional form details and make sure the face recognition provides accurate results.\n\n## Scalability\n\nThis project is designed to grow:\n- **Serverless**: Minimal infrastructure management with **AWS Lambda**.\n- **Modular Pages**: Easy to add new features and pages as the project expands.\n- **S3 and API Gateway** can handle a growing number of images in the database.\n\n## Conclusion\n\nThis project **automates the search** for missing persons using real-time face recognition. It provides a **fast**, **accurate**, and **scalable** solution that can be a game-changer in helping authorities identify missing people and reunite families.\n\n## License\nThis project is licensed under the [MIT License](https://github.com/Soumilgit/Real-Time-Missing-Persons-Detection/blob/main/LICENSE) .\n","funding_links":["https://github.com/sponsors/Soumilgit","https://buymeacoffee.com/SoumilnpM","https://github.com/sponsors/Soumilgit/"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoumilgit%2Freal-time-missing-persons-detection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoumilgit%2Freal-time-missing-persons-detection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoumilgit%2Freal-time-missing-persons-detection/lists"}