{"id":27442959,"url":"https://github.com/anodicpassion/face_mask_detector","last_synced_at":"2026-05-08T13:17:22.053Z","repository":{"id":287864345,"uuid":"966030194","full_name":"anodicpassion/face_mask_detector","owner":"anodicpassion","description":"A real-time face mask detection system built with TensorFlow, Keras, OpenCV, and MobileNetV2. This project can detect whether a person is wearing a face mask or not using a webcam feed.","archived":false,"fork":false,"pushed_at":"2025-04-14T11:12:37.000Z","size":8403,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T01:17:32.858Z","etag":null,"topics":["adam-optimizer","face-mask-detection","globalaveragepooling2d","keras","mask-detection","mobilenetv2","opencv-python","opencv2","python","python3","tensorflow","tensorflow-models"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anodicpassion.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-04-14T09:44:22.000Z","updated_at":"2025-04-14T11:12:39.000Z","dependencies_parsed_at":"2025-04-14T11:35:47.607Z","dependency_job_id":null,"html_url":"https://github.com/anodicpassion/face_mask_detector","commit_stats":null,"previous_names":["anodicpassion/face_mask_detector"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anodicpassion%2Fface_mask_detector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anodicpassion%2Fface_mask_detector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anodicpassion%2Fface_mask_detector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anodicpassion%2Fface_mask_detector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anodicpassion","download_url":"https://codeload.github.com/anodicpassion/face_mask_detector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248986314,"owners_count":21194025,"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":["adam-optimizer","face-mask-detection","globalaveragepooling2d","keras","mask-detection","mobilenetv2","opencv-python","opencv2","python","python3","tensorflow","tensorflow-models"],"created_at":"2025-04-15T01:17:50.160Z","updated_at":"2026-05-08T13:17:17.028Z","avatar_url":"https://github.com/anodicpassion.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 😷 Face Mask Detection using Deep Learning\n\nA real-time face mask detection system built with TensorFlow, Keras, OpenCV, and MobileNetV2. This project can detect whether a person is wearing a face mask or not using a webcam feed.\n\n---\n\n## 📌 Features\n\n- Real-time face detection with OpenCV\n- MobileNetV2-based CNN model for mask classification\n- Transfer learning for high accuracy with limited training\n- Data augmentation for improved generalization\n- Easy deployment via Flask and Docker (optional)\n\n---\n\n## 📂 Project Structure\n```.\n├── LICENSE\n├── data\n│   ├── download.bash\n│   └── download_data_manually.txt\n├── evaluate.py\n├── file_structure\n├── haarCascade\n│   ├── __init__.py\n│   └── haarcascade_frontalface_default.xml\n├── model\n│   └── mobilenet_v2.h5\n├── preprocess.py\n├── requirements.txt \n├── test_real_time.py\n└── train.py\n\n4 directories, 11 files\n```\n---\n\n## 🧠 Model\n\n- **Architecture**: MobileNetV2 (Transfer Learning)\n- **Input Shape**: 224x224x3\n- **Loss Function**: Binary Crossentropy\n- **Optimizer**: Adam\n\n---\n\n## 📦 Installation\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/anodicpassion/face_mask_detector.git\ncd face_mask_detector\n```\n\n### 2. Create a Virtual Environment\n\n```bash\npython3 -m venv venv            # On Windows: python -m venv venv \nsource venv/bin/activate        # On Windows: venv\\Scripts\\activate\n```\n\n\n### 3. Install Dependencies \n\n```bash\npip install -r requirements.txt\n```\n\n### 4. Download data\n\n```bash\nbash data/download.bash         # On Windows: read download_data_manually.txt\n```\n\n## 🚀 Running the Project\n\n\n### 1. Train the Model\n\n```bash\npython3 train.py\n```\nThe trained model will be saved to: `model/mask_detector_model.h5`\n\n### 2. Run Real-Time Face Mask Detection\n\n```bash\npython3 test_real_time.py\n```\nPress q to exit the webcam window.\n\n## 📜 License\n\nGNU GENERAL PUBLIC LICENSE","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanodicpassion%2Fface_mask_detector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanodicpassion%2Fface_mask_detector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanodicpassion%2Fface_mask_detector/lists"}