{"id":26107143,"url":"https://github.com/alna0770/face_recognition","last_synced_at":"2026-04-24T04:31:43.308Z","repository":{"id":261690418,"uuid":"885052839","full_name":"ALNA0770/Face_recognition","owner":"ALNA0770","description":"Face recognition project for daily use","archived":false,"fork":false,"pushed_at":"2025-03-08T14:12:05.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-08T15:22:16.246Z","etag":null,"topics":["face-detection","face-recognition","homelab","open-source","opencv","python-3","python-library","security"],"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/ALNA0770.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":"2024-11-07T21:42:12.000Z","updated_at":"2025-03-08T14:14:13.000Z","dependencies_parsed_at":"2024-11-07T22:47:31.065Z","dependency_job_id":null,"html_url":"https://github.com/ALNA0770/Face_recognition","commit_stats":null,"previous_names":["alna0770/face_recognition"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALNA0770%2FFace_recognition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALNA0770%2FFace_recognition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALNA0770%2FFace_recognition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALNA0770%2FFace_recognition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ALNA0770","download_url":"https://codeload.github.com/ALNA0770/Face_recognition/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242762739,"owners_count":20181266,"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":["face-detection","face-recognition","homelab","open-source","opencv","python-3","python-library","security"],"created_at":"2025-03-09T22:43:30.408Z","updated_at":"2025-12-24T04:32:36.330Z","avatar_url":"https://github.com/ALNA0770.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 Face Recognition Project\n\nThis Python project uses face recognition to open a specific folder when a predefined face is detected. The folder remains hidden, and once the correct face is recognized, the folder will be opened.\n\n## 🐾 Features\n\n- **Face Recognition**: Detects and matches a face with a pre-configured known face.\n- **Opens Folder**: Once the face matches, the designated folder opens automatically.\n- **Webcam Interface**: Uses OpenCV to access the webcam and process images for real-time face recognition.\n\n## Requirements\n\n- Python 3.x\n- Virtual Environment (optional, recommended)\n\n### 🗽 Python Libraries\n\nThe project uses the following Python libraries:\n\n- `face_recognition`\n- `opencv-python`\n- `numpy`\n- `pillow`\n- `dlib`\n\nYou can install all the required libraries via the `requirements.txt` file.\n\n## Setup 📘\n\n1. **Clone the repository** or download the project files to your local machine.\n\n2. **Create and activate a virtual environment**:\n\n    On Windows:\n    ```bash\n    python -m venv venv\n    venv\\Scripts\\activate\n    ```\n\n    On Mac/Linux:\n    ```bash\n    python3 -m venv venv\n    source venv/bin/activate\n    ```\n\n3. **Install dependencies**:\n    After activating the virtual environment, run the following command to install the necessary libraries:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n4. **Prepare the reference face image**:\n    - Save your reference image (the face to recognize) in the same directory as the Python script.\n    - Rename the file to `your_image.jpg` or change the filename in the script to match your image name.\n\n5. **Configure the folder path**:\n    - Set the `folder_path` variable in `face_rec.py` to the location of the folder you want to open.\n    - Ensure the folder exists in the specified location.\n\n6. **Run the script**:\n    After the setup, run the script using:\n    ```bash\n    python face_rec.py\n    ```\n\n    The webcam will start, and the system will continuously check for a face. If the face matches the stored image, the folder will open.\n\n7. **Exit the script**:\n    Press the **'q'** key to stop the webcam and exit the script.\n\n## License ⚖️\n\nThis project is open-source and available under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\nALNA (nazarov31ali@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falna0770%2Fface_recognition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falna0770%2Fface_recognition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falna0770%2Fface_recognition/lists"}