Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Facial Expression Recognition based on Keras

Project description


Facial expression recognition.


Currently FER only supports Python3.4 onwards. It can be installed through pip:

$ pip3 install fer

This implementation requires OpenCV>=3.2 and Tensorflow>=1.7.0 installed in the system, with bindings for Python3.

They can be installed through pip (if pip version >= 9.0.1):

$ pip3 install tensorflow>=1.7 opencv-contrib-python==

or compiled directly from sources (OpenCV3, Tensorflow).

Note that a tensorflow-gpu version can be used instead if a GPU device is available on the system, which will speedup the results. It can be installed with pip:

$ pip3 install tensorflow-gpu\>=1.7.0


The following example illustrates the ease of use of this package:

>>> from fer.fer import FER
>>> import cv2
>>> img = cv2.imread("justin.jpg")
>>> detector = FER()
>>> print(detector.detect_emotions(img))
[{'box': [277, 90, 48, 63], 'emotions': {'angry': 0.02, 'disgust': 0.0, 'fear': 0.05, 'happy': 0.16, 'neutral': 0.09, 'sad': 0.27, 'surprise': 0.41}]

The detector returns a list of JSON objects. Each JSON object contains two keys: ‘box’ and ‘emotions’:

  • The bounding box is formatted as [x, y, width, height] under the key ‘box’.
  • The emotions are formatted into a JSON object with the keys ‘anger’, ‘disgust’, ‘fear’, ‘happy’, ‘sad’, surprise’, and ‘neutral’.

Other good examples of usage can be found in the files “” and “” located in the root of this repository.


By default the FER bundles a face detection Keras model.

The model is a convolutional neural network with weights saved to HDF5 file in the ‘data’ folder relative to the module’s path. It can be overriden by injecting it into the FER() constructor during instantiation with emotion_model parameter.


MIT License.


This code includes methods and package structure copied or derived from Iván de Paz Centeno’s implementation of MTCNN and Octavia Arriaga’s facial expression recognition repo.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
fer-0.0.2-py3-none-any.whl (805.8 kB) Copy SHA256 hash SHA256 Wheel py3 Sep 26, 2018
fer-0.0.2.tar.gz (801.2 kB) Copy SHA256 hash SHA256 Source None Sep 26, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page