{"id":48956603,"url":"https://github.com/iam-salma/face-recognition-attendance-system","last_synced_at":"2026-04-18T00:09:11.849Z","repository":{"id":305367663,"uuid":"1022711003","full_name":"iam-salma/face-recognition-attendance-system","owner":"iam-salma","description":"AI-based face recognition attendance system using OpenCV and Streamlit. Mark, view, and manage attendance with real-time webcam capture.","archived":false,"fork":false,"pushed_at":"2025-07-19T16:56:49.000Z","size":297,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-19T20:26:03.836Z","etag":null,"topics":["attendance-system","face-recognition","haarcascade","opencv","opencv-python","python","streamlit"],"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/iam-salma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"zenodo":null}},"created_at":"2025-07-19T16:55:56.000Z","updated_at":"2025-07-19T17:02:31.000Z","dependencies_parsed_at":"2025-07-19T20:27:15.044Z","dependency_job_id":"517bfef3-03e7-4644-a832-24e8a341ed62","html_url":"https://github.com/iam-salma/face-recognition-attendance-system","commit_stats":null,"previous_names":["iam-salma/face-recognition-attendance-system"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/iam-salma/face-recognition-attendance-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iam-salma%2Fface-recognition-attendance-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iam-salma%2Fface-recognition-attendance-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iam-salma%2Fface-recognition-attendance-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iam-salma%2Fface-recognition-attendance-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iam-salma","download_url":"https://codeload.github.com/iam-salma/face-recognition-attendance-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iam-salma%2Fface-recognition-attendance-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31950895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["attendance-system","face-recognition","haarcascade","opencv","opencv-python","python","streamlit"],"created_at":"2026-04-18T00:09:11.228Z","updated_at":"2026-04-18T00:09:11.835Z","avatar_url":"https://github.com/iam-salma.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"200\" height=\"200\" alt=\"ChatGPT Image Jul 20, 2025, 06_13_39 AM\" src=\"https://github.com/user-attachments/assets/a9397cd9-d3ab-4925-aadc-c42f51115fdc\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n  Face Recognition Based Attendance System\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/iam-salma/face-recognition-attendance-system/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/iam-salma/face-recognition-attendance-system?style=social\" alt=\"Stars\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/iam-salma/face-recognition-attendance-system/fork\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/iam-salma/face-recognition-attendance-system?style=social\" alt=\"Forks\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/iam-salma/face-recognition-attendance-system/issues\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/iam-salma/face-recognition-attendance-system\" alt=\"Issues\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/iam-salma/face-recognition-attendance-system/pulls\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues-pr/iam-salma/face-recognition-attendance-system\" alt=\"Pull Requests\"/\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/iam-salma/face-recognition-attendance-system\" alt=\"Last Commit\"/\u003e\n\u003c/p\u003e\n\nA real-time face recognition-based attendance system built using **Streamlit** for the user interface, **OpenCV** for face detection and recognition, and **Haar Cascade classifiers** for facial feature extraction. This system allows you to register students, train a face recognition model, and take or view attendance with ease.\n\n---\n\n## 🚀 Features\n\n- 🧑‍🎓 Register students with facial image capture\n- 🧠 Train model using OpenCV and Haar Cascades\n- 🤖 Automatic attendance using webcam and face recognition\n- ✍️ Manual attendance entry\n- 📅 View attendance records by subject and date + percentage\n- 🗑️ Delete student data from the system\n- 🔈 Text-to-speech for better accessibility\n\n---\n\n## 🛠️ Tech Stack\n\n- **Python 3.8+**\n- **Streamlit** – GUI and user interactions\n- **OpenCV** – Image processing and recognition\n- **Haar Cascades** – Face detection\n- **CSV** – Storage of student details and attendance logs\n\n---\n\n## 📁 Project Structure\n\n```\n📦face-recognition-attendance/\n├── app.py                         # Main Streamlit app\n├── takeImage.py                   # Capture and save student face\n├── trainImage.py                  # Train recognition model\n├── automaticAttendance.py         # Detect and mark attendance\n├── takemanually.py                # Manual attendance input\n├── view_attendance.py             # Display attendance by subject/date\n├── delete.py                      # Delete student and retrain\n├── db.py                          # CSV-based student DB utilities\n├── TrainingImage/                 # Folder storing face images\n├── TrainingImageLabel/            # Trained model file (e.g., .yml)\n├── StudentDetails/                # CSV file for student info\n├── Attendance/                    # Attendance records\n├── HaarCascade/haarcascade_frontalface_default.xml\n```\n\n---\n\n## ▶️ How to Run\n\n1. **Install dependencies**\n```bash\npip install -r requirements.txt\n```\n\n2. **Run the app**\n```bash\nstreamlit run app.py\n```\n\n3. **Use Interface**\n- Register students\n- Train model\n- Take automatic or manual attendance\n- View or delete records\n\n---\n\n## ✅ Requirements\n\n- Webcam-enabled system\n- Python 3.8 or higher\n\n---\n\n## 📌 Notes\n\n- Make sure the `haarcascade_frontalface_default.xml` file is available in the correct path.\n- After deleting a student, the model is retrained automatically.\n- CSV files are used for storage – you can upgrade to a database like PostgreSQL if needed.\n\n---\n\nIf you found this project helpful or interesting, please consider giving it a ⭐️ on GitHub — it motivates and helps others discover it! ✌️\n\nENJOY! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiam-salma%2Fface-recognition-attendance-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiam-salma%2Fface-recognition-attendance-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiam-salma%2Fface-recognition-attendance-system/lists"}