Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/janloebel/face_recognition
Face recognition docker image to provide a web service which is able to register and recognize faces
https://github.com/janloebel/face_recognition
docker face facerecognition python recognition service
Last synced: 11 days ago
JSON representation
Face recognition docker image to provide a web service which is able to register and recognize faces
- Host: GitHub
- URL: https://github.com/janloebel/face_recognition
- Owner: JanLoebel
- License: mit
- Created: 2017-06-07T10:15:37.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-03-04T20:54:35.000Z (8 months ago)
- Last Synced: 2024-10-15T03:43:00.678Z (24 days ago)
- Topics: docker, face, facerecognition, python, recognition, service
- Language: Python
- Homepage:
- Size: 17.6 KB
- Stars: 115
- Watchers: 8
- Forks: 69
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/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.
```bash
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.
```bash
docker run -d -p8080:8080 -v faces:/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.