{"id":32938149,"url":"https://github.com/raziel206/facerecognition","last_synced_at":"2026-04-11T21:07:03.694Z","repository":{"id":323396143,"uuid":"1075481468","full_name":"Raziel206/FaceRecognition","owner":"Raziel206","description":"A face recognition app using python, opencv-python and mediapipe.","archived":false,"fork":false,"pushed_at":"2025-11-09T21:59:58.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-09T23:24:49.865Z","etag":null,"topics":["mediapipe","opencv-python","python"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Raziel206.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-13T15:00:34.000Z","updated_at":"2025-11-09T22:00:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Raziel206/FaceRecognition","commit_stats":null,"previous_names":["raziel206/facerecognition"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Raziel206/FaceRecognition","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raziel206%2FFaceRecognition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raziel206%2FFaceRecognition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raziel206%2FFaceRecognition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raziel206%2FFaceRecognition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Raziel206","download_url":"https://codeload.github.com/Raziel206/FaceRecognition/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Raziel206%2FFaceRecognition/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":283983990,"owners_count":26927577,"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","status":"online","status_checked_at":"2025-11-12T02:00:06.336Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["mediapipe","opencv-python","python"],"created_at":"2025-11-12T06:01:25.110Z","updated_at":"2025-11-12T06:01:26.564Z","avatar_url":"https://github.com/Raziel206.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FaceRecognition  \n*A lightweight real-time face detection \u0026 recognition app built with OpenCV / Node.js*\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/Raziel206/FaceRecognition)  \n\n---\n\n## 🚀 Project Overview  \nThis project provides a straightforward solution for detecting and recognising faces in real time, using a webcam or camera feed.  \nIt’s built with Node.js and `opencv4nodejs` (OpenCV bindings for Node), making it easy to extend, integrate and deploy.\n\n---\n\n## ✨ Features  \n- Real-time face detection using your camera  \n- Face recognition against a set of known faces  \n- Lightweight and modular — easy to integrate into other systems  \n- Works across Windows / macOS / Linux (given OpenCV dependencies are satisfied)  \n- Can be extended for access control, attendance systems, automation projects, creative installations  \n\n---\n\n## 🧩 Tech Stack  \n- **Language**: Python \n- **Library**: `opencv-python` `mediapipe`  \n- **Platform**: Desktop / Laptop (with webcam or external camera)  \n- **License**: MIT – free to use, modify, distribute  \n\n---\n\n## 🛠️ Installation \u0026 Setup  \n### Run these commands in order \n```bash\ngit clone https://github.com/Raziel206/FaceRecognition.git\ncd FaceRecognition\npip install virtualenv\npy -3.10 -m venv env\n.\\env\\Scripts\\activate\npip install -r requirements.txt\npython -m src.main\n```\n---\n## 📁 Project Structure\n```bash\nFaceRecognition/\n│\n├── src/                  \n│   ├── untils/\n│   │      ├── __init__.py\n│   │      ├── face_detect.py\n│   │      ├── hand_detect.py\n│   │      └── resizing.py\n│   ├── __init__.py\n│   ├── extension.py      \n│   └── main.py    \n├── .gitignore\n├── LICENSE\n├── README.md\n└── requirements.txt\n```\n---\n## 🎯 Use-Cases \u0026 Ideas\n\n- Use for door-access system: recognise authorised faces and trigger unlock\n\n- Use in classrooms / events: automatic attendance marking based on face recognition\n\n- Use for creative installations: trigger lights/sounds when certain faces appear\n\n- Use as a base for more advanced CV/AI work: add expression recognition, mask-detection, emotion tracking\n---\n## 🔍 Tips \u0026 Best Practices\n\n- Use clear, well-lit face images for each person in the known_faces/ folder — good data = better recognition\n\n- Maintain consistent lighting and camera position for best accuracy\n\n- Tune recognition thresholds (in recognizer logic) to avoid false positives or mis-matches\n\n- If performance is slow, reduce camera resolution or adjust detection/recognition parameters\n\n- Always test with multiple poses (frontal, slight angles) and different lighting conditions\n---\n## 🤝 Contributing\n\nContributions are welcome and appreciated!  \nWhether it's a bug fix, feature improvement, documentation enhancement, or optimization — every contribution helps.\n\n### ✅ How to contribute\n\n1. **Fork** the repository  \n2. Create a **new branch** for your feature or bug fix  \n   ```bash\n   git checkout -b feature-name\n   ```\n3. Make a pull request, or if it is a big change/major feature, create an issue.   \n---\n## 🙏 Acknowledgements\n\n[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/)\n[![OpenCV](https://img.shields.io/badge/OpenCV-Powered-orange.svg)](https://opencv.org/)\n[![MediaPipe](https://img.shields.io/badge/MediaPipe-Used%20for%20Face%20Recognition-brightgreen.svg)](https://mediapipe.dev/)\n[![Made With ❤️](https://img.shields.io/badge/Made%20With-%E2%9D%A4-red.svg)](#)\n\nThis project wouldn't be possible without the amazing work of the open-source community.  \nSpecial thanks to:\n\n- [**Python**](https://www.python.org) — for being simple, fast to prototype, and developer-friendly  \n- [**OpenCV**](https://opencv.org) — the core of real-time computer vision in this project  \n- [**MediaPipe**](https://chuoling.github.io/mediapipe) — for efficient, production-ready face detection \u0026 landmark tracking  \n- All contributors of these libraries for keeping them free, powerful, and evolving\n\n\u003e **Huge respect to open-source.** This project stands on the shoulders of giants.\n---\n## 📜 License\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nThis project is licensed under the [**MIT License**](https://opensource.org/license/mit).\n\n___\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraziel206%2Ffacerecognition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraziel206%2Ffacerecognition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraziel206%2Ffacerecognition/lists"}