https://github.com/senofsky/face-mask-detector

A library and command line utility for detecting face masks in images and video streams
https://github.com/senofsky/face-mask-detector

computer-vision covid-19 deep-learning detect-face-masks face-mask-detection face-mask-detector face-masks keras keras-tensorflow machine-learning mobilenetv2 python python3 video-stream

Last synced: 2 months ago
JSON representation

A library and command line utility for detecting face masks in images and video streams

• Host: GitHub
• URL: https://github.com/senofsky/face-mask-detector
• Owner: senofsky
• License: mit
• Created: 2020-07-15T17:30:47.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-03-25T01:02:19.000Z (over 1 year ago)
• Last Synced: 2024-09-30T10:03:18.282Z (3 months ago)
• Topics: computer-vision, covid-19, deep-learning, detect-face-masks, face-mask-detection, face-mask-detector, face-masks, keras, keras-tensorflow, machine-learning, mobilenetv2, python, python3, video-stream
• Language: Python
• Homepage:
• Size: 66.3 MB
• Stars: 5
• Watchers: 1
• Forks: 4
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


# face-mask-detector

![PyPI](https://img.shields.io/pypi/v/face-mask-detector)

![PyPI - License](https://img.shields.io/pypi/l/face-mask-detector?style=flat)

[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/senofsky/face-mask-detector/issues)

![PyPI - Versions](https://img.shields.io/pypi/pyversions/face-mask-detector?logo=python&logoColor=white)

**A library and command line utility for detecting face masks in images and video streams**

![Demo Gif](docs/assets/demo.gif)





Install

---------------

As always, the use of a python [virtual

environment](https://docs.python.org/3/tutorial/venv.html) is recommended for a

development setup:

``` sh

python -m venv venv

source venv/bin/activate

```

To install using `pip`:

``` sh

pip install face-mask-detector

```

Quick Start

-------------

To detect face masks in a image, run:

```sh

face-mask-detector --image path/to/image

```

To start your webcam and detect face masks in the video stream, run:

```sh

face-mask-detector

```

Contribute

-------------

I :heart: pull requests and defect reports - I welcome contributions of any kind!

To install `face-mask-detector` from source, clone this repository and run the

following in the project root directory:

```sh

pip install -e '.[dev]'

```