{"id":27237415,"url":"https://github.com/asit-14/face-recognition-project","last_synced_at":"2026-02-08T17:31:08.099Z","repository":{"id":213211764,"uuid":"733213592","full_name":"Asit-14/Face-Recognition-project","owner":"Asit-14","description":"This repository contains my project face recognition.","archived":false,"fork":false,"pushed_at":"2024-11-28T14:00:26.000Z","size":26968,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T05:19:06.129Z","etag":null,"topics":["cnn-model","face-recognition","opencv","project-repository","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Asit-14.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-12-18T20:24:10.000Z","updated_at":"2024-12-03T19:19:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"5176f0b7-1d53-48bf-a28b-84992d87607b","html_url":"https://github.com/Asit-14/Face-Recognition-project","commit_stats":null,"previous_names":["asitshakya789/face_recognition","asitshakya789/face_recognition_python-project","asitshakya789/face-recognition-project","asit-14/face-recognition-project"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asit-14%2FFace-Recognition-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asit-14%2FFace-Recognition-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asit-14%2FFace-Recognition-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asit-14%2FFace-Recognition-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Asit-14","download_url":"https://codeload.github.com/Asit-14/Face-Recognition-project/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248270466,"owners_count":21075794,"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":["cnn-model","face-recognition","opencv","project-repository","python"],"created_at":"2025-04-10T18:20:33.574Z","updated_at":"2026-02-08T17:31:08.092Z","avatar_url":"https://github.com/Asit-14.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Face Recognition (Python, OpenCV, dlib)\n\nA small, resume-friendly face recognition demo built with Python, OpenCV, and `face_recognition` (dlib). It loads a set of known face images, then recognizes faces in a live webcam stream.\n\nOptional: if `deepface` is installed, the script also displays an estimated age.\n\n## What this project demonstrates\n\n- Real-time face detection + face embedding extraction (`face_recognition`/dlib)\n- Nearest-match identification against a known face gallery\n- Simple computer-vision UI overlays (name + confidence)\n- Defensive coding (missing images, no-face-in-image handling, optional dependencies)\n\n## Repository contents\n\nThis repository is intentionally small and centered around one script:\n\n- [face.py](face.py): main script\n- [dlib-19.19.0-cp38-cp38-win_amd64.whl](dlib-19.19.0-cp38-cp38-win_amd64.whl): Windows wheel used by `face_recognition` (Python 3.8)\n- Sample media files (images / pptx / docx / demo video)\n\nNote: the sample images in the root folder are demo assets. For a professional portfolio, replace them with images you have permission to use (see “Ethics \u0026 privacy”).\n\n## Requirements\n\n- Windows 10/11\n- Python 3.8 (recommended for the included dlib wheel)\n- A working webcam\n\nPython packages:\n\n- `opencv-python`\n- `face-recognition`\n\nOptional (for age estimation):\n\n- `deepface` (may pull heavier ML dependencies depending on your environment)\n\n## Setup (Windows)\n\nThe repo includes a prebuilt `dlib` wheel for Python 3.8 on 64-bit Windows. If you use a different Python version, you may need to build/install `dlib` another way.\n\n1) Create and activate a virtual environment\n\nPowerShell:\n\n```powershell\npython -m venv .venv\n.\\.venv\\Scripts\\Activate.ps1\n```\n\n2) Upgrade pip\n\n```powershell\npython -m pip install --upgrade pip\n```\n\n3) Install dependencies\n\n```powershell\npip install opencv-python face-recognition\n```\n\nIf `face-recognition` fails due to `dlib`, install the provided wheel:\n\n```powershell\npip install .\\dlib-19.19.0-cp38-cp38-win_amd64.whl\npip install face-recognition\n```\n\nOptional (age estimation):\n\n```powershell\npip install deepface\n```\n\n## Configure known faces\n\nEdit the `people` list in [face.py](face.py). Each entry maps a display name to an image file path.\n\nGuidelines for best results:\n\n- Use a clear, front-facing photo\n- One face per image\n- Good lighting, minimal occlusion\n\nIf a “known” image contains no detectable face, the script will raise a clear error message.\n\n## Run\n\n```powershell\npython face.py\n```\n\nControls:\n\n- Press `q` to quit.\n\n## How matching works (high level)\n\n1) Known images are encoded into 128-D face embeddings (dlib via `face_recognition`).\n2) Each detected face in the webcam frame is encoded the same way.\n3) The script computes distances between the detected embedding and all known embeddings.\n4) If the smallest distance is below a threshold (default: `0.60`), the corresponding name is shown. Otherwise, the face is labeled “Unknown”.\n\nThe on-screen “Confidence” value is displayed as `1 - distance` (a simple heuristic for readability; it is not a calibrated probability).\n\n## Troubleshooting\n\n- Camera doesn’t open\n  - Close other apps using the webcam (Zoom/Teams/Browser tabs).\n  - If you have multiple cameras, adjust `camera_index` in the code.\n\n- `ImportError` / build errors for `dlib`\n  - Use Python 3.8 on Windows and install the included wheel.\n  - On other Python versions, you may need a different wheel or a build toolchain.\n\n- `deepface` install is slow / fails\n  - Age estimation is optional. The script runs without it.\n  - If installed, `deepface` may require additional ML dependencies depending on your system.\n\n## Limitations\n\n- This is a demo; it is not production-grade authentication.\n- Recognition accuracy depends heavily on lighting, camera quality, pose, and dataset quality.\n- Face recognition may perform differently across demographic groups; evaluate carefully.\n\n## Ethics \u0026 privacy\n\n- Obtain consent before collecting or using any facial images.\n- Avoid using face recognition for high-stakes decisions.\n- Store biometric data securely and follow applicable laws/policies.\n\n## Project notes for a resume\n\n- Highlight: real-time CV pipeline (capture → detect → embed → match → overlay)\n- Highlight: robustness improvements (optional `deepface`, clear error handling)\n- Highlight: Windows-specific dependency handling (`dlib` wheel constraints)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasit-14%2Fface-recognition-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasit-14%2Fface-recognition-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasit-14%2Fface-recognition-project/lists"}