Facial Expression Recognizer

Give the function an input and it will return a dictionary of detected faces and expression predictions.

About

This is a python3 cli for Facial Expression Recognition (FER) using Keras and OpenCV.

This project uses the haarcascade xml for facial detection.

We recommend using our model for this application, but you may use your own as well. This project could be easily modified to do other types of object detection if you wish.

If you fork this project, please contribute back with any fixes or features the community may find useful. All PRs will go through a member of our Engineering team.

Please follow GitHub's template for bug reporting.

Install

Using pip

$ pip3 install id-fer

From source

$ python3 -m venv env

$ source env/bin/activate

$ git clone git@github.com:IntrospectData/facial-expression-recognizer.git

$ python3 setup.py install -e

Use:

>>> from fer.main import check_stream
>>> from fer.main import check_image
>>> check_stream("/mnt/storage/face_test.mp4")
    [{'faces': {...}}, ...]
>>> check_image("/mnt/storage/face.jpeg")
    {'faces': {...}}

Append the argument show=True to either function to have a window display. You can press/hold any key for the frame to update in this mode.