{"id":27940948,"url":"https://github.com/shivakantkurmi/face-recognition","last_synced_at":"2025-05-07T10:34:29.392Z","repository":{"id":257441628,"uuid":"858279416","full_name":"shivakantkurmi/Face-Recognition","owner":"shivakantkurmi","description":"A complete Python + MySQL based attendance system that uses real-time facial recognition to automate and manage student attendance efficiently.","archived":false,"fork":false,"pushed_at":"2025-04-05T21:04:30.000Z","size":13817,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T10:34:05.654Z","etag":null,"topics":["ai-attendance","attendance-system","automated-attendance","education-automation","face-recognition","face-recognition-system","image-processing","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/shivakantkurmi.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-09-16T16:14:00.000Z","updated_at":"2025-04-06T15:41:02.000Z","dependencies_parsed_at":"2025-03-08T07:23:04.896Z","dependency_job_id":"6e0d5084-5e89-47bb-9c70-2241d1cbcfca","html_url":"https://github.com/shivakantkurmi/Face-Recognition","commit_stats":null,"previous_names":["shivakantkurmi/face-recognition"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shivakantkurmi%2FFace-Recognition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shivakantkurmi%2FFace-Recognition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shivakantkurmi%2FFace-Recognition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shivakantkurmi%2FFace-Recognition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shivakantkurmi","download_url":"https://codeload.github.com/shivakantkurmi/Face-Recognition/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252860175,"owners_count":21815476,"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":["ai-attendance","attendance-system","automated-attendance","education-automation","face-recognition","face-recognition-system","image-processing","python"],"created_at":"2025-05-07T10:34:02.958Z","updated_at":"2025-05-07T10:34:29.291Z","avatar_url":"https://github.com/shivakantkurmi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 Facial Recognition Attendance System\n\nA complete **Python + MySQL** based attendance system that uses **real-time facial recognition** to automate and manage student attendance efficiently.\n\n---\n\n## 🔥 Highlight Features\n\n- 🧑‍🎓 **Student Manager** – Register, update, and delete student details via GUI.\n- 📷 **Face Dataset Generator** – Capture multiple images per student using webcam.\n- 🧠 **Face Model Trainer** – Train recognition model using OpenCV’s LBPH algorithm.\n- 🧾 **Real-Time Recognition** – Detect and identify faces live from webcam.\n- 📅 **Attendance Logger** – Automatically logs attendance with time and date.\n- 📁 **CSV Export** – Save daily attendance in spreadsheet-friendly format.\n- 🛢️ **MySQL Backend** – Securely store student and attendance data.\n\n---\n\n## ⚙️ Technologies Used\n\n| Tech             | Role                               |\n|------------------|-------------------------------------|\n| **Python 3.x**   | Main Programming Language           |\n| **OpenCV**       | Face Detection \u0026 Recognition        |\n| **Tkinter**      | GUI Framework                       |\n| **MySQL**        | Backend Database                    |\n| **Pillow**       | Image Processing                    |\n| **NumPy**        | Numerical Operations                |\n| **CSV, Datetime**| Attendance Logging \u0026 Export         |\n\n---\n\n## 🚀 Getting Started\n\n### 1️⃣ Clone the Repository\n\n```bash\ngit clone https://github.com/shivakantkurmi/Face-Recognition.git\ncd Facial-Recognition-Attendance\n```\n\n### 2️⃣ Install Required Libraries\n\n```bash\npip install opencv-python mysql-connector-python numpy pillow\n```\n### Connect Mysql Workbench \n\n\n## 🧩 Module Breakdown\n\n| Module File           | Purpose                                     |\n|------------------------|---------------------------------------------|\n| `main.py`              | GUI Homepage for navigation                 |\n| `student.py`           | Add / Edit / Delete student info            |\n| `dataset_generator.py` | Capture facial images for training dataset  |\n| `trainer.py`           | Train recognizer using LBPHFaceRecognizer   |\n| `recognizer.py`        | Recognize faces and log attendance          |\n| `attendance.py`        | View and export attendance records          |\n\n---\n\n## 📸 UI Preview\n\n| Main Menu | Register Student | Face Detection |\n|-----------|------------------|----------------|\n| ![Main](https://github.com/user-attachments/assets/455cd9a2-adbf-4ff7-b64b-886603f6b53d) | ![Register](https://github.com/user-attachments/assets/1fdaa51e-3b27-407b-b1eb-356ff3fc9d12) | ![Detect](https://github.com/user-attachments/assets/937afb00-95ee-4b1a-897e-a9cbc4276fe5) |\n\n---\n\n## 📜 License\n\nLicensed under the **MIT License**.\n\n---\n\n## 🙌 Contributions\n\nPull requests are welcome! For major changes, open an issue to discuss improvements first.\n\n---\n\n**Built with 💻 Python and ❤️ for smart automation in education.**\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshivakantkurmi%2Fface-recognition","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshivakantkurmi%2Fface-recognition","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshivakantkurmi%2Fface-recognition/lists"}