{"id":25675611,"url":"https://github.com/haripasapuleti/face-recognition","last_synced_at":"2026-05-16T13:31:39.024Z","repository":{"id":253746096,"uuid":"830172931","full_name":"HariPasapuleti/Face-Recognition","owner":"HariPasapuleti","description":"A face recognition-based attendance system leveraging OpenCV and Face Recognition for real-time detection and tracking, integrated with Firebase for efficient data storage and management.","archived":false,"fork":false,"pushed_at":"2025-02-08T14:32:24.000Z","size":826,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-11T17:58:33.779Z","etag":null,"topics":["face-recognition","firebase-integration","opencv","pickle-serialization","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/HariPasapuleti.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,"zenodo":null}},"created_at":"2024-07-17T18:32:58.000Z","updated_at":"2025-05-28T08:41:44.000Z","dependencies_parsed_at":"2025-07-13T02:02:27.146Z","dependency_job_id":null,"html_url":"https://github.com/HariPasapuleti/Face-Recognition","commit_stats":null,"previous_names":["haripasapuleti/face-recognition"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/HariPasapuleti/Face-Recognition","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HariPasapuleti%2FFace-Recognition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HariPasapuleti%2FFace-Recognition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HariPasapuleti%2FFace-Recognition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HariPasapuleti%2FFace-Recognition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HariPasapuleti","download_url":"https://codeload.github.com/HariPasapuleti/Face-Recognition/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HariPasapuleti%2FFace-Recognition/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33104420,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["face-recognition","firebase-integration","opencv","pickle-serialization","python"],"created_at":"2025-02-24T13:17:40.178Z","updated_at":"2026-05-16T13:31:39.018Z","avatar_url":"https://github.com/HariPasapuleti.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Face Recognition System\n\nThis GitHub repository contains a Face Recognition System built using Python, OpenCV, and Firebase. The system can recognize faces, manage attendance records, and store user data in a Firebase Realtime Database. It includes two main Python scripts: `Face_Recognition.py` and `EncodeGenerator.py`.\n\n---\n\n## Features\n- **Real-Time Face Recognition:** Detects and recognizes faces using the `face_recognition` library.\n- **Attendance Management:** Logs attendance with timestamps and updates total attendance count.\n- **Firebase Integration:** Uses Firebase Realtime Database and Cloud Storage for data storage and retrieval.\n- **Encoding Generation:** Generates face encodings from images and stores them in a pickle file for quick access.\n\n---\n\n## Prerequisites\n### 1. Python Dependencies\nInstall the following packages:\n```bash\npip install opencv-python face_recognition numpy cvzone firebase-admin python-dotenv\n```\n\n### 2. Firebase Setup\n- **Realtime Database**: Enable and configure Firebase Realtime Database.\n- **Cloud Storage**: Configure Firebase Cloud Storage.\n- **Credentials**: Download the Firebase credentials JSON file and place it in the project directory.\n\n### 3. Environment Variables\nCreate a `.env` file and add:\n```env\nFIREBASE_DATABASE_URL = \"your-firebase-database-url\"\nFIREBASE_STORAGE_BUCKET = \"your-firebase-storage-bucket\"\nFIREBASE_CREDENTIALS = \"path-to-your-firebase-credentials.json\"\n```\n\n---\n\n## Installation\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/HariPasapuleti/Face-Recognition.git\n   cd Face-Recognition\n   ```\n2. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n3. Set up resources:\n   - Create a `resource` folder and add:\n     - A background image (`background.png`).\n     - A `modes` folder containing mode images.\n   - Create an `images` folder for student images.\n\n---\n\n## Usage\n### Step 1: Generate Encodings\nRun the `EncodeGenerator.py` script to generate face encodings from student images:\n```bash\npython EncodeGenerator.py\n```\nThis script:\n- Uploads student images to Firebase Storage.\n- Generates a `EncodFile.p` file containing face encodings and IDs.\n\n### Step 2: Run Face Recognition\nRun the `face_recognition.py` script to start the recognition system:\n```bash\npython Face_Recognition.py\n```\nPress `n` to exit the program.\n\n---\n\n## File Structure\n### Main Files\n- **`EncodeGenerator.py`:**\n  - Generates face encodings and uploads images to Firebase.\n- **`Face_Recognition.py`:**\n  - Detects faces in real time, recognizes them, and logs attendance.\n\n### Resources\n- **`resource/`:**\n  - `background.png`: Background image for UI.\n  - `modes/`: Images representing different modes in the UI.\n- **`images/`:**\n  - Stores student images for encoding.\n\n---\n\n## Firebase Configuration\n### Realtime Database Structure\n```json\n{\n  \"Students\": {\n    \"123\": {\n      \"name\": \"Hari Pasapuleti\",\n      \"gender\": \"Male\",\n      \"company\": \"XYZ Corp\",\n      \"id\": \"123\",\n      \"nationality\": \"India\",\n      \"Joined year\": \"2023\",\n      \"total attendance\": 5,\n      \"last attendance time\": \"2025-02-01 10:00:00\"\n    }\n  }\n}\n```\n\n### Cloud Storage\nStore student images in the `images/` folder within Firebase Storage.\n\n---\n\n## Screenshots\nAdd relevant screenshots showcasing:\n- Application UI.\n- Firebase setup.\n- Sample outputs.\n\n---\n\n## Contributing\nContributions are welcome! Please:\n1. Open an issue for bugs or feature requests.\n2. Submit a pull request for fixes or enhancements.\n\n---\n\n## License\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n## Acknowledgments\n- [OpenCV](https://opencv.org/)\n- [Face Recognition Library](https://github.com/ageitgey/face_recognition)\n- [Firebase](https://firebase.google.com/)\n\n---\n\n## Contact\nFor any queries, feel free to reach out via [Email](mailto:hari9000kmph@gmail.com).\n\n---\n\n### Optimizations:\n1. Improved section organization with clear headings.\n2. Simplified repetitive instructions into concise steps.\n3. Clarified resource and setup details for better user experience.\n4. Added proper Markdown formatting for readability.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharipasapuleti%2Fface-recognition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharipasapuleti%2Fface-recognition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharipasapuleti%2Fface-recognition/lists"}