{"id":20653431,"url":"https://github.com/dastratakos/face-mask-detection","last_synced_at":"2025-06-16T06:06:02.145Z","repository":{"id":56198766,"uuid":"303574942","full_name":"dastratakos/Face-Mask-Detection","owner":"dastratakos","description":"A machine learning model to identify if a person is wearing a face mask or not and if the face mask is worn properly.","archived":false,"fork":false,"pushed_at":"2020-11-22T20:51:46.000Z","size":2277,"stargazers_count":5,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-19T13:52:12.308Z","etag":null,"topics":["computer-vision","cs229","face-mask","machine-learning"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dastratakos.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}},"created_at":"2020-10-13T03:14:17.000Z","updated_at":"2022-04-03T01:54:36.000Z","dependencies_parsed_at":"2022-08-15T14:31:26.742Z","dependency_job_id":null,"html_url":"https://github.com/dastratakos/Face-Mask-Detection","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dastratakos/Face-Mask-Detection","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dastratakos%2FFace-Mask-Detection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dastratakos%2FFace-Mask-Detection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dastratakos%2FFace-Mask-Detection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dastratakos%2FFace-Mask-Detection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dastratakos","download_url":"https://codeload.github.com/dastratakos/Face-Mask-Detection/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dastratakos%2FFace-Mask-Detection/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260109485,"owners_count":22960030,"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":["computer-vision","cs229","face-mask","machine-learning"],"created_at":"2024-11-16T17:44:06.222Z","updated_at":"2025-06-16T06:06:02.119Z","avatar_url":"https://github.com/dastratakos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- PROJECT SHIELDS --\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eFace Mask Detection\u003c/h1\u003e\n  \u003ch2 align=\"center\"\u003eCharles Pan, Gilbert Rosal, and Dean Stratakos\u003c/h2\u003e\n  \u003ch3 align=\"center\"\u003eNovember 18, 2020\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    A machine learning model for a \u003ca href=\"http://cs229.stanford.edu\"\u003eCS 229\u003c/a\u003e final project\n    \u003cbr /\u003e\n    \u003ca href=\"tex/report.pdf\"\u003eRead the report »\u003c/strong\u003e\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/dastratakos/Face-Mask-Detection/issues\"\u003eRequest a feature »\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cimg align=\"center\" src=\"images/data.png\" title=\"Image\" alt=\"Image\" width=\"600\"/\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n## Table of Contents\n\n* [About the Project](#about-the-project)\n* [Getting Started](#getting-started)\n* [Usage](#usage)\n* [License](#license)\n* [Contact](#contact)\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nAcross the globe, there have been 55.6M million reported coronavirus cases (up from 33.8M last month). Covid-19 has plunged countless nations into chaos and recession as they scramble to keep the virus contained. Due to the highly contagious nature of the virus, every individual must do their part in preventing the spread by taking precautions such as wearing a face mask. Yet there are still many individuals who refuse to do so - this careless behavior puts many lives at risk, so it is imperative that we hold these individuals responsible.\n\nIn light of this issue, our project aims to create a machine learning model that can accurately detect, given an image, whether a person is properly wearing a face mask or not. This project will especially be important in the global return to work effort as businesses continue to search for ways to keep their employees and customers safe. Automating the process of face mask detection will reduce human labor while creating a system of accountability.\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nTo get a local copy up and running follow these simple steps.\n\n1. Clone the repo\n```sh\ngit clone https://github.com/dastratakos/Face-Mask-Detection.git\n```\n2. Install packages\n```sh\npip install -r requirements.txt\n```\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n\n1. Run the pipeline and pass in the model to run. Note that this pipeline will run the data preprocessing if it has not been done yet. For example:\n```sh\npython run_pipeline.py -m SVM\n```\n2. For ResNet models, it is recommended to use a VM through a platform such as GCP (Google Cloud Platform).\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the Apache 2.0 License. See `LICENSE` for more information.\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nCharles Pan, Gilbert Rosal, and Dean Stratakos -\n[{cpan22, rosalg, dstratak}@stanford.edu](mailto:dstratak@stanford.edu,cpan22@stanford.edu,rosalg@stanford.edu)\n\nProject Link: [https://github.com/dastratakos/Face-Mask-Detection](https://github.com/dastratakos/Face-Mask-Detection)\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/dastratakos/Face-Mask-Detection.svg?style=flat-square\n[contributors-url]: https://github.com/dastratakos/Face-Mask-Detection/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/dastratakos/Face-Mask-Detection.svg?style=flat-square\n[forks-url]: https://github.com/dastratakos/Face-Mask-Detection/network/members\n[stars-shield]: https://img.shields.io/github/stars/dastratakos/Face-Mask-Detection.svg?style=flat-square\n[stars-url]: https://github.com/dastratakos/Face-Mask-Detection/stargazers\n[issues-shield]: https://img.shields.io/github/issues/dastratakos/Face-Mask-Detection.svg?style=flat-square\n[issues-url]: https://github.com/dastratakos/Face-Mask-Detection/issues\n[license-shield]: https://img.shields.io/github/license/dastratakos/Face-Mask-Detection.svg?style=flat-square\n[license-url]: https://github.com/dastratakos/Face-Mask-Detection/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/dean-stratakos-8b338b149\n[product-screenshot]: images/screenshot.png\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdastratakos%2Fface-mask-detection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdastratakos%2Fface-mask-detection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdastratakos%2Fface-mask-detection/lists"}