Skip to content
This repository has been archived by the owner on Jan 23, 2023. It is now read-only.

FakeFinder builds a modular framework for evaluating various deepfake detection models, offering a web application as well as API access for integration into existing workflows.



Repository files navigation

FakeFinder: Sifting out deepfakes in the wild

The FakeFinder project builds upon the work done at IQT Labs in competing in the Facebook Deepfake Detection Challenge (DFDC). FakeFinder builds a modular, scalable and extensible framework for evaluating various deepfake detection models. The toolkit provides a web application as well as API access for integration into existing media forensic workflow and applications. To illustrate the functionality in FakeFinder we have included implementations of six existing, open source Deepfake detectors as well as a template exemplifying how new algorithms can be easily added to the system.

Table of contents

  1. Overview
  2. Available Detectors
  3. Reproducing the Tool
  4. Usage Instruction


We have included instructions to reproduce the system as we have built it, using Docker containers with Compose or Kubernetes.

Available Detectors

Although designed for extensability, the current toolkit includes implementations for six detectors open sourced from the DeepFake Detection Challenge(DFDC) and the DeeperForensics Challenge 2020(DFC). The detectors included are:

Name Input type Challenge Description
selimsef video (mp4) DFDC1 Model Card
wm video (mp4) DFDC1 Model Card
ntech video (mp4) DFDC1 Model Card
eighteen video (mp4) DFDC1 Model Card
medics video (mp4) DFDC1 Model Card
boken video (mp4) DFC2 Model Card

Additionally, we have included template code and instructions for adding a new detector to the system in the detector template folder.

As part of the inplementation we have evaluated the current models against the test sets provided by both (1, 2) competitions after they closed. The following figure shows the True Positive Rate (TPR), False Positive Rate (FPR) and final accuracy (Acc) for all six models against these data. We have also included the average binary cross entropy (LogLoss) whcih was ultimately used to score the competition.


We have also measured the correlation between the six detectors over all of the evaulation dataset, shown in the following figure (Note: a correlation > 0.7 is considered a strong correlation)


Reproducing the Tool

We built FakeFinder using Docker for building and running containers, and Flask for the API server and serving models for inference. Here we provide instructions on reproducing the FakeFinder architecture. There are a few prerequisites:

GPU Host

The different detectors require the use of a GPU. We've tested against an AWS EC2 instance type of g4dn.xlarge using the Deep Learning AMI (Ubuntu 18.04) Version 52.0.

Clone the Repository

Some of the detectors use submodules so use the following command to clone the FakeFinder repo.

git clone --recurse-submodules -j8
cd FakeFinder

Model Weights

To access the weights for each model run the following commands:

mkdir weights
cd weights
wget -O boken.tar.gz
tar -xvzf boken.tar.gz
wget -O eighteen.tar.gz
tar -xvzf eighteen.tar.gz
wget -O medics.tar.gz
tar -xvzf medics.tar.gz
wget -O ntech.tar.gz
tar -xvzf ntech.tar.gz
wget -O selimsef.tar.gz
tar -xvzf selimsef.tar.gz
wget -O wm.tar.gz
tar -xvzf wm.tar.gz

This will create a top level directory called weights, with sub-directories for each detector.

FakeFinder can now be started with either Compose or Kubernetes

Start with Compose

docker-compose up -d --build

Start with Kubernetes

This has been tested using Minikube.It should be applicable in other Kuberenetes environments but has not been explicitly tested.

minikube start --driver docker --mount --mount-string $(pwd)/data/:/ff-data/
eval $(minikube docker-env) && \
docker build -t iqtlabs/fakefinder-api ./api && \
docker build -t iqtlabs/fakefinder-dash ./dash && \
docker build -t iqtlabs/fakefinder-detectors ./detectors 
minikube kubectl -- apply -f ff-networks.yaml -f ff-volumes.yaml -f ff-services.yaml -f ff-deployments.yaml

You should then be able to point a browser to the host's IP address to access the web application.

Usage Instructions

Using the Dash App

The above example demonstrates using the Inference Tool section of the web app. Users can upload a video by clicking on the Upload box of the Input Video section. The dropdown menu autopopulates upon upload completion, and users can play the video via a series of controls. There is the ability to change the volume, playback speed and current location within the video file.

In the Inference section of the page, users may select from the deep learning models available through the API. After checking the boxes of requested models, the Submit button will call the API to run inference for each model. The results are returned in the table, which includes an assignment of Real or Fake based on the model probability output, as well as graphically, found below the table. The bar braph presents the confidence of the video being real or fake for each model and for submissions with more than one model, an average confidence score is also presented.


FakeFinder builds a modular framework for evaluating various deepfake detection models, offering a web application as well as API access for integration into existing workflows.








No packages published