py-facial-recognition

Web-server for people verification by face recognition.

Min hardware requirements for face_recognition compilation: 2Gb RAM

URLs:

/ for POST requests

/upload web-form for manual image upload

/admin regular Django admin interface

For develop (server is availabled on port 8000)

docker-compose up -d --build
docker-compose -f docker-compose.yml exec web python manage.py createsuperuser

Check with curl

curl -i -X POST -F "imgfile=@person-photo.jpg" http://localhost:8000/

For production (server is availabled on port 1337)

docker-compose -f docker-compose.prod.yml up -d --build
docker-compose -f docker-compose.prod.yml exec web python manage.py migrate --noinput
docker-compose -f docker-compose.prod.yml exec web python manage.py collectstatic --no-input --clear
docker-compose -f docker-compose.prod.yml exec web python manage.py createsuperuser

add your server IP address or domain name to variable DJANGO_ALLOWED_HOSTS at .env.prod

Usefull docker commands

Check logs

docker-compose logs -f

List all working conteiners

docker ps

List ALL conteiners

docker ps -a

Stop container

docker-compose down

for nginx

docker-compose down --remove-orphans

docker stop CONTAINER ID

Delete containers with volums

docker-compose down -v

Start container after STOP

docker start CONTAINER ID

Restart container

docker restart CONTAINER ID

List of all images

docker images

Delete image

docker rmi CONTAINER ID

docker rmi -f CONTAINER ID

Exec comand within working container

docker exec -it CONTAINER ID bash

Prune docker system and remove all containers, images, volumes with one command

docker system prune -a

Specification

Back-end: Django

Application server: gunicorn

Front-end server: nginx

DB: PostgreSQL

Recognition engine: face_recognition