Creating average faces in Python 🙂

This post explains how to make face averages in Python using my Facer package. Facer draws extensively on this tutorial from Satya Mallick. I had to update the code pretty heavily to get the package to work, so I thought I’d share my modifications.


You have my 100% money-back guarantee that the most difficult part of using this package is installing the requirements. Once you’ve got OpenCV installed, the rest will be smooth sailing.

1. Install OpenCV

On Mac, use homebrew to install OpenCV.

brew install opencv

Installing OpenCV with brew did work for me, but it also broke my previous Python installation and all my virtual environments. So uhh, good luck with that. I don’t have experience installing OpenCV on Windows, but you can try this tutorial.

2. Clone the project repository

After installing OpenCV, we can clone the project repository from GitHub:

git clone Facer

The git clone command will create a new folder, ./Facer, and populate it with files from the GitHub repository. After cloning the repo, cd into the new directory.

3. Install the Python libraries

After installing OpenCV and cloning the project repository, we just need to add a few more helper libraries: numpy, matplotlib, and dlib.

pip install -r requirements.txt

4. Download the pre-trained detection model

The face landmark detection relies on a pre-trained model that must be downloaded separately from the dlib package itself.


Unzip the compressed file after it finishes downloading and move it into the ./Facer/dlib directory.

Congrats, you’ve installed everything you need to run Facer!

Creating average faces

Having installed Facer (and completed the hardest parts of this tutorial!), we can begin creating average faces.

The process is actually quite straightforward. Here’s how to load images from a directory and create an average face:

from facer import facer

# Load face images
path_to_images = "./face_images"
images = facer.load_images(path_to_images)

# Detect landmarks for each face
landmarks, faces = facer.detect_face_landmarks(images)

# Use  the detected landmarks to create an average face
average_face = facer.create_average_face(faces, landmarks, save_image=True)

# View the composite image

That’s it! The facer.create_average_face function will have saved a JPG image containing the average face output.

The Facer package also supports creating animated GIFs that display each face used to create an average:

from facer import facer

# Load face images
path_to_images = "./face_images"
images = facer.load_images(path_to_images)

# Create the animated GIF
gif, average_face = facer.create_animated_gif(images)
Combining faces of Apple's executive leadership.
Combining faces of Apple's executive leadership.

Let me know if you have any questions! I’ll be most responsive to new issues or pull requests on the GitHub repository.



Perpetually inquisitve Data Scientist.

comments powered by Disqus
John W. Miller © 2019
rss facebook twitter instructables GoogleScholar github youtube mail spotify lastfm instagram linkedin google google-plus pinterest medium vimeo stackoverflow reddit quora quora