{"id":15136009,"url":"https://github.com/kmhmubin/face-recognition-attendance-system","last_synced_at":"2025-04-12T23:40:48.289Z","repository":{"id":35730593,"uuid":"194294975","full_name":"kmhmubin/Face-Recognition-Attendance-System","owner":"kmhmubin","description":"Face Detection | Recognition | Attendance","archived":false,"fork":false,"pushed_at":"2024-07-11T11:52:53.000Z","size":378199,"stargazers_count":523,"open_issues_count":19,"forks_count":190,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-12T23:40:04.799Z","etag":null,"topics":["attendance","attendance-system","automail","camera","cli","csv","face-detection","face-recognition","haar-cascade","haar-cascade-classifier","lbph","numpy","opencv","pandas","pillow","pycharm","python","python3","shutil-python","yagmail"],"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/kmhmubin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"Contributing Guidelines.md","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}},"created_at":"2019-06-28T15:21:22.000Z","updated_at":"2025-04-10T20:29:00.000Z","dependencies_parsed_at":"2023-01-16T04:30:20.186Z","dependency_job_id":"7c2ff61f-3e87-47b3-a4ca-8f07119d5938","html_url":"https://github.com/kmhmubin/Face-Recognition-Attendance-System","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kmhmubin%2FFace-Recognition-Attendance-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kmhmubin%2FFace-Recognition-Attendance-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kmhmubin%2FFace-Recognition-Attendance-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kmhmubin%2FFace-Recognition-Attendance-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kmhmubin","download_url":"https://codeload.github.com/kmhmubin/Face-Recognition-Attendance-System/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647254,"owners_count":21139081,"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":["attendance","attendance-system","automail","camera","cli","csv","face-detection","face-recognition","haar-cascade","haar-cascade-classifier","lbph","numpy","opencv","pandas","pillow","pycharm","python","python3","shutil-python","yagmail"],"created_at":"2024-09-26T06:03:25.785Z","updated_at":"2025-04-12T23:40:48.262Z","avatar_url":"https://github.com/kmhmubin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Face Recognition Attandance System\n\n### Recognize The faces And Take Automatic Attandance. :sparkles:\n\n![Face Recognition Logo](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/Face-Recognition-Attendance-System-Logo.jpg)\n\n\n![GitHub](https://img.shields.io/github/license/kmhmubin/Face-Recognition-Attendance-System)\n\n## Motivation :astonished:\n----------------------------\nWe seek to provide a valuable attendance service for both teachers and students. Reduce manual process errors by provide automated and a reliable attendance system uses face recognition technology.\n\n## Features :clipboard:\n---------------------------\n* Check Camera\n* Capture Faces\n* Train Faces\n* Recognize Faces \u0026 Attendance\n* Automatic Email\n\n## Screenshots :camera:\n-----------------------------------\n### Command Line Interface\n\n![Command Line Interdace](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/CODE%20INTERFACE.png)\n\n### Checking Camera\n\n![Checking Camera](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/Program%20working.jpg)\n\n### Automail \n\n![Automail](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/automail.jpg)\n\n\n## Tech Used :computer:\n--------------------------\nBuild With - \n* Python 3.7\n\nModule Used -\n\nAll The Module are Latest Version.\n* [OpenCV](https://docs.opencv.org/3.4/index.html) (Contrib 4.0.1)\n* [Pillow](https://pypi.org/project/Pillow/)\n* [Numpy](https://numpy.org/)\n* [Pandas](https://pandas.pydata.org/)\n* [Shutil](https://docs.python.org/3/library/shutil.html)\n* [CSV](https://docs.python.org/3/library/csv.html)\n* [yagmail](https://pypi.org/project/yagmail/)\n\n\nFace Recognition Algorithms -\n* [Haar Cascade](https://docs.opencv.org/3.4/db/d28/tutorial_cascade_classifier.html)\n* [LBPH (Local Binary Pattern Histogram)](https://docs.opencv.org/3.4/da/d60/tutorial_face_main.html)\n\nSoftware Used -\n* [Pycharm 2019.2](https://www.jetbrains.com/pycharm/download/?section=windows)\n* [VS CODE](https://code.visualstudio.com/download)\n* [Git](https://git-scm.com/downloads)\n\n## Installation :key:\n-----------------------------------\n\n#### Download or Clone the project\n\nFirst Download or Clone the Project on Your Local Machine.To download the project from github press **Download Zip**\n\n![Download Zip](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/download%20zip.png)\n\nor \n\nYou can clone the project with git bash.To clone the project using git bash first open the git bash and write the following code\n```\ngit clone https://github.com/kmhmubin/Face-Recognition-Attendance-System.git\n```\ndemo \n\n![Git clone](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/git%20clone_edit_0.gif)\n\nAfter download, Open the project using **Pycharm or VSCODE**. Then we have to create an python enviroment to run the program.\n\n#### create enviroment \nFirst open the terminal or command line in the IDE.Then write the following code.\n```\npython -m venv env\n```\nThen activate the enviroment using the code below for windows.\n```\n.\\env\\Scripts\\activate\n```\n[ *Notice:*\nIf your pc don't have virtual enviroment or pip install the follow this link.\n[How to create Virtual Enviroment](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/) ]\n\n#### Installing the packages\n--------------------------------------------------\n\nAfter creating the enviroment on your project let's install the necessary packages. \n\n![pip isntall demo](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/pip%20install_edit_0.gif)\n\nTo install those package open the terminal or command line and paste the code from below\n\n```\npip install opencv-contrib-python\n```\n```\npip install numpy\n```\n```\npip install pandas\n```\n```\npip install Pillow\n```\n```\npip install pytest-shutil\n```\n```\npip install python-csv\n```\n```\npip install yagmail\n```\n\n[ **Notice: During the package installization, sometime it shows some error, to avoid those error you can install those packages as admin. ]\n\n## Test Run :bicyclist:\n-----------------------\nAfter creating the enviroment and installing the packages, open the IDE terminal/command line to run the program. Using the code below.\n\n```\npy main.py\n```\nHere is a demo to run the program. I'm Using the Pycharm IDE in my demo.\n\n![Test Run](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Document%20Metarial/Project%20demo%20images/code%20demo_edit_0.gif)\n\n## How To Use? :pencil:\n----------------------\nIf you want to use it just follow the steps below.\n\n1. First download or clone the project\n2. Import the project to your favourit IDE\n3. Create an python enviroment\n4. Install all the packages \n5. Change the mail information\n6. Run the project using the command line or your IDE Run Button\n\n## Known Bugs :bug:\n------------------------------\nThis project have some bugs.\n\n* \u003cstrike\u003eStudent Details: In student details folder the **StudentDetails.csv** file don't have ID \u0026 name column.This problem show when the program run first time and create the \u003cstong\u003eStudentDetails.csv\u003c/strong\u003e file automatically. To soleve the problelm just open the file and add *ID \u0026 Name Column* in the file and save it.\u003c/strike\u003e\n* Auto Attachment: This is not a problem actually. The problem is before sent auto mail we have to manually change the file name. I tried to automate the attachment but i faild.\n\n## Contribute :heart:\n--------------------------------------\nIf you want to contribute in this project feel free to do that. A [contribution guideline](https://github.com/kmhmubin/Face-Recognition-Attendance-System/blob/master/Contributing%20Guidelines.md) will be a big help.\n\nThanks you, for contributing.\n- [Adeetya Upadhyay](https://github.com/AdeetyaU)\n- [Ciro Iriarte](https://github.com/ciroiriarte)\n- [Shreyas More](https://github.com/staticshreyas)\n\n## Credits :sparkling_heart:\n--------------------------------\nThanks to [Farhat Tasnim](https://github.com/farhattasnim) work with me.\n\n## Licence :scroll:\n---------------------------------\nMIT © [K.M.H. Mubin](https://github.com/kmhmubin)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkmhmubin%2Fface-recognition-attendance-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkmhmubin%2Fface-recognition-attendance-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkmhmubin%2Fface-recognition-attendance-system/lists"}