Uses the openface API to find human faces in images from e621.
Every so often, the bot downloads a set of images from e621's random pool. You can see what tags it uses in config.example.yml.
Since (obviously) there aren't many human faces in images submitted to e621, we have to try and force the shape predictor to find what it thinks is a face. Each sample image (e621 stores a scaled ~800px image for each submission) is downloaded, and then resized and checked against the shape predictor several times. By resizing, the image gets distorted slightly and the predictor has more chances at finding a "face".
If the predictor discovers a match, it will download the source image and scale up the bounding box of the "face" to the full-resolution image. The image is then cropped using a numpy slice and the image is uploaded to @cropsbot.
Installing Openface on any machine requires the installation of hundreds of dependencies for various C++ and Fortran libraries. Instead of going through that pain, we just use Docker instead.
./build.sh
./run.sh