OpenFace2

A clean, up-to-date Docker image for OpenFace 2.2.0 that just works.

---

Why this exists

The official OpenFace Docker image and many forks often fail at runtime with Model file not found errors (especially for landmark detection). This image fixes that by:

• Building OpenFace 2.2.0 from source.
• Downloading the latest models.
• Placing patch_experts in all expected lookup paths.
• Exposing binaries directly on PATH.

Result: no missing model errors.

---

Quick start

# Pull the image
docker pull ghcr.io/n-mahesh/openface2:latest

# Run a tool (help menu)
docker run --rm ghcr.io/n-mahesh/openface2:latest FeatureExtraction -help

# Process an image
docker run --rm -v $PWD:/data ghcr.io/n-mahesh/openface2:latest \
  FeatureExtraction -f /data/input.jpg -out_dir /data/out

Outputs (landmarks, CSVs, etc.) will appear in /data/out.

---

Features

• Ubuntu 20.04 base, headless build (no GUI, no CUDA).
• Latest dlib + OpenFace (built from source).
• Models pre-downloaded and patched for correct runtime paths.
• Tools like FeatureExtraction, FaceLandmarkVid, and more available directly in PATH.

---

License

This image only packages upstream software.

• OpenFace: © original authors, see OpenFace license.
• dlib: © Davis E. King, see dlib license.

---

Maintainer: @N-Mahesh