Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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 days ago
JSON representation

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

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]'
```