# Face Recognition Docker

The world's simplest facial recognition api for Python and the command line

## Demo
[Online Demos](https://beta.deepnote.org/launch?template=face_recognition)

## pip
```sh
pip3 install face_recognition
```

## Docker Compose
```sh
git clone https://github.com/ageitgey/face_recognition.git
cd face_recognition
docker compose up
```

## Usage
### Command-Line Interface
* `face_recognition` - Recognize faces in a photograph or folder full for 
   photographs.
* `face_detection` - Find faces in a photograph or folder full for photographs.

## Features
Find faces in pictures

![](https://cloud.githubusercontent.com/assets/896692/23625227/42c65360-025d-11e7-94ea-b12f28cb34b4.png)

Find and manipulate facial features in pictures

![](https://cloud.githubusercontent.com/assets/896692/23625282/7f2d79dc-025d-11e7-8728-d8924596f8fa.png)

Identify faces in pictures

![](https://cloud.githubusercontent.com/assets/896692/23625229/45e049b6-025d-11e7-89cc-8a71cf89e713.png)

## References
- [Face Recognition GitHub](https://github.com/ageitgey/face_recognition)
- [Face Recognition API](https://face-recognition.readthedocs.io)