Face Recognition - Docker image

This project provides a docker image which offers a web service to recognize known faces on images. It's based on the great ageitgey/face_recognition project and just add a web service using the Python face_recognition-library.

Get started

Build the Docker image

Start by building the docker image with a defined name. This can take a while.

docker build -t facerec_service .

Run the Docker image

Start the image and forward port 8080. Optionally bind a local directory to /root/faces to provide a location for predefined images which will be registered at start time.

docker run -d -p8080:8080 -vfaces:/root/faces facerec_service

Features

Register known faces

Simple POST an image-file to the /faces endpoint and provide an identifier. curl -X POST -F "[email protected]" http://localhost:8080/faces?id=person1

Read registered faces

Simple GET the /register endpoint. curl http://localhost:8080/faces

Identify faces on image

Simple POST an image-file to the web service. curl -X POST -F "[email protected]" http://localhost:8080/

Examples

In the examples-directory there is currently only one example that shows how to use the Raspberry Pi-Camera module to capture an image and POST it to the Face Recognition - Docker image to check for known faces.

Notes

I'm not a Python expert, so I'm pretty sure you can optimize the Python code further :) Please feel free to send PR's or open issues.