Facial Alignment Exercise

Learning various frameworks by practicing facial alignment. See the Jupyter notebook here.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

This project uses Python >= 3.7. See requirements.txt for a list of dependencies.

Installation

A step by step series of examples that tell you how to get a development env running.

The use of virtualenv is encouraged. See this gist on how to install and activate virtualenv.

1. Clone the repository and download dependencies.

git clone https://github.com/hsuanhauliu/facial-alignment-exercise.git
cd facial-alignment-exercise
pip install -r requirements.txt

If you have trouble downloading dlib, please follow this tutorial to troubleshoot.

2. Download Openface.

git clone https://github.com/cmusatyalab/openface.git
cd openface
pip install -r requirements.txt
sudo python setup.py install

3. Download the pre-trained model here and place it in the root directory.

4. Add your virtual environment to the kernel.

ipython kernel install --user --name=venv

Reference: https://medium.com/@eleroy/jupyter-notebook-in-a-virtual-environment-virtualenv-8f3c3448247

Usage

Follow the commands below to run the program.

jupyter notebook facial-alignment.ipynb

References

• Python Computer Vision OpenCV - Find Face Landmarks using DLIB