{"id":15159412,"url":"https://github.com/coolmunzi/face_mask_detector","last_synced_at":"2026-01-21T17:35:03.049Z","repository":{"id":201788770,"uuid":"323661717","full_name":"coolmunzi/face_mask_detector","owner":"coolmunzi","description":"Face mask detection based on tensorflow 2 object detection API using Efficientdet-D1 model. This project can perform face mask detection on images as well as videos. ","archived":false,"fork":false,"pushed_at":"2020-12-22T17:55:49.000Z","size":28848,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T19:17:25.790Z","etag":null,"topics":["covid19","detection-api","efficientdet-ssd","face-mask-detection","face-mask-detector","opencv","opencv-python","python","tensorflow","tensorflow-examples","tensorflow-object-detection-api","tensorflow2","tensorflow2-object-detection","tfod-api"],"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/coolmunzi.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}},"created_at":"2020-12-22T15:21:05.000Z","updated_at":"2021-01-19T19:10:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"2c43c90f-a92a-47d6-aa80-1f3e914c5e0d","html_url":"https://github.com/coolmunzi/face_mask_detector","commit_stats":null,"previous_names":["coolmunzi/face_mask_detector"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolmunzi%2Fface_mask_detector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolmunzi%2Fface_mask_detector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolmunzi%2Fface_mask_detector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolmunzi%2Fface_mask_detector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coolmunzi","download_url":"https://codeload.github.com/coolmunzi/face_mask_detector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247694893,"owners_count":20980731,"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":["covid19","detection-api","efficientdet-ssd","face-mask-detection","face-mask-detector","opencv","opencv-python","python","tensorflow","tensorflow-examples","tensorflow-object-detection-api","tensorflow2","tensorflow2-object-detection","tfod-api"],"created_at":"2024-09-26T21:21:23.837Z","updated_at":"2026-01-21T17:35:03.019Z","avatar_url":"https://github.com/coolmunzi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cb\u003e About the project \u003c/b\u003e\n\nWearing mask is the most effective way to control the spread of Corona virus. Face mask detector applications are in high demand especially to monitor public places like public marketplaces, public offices, malls, government buildings etc  This project aims to create an efficient Face Mask detector application based on deep neural network.\n\n![alt text](./readme_images/test2.png) ![alt text](./readme_images/test3.png)\n\n\u003cb\u003e Dataset used for training \u003c/b\u003e\n\nI have used the data from [Face Mask Detection](https://www.kaggle.com/andrewmvd/face-mask-detection/activity) dataset from Kaggle. The dataset contained annotated images with 3 classes:\n    \n1. with mask\n2. without mask\n3. mask worn incorrectly\n\nThe dataset contains total of 853 images along with annotations in PASCAL VOC format.\n\n\u003cb\u003e Technolgy stack used \u003c/b\u003e\n\n1. [OpenCV](https://opencv.org/) \n2. [TensorFlow 2 Object Detection API](https://github.com/tensorflow/models/tree/master/research/object_detection)\n3. [EfficientDet-SSD based Face Mask detector](https://tfhub.dev/tensorflow/efficientdet/d1/1)\n4. [Python](https://www.python.org/)\n\n\n\u003cb\u003e Prerequisites \u003c/b\u003e\n\nAll the dependencies and required libraries are included in the file _requirements.txt_.\n\n\u003cb\u003e Model Training \u003c/b\u003e\n\nThe repo contains ssd efficientdet model trained with 20,000 iterations using Google Colab. You can also refer to [my colab notebook](https://colab.research.google.com/drive/1tGTuIg2xJipoln8IC8cxH35Wr4nJ7930?usp=sharing), where I have tried to explain step by step flow for performing model training using Tensorflow2 object detection API. \n\n\u003cb\u003e Installation \u003c/b\u003e\n\n1. Clone the repo using following command \n    \n        $ git clone https://github.com/coolmunzi/face_mask_detector.git\n2. Create a virtual environment and change the directory to the cloned repo\n3. Change your directory to the cloned repo and create a Python virtual environment named 'test'\n4. Install the dependencies using following command\n    \n        $pip install -r requirements.txt\n5. To perform face mask detection on images:\n    \n        $python face_mask_detector.py --type image --input {Path to directory containing images} --output {Path to directory where you want to store the images with predictions}\n   \n6. To perform face mask detection on webcam:\n    \n        $python face_mask_detector.py --type video --input webcam\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolmunzi%2Fface_mask_detector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoolmunzi%2Fface_mask_detector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolmunzi%2Fface_mask_detector/lists"}