PRNet HTTP Server
This little project enables using the PRNet library in a WSGI-compatible web server and provides a docker image with one such fully functional web-server.
Getting Started
# Clone this repository
git clone https://github.com/veloman-yunkan/prnet_http_server.git
cd prnet_http_server/
# This script clones the PRNet repo and gets the trained model
# data from Google Drive
./setup_PRNet
# Install required dependencies - see Dockerfile.base
# Run the tests (1 of them may fail because of slight numeric differences)
./run_tests
Building the docker image
./build_docker_image
This step takes a while and creates a 1.5GB sized docker image
prnet_http_server:latest.
Updating the docker image
If anything changes in this repo or PRNet, then - after updating them - just run
./update_docker_image
Updating the docker image is much faster - the new image is built on top of the
prnet_http_server:base image (containing just the dependencies) that was
created by the ./build_docker_image script.
Running tests using the dockerized web-server
./run_tests --use-docker
Using the dockerized web-server
Start the server with
docker run --rm -d -p 8000:8000 prnet_http_server:latest
Send an image to it with
curl -OJF image=@test_data/single_face.jpg http://localhost:8000
When starting the server, you can specify the upper limit on the image file size
(in bytes) through the PRNET_MAX_IMAGE_SIZE environment variable:
# Make the server reject images exceeding 5MB
docker run --rm -d -p 8000:8000 -e PRNET_MAX_IMAGE_SIZE=5000000 prnet_http_server:latest
The container runs the gunicorn web server inside and allows
to specify its settings through the
command line. For example, to make the web-server use 4
worker processes
for handling requests, provide the --workers=4 option:
docker run --rm -d -p 8000:8000 prnet_http_server:latest --workers=4
# ^^^^^^^^^^^