Skip to content

CompreFace Review

CompreFace is Exadel's free, open-source face recognition server under Apache 2.0: a Docker app with a REST API and web UI for recognition, verification, detection and plugins. Last release: August 2023.

Free · Web, Docker · API

Stork's verdict on CompreFace

The easiest free self-hosted face recognition server to stand up, but with no release since August 2023 you are taking on its maintenance.

CompreFace reviewed by Stork AI · stork.ai/en/compreface

What CompreFace does

CompreFace is a ready-made face recognition service from Exadel. It runs as five Docker containers (core, API, admin, UI and a Postgres database) and exposes a REST API for face recognition (1:N against subjects you upload), face verification (1:1), face detection, and plugins for landmarks, age, gender, mask detection and head pose. A web UI handles applications, services, API keys and user roles, so you can give different teams access to different face collections. SDKs exist for JavaScript, Python and .NET, and it is a common add-on in Home Assistant setups via Double Take and Frigate.

Setup is: install Docker and Docker Compose, download the release archive, run docker-compose up -d, and open port 8000. A single-container image and Kubernetes scripts are also available. The default build uses FaceNet with MTCNN detection; custom builds swap in InsightFace models (MobileFaceNet, SubCenter-ArcFace) with optional GPU support. All data stays on your machine in a Docker volume.

CompreFace pricing

CompreFace is free and open source under the Apache 2.0 licence, with no paid tier listed in the repository.

ComponentLicencePrice
CompreFace server, UI and SDKsApache 2.0$0
Default build (FaceNet, MTCNN)FaceNet repository is MIT$0
InsightFace-based custom buildsInsightFace model terms applyCheck InsightFace's licence

What it costs to run: your own hardware. The default build needs an x86 CPU with AVX and does not support GPU; the InsightFace-based builds need AVX2, and the GPU variants need CUDA. The docs advise GPU builds for real-time recognition and mobile-derived models for older hardware. The project publishes no RAM or throughput figures.

If you use an InsightFace-based build commercially, note that InsightFace states its pretrained models are for non-commercial research only unless licensed.

Prices checked on the vendor's pricing page on November 12, 2026. See the CompreFace repository and licence.

Key features

From the CompreFace README and docs:

  • Face recognition, verification and detection services over REST
  • Plugins: landmarks, age, gender, mask detection and head pose
  • Web UI with applications, API keys and user roles
  • Docker Compose, single-container and Kubernetes deployment
  • Option to skip detection or send embeddings instead of images (v1.2.0)
  • CPU and GPU custom builds, including CUDA 11.8 support
  • JavaScript, Python and .NET SDKs

Who CompreFace is best for

CompreFace suits teams and hobbyists who want a working face recognition server on their own hardware without writing ML code: door cameras with Home Assistant, attendance or access systems, internal photo tools. Role management makes it workable for small organisations.

The catch is maintenance. The last release (v1.2.0) is from August 22, 2023, the last commit on the main branch is from November 2023, and there are about 235 open issues, so plan to own security updates yourself. For an actively developed library, use DeepFace; for an actively developed server with a commercial model licence option, InsightFace Server; for a managed API, Amazon Rekognition.

What users say

CompreFace has about 8,400 stars on GitHub. Home Assistant users recommend it with Double Take for doorbell and camera recognition; one user on the Home Assistant forum says they are satisfied with the results but gave its VM 6 GB of RAM. Tutorials such as this Frigate, Double Take and CompreFace guide show it as the recognition step in self-hosted camera setups.

Pros

  • Free under Apache 2.0, fully self-hosted
  • Working server with UI, roles and API keys out of the box
  • One-command Docker Compose install
  • Recognition, verification, detection and attribute plugins
  • Popular in Home Assistant camera setups

Cons

  • No release since August 2023; maintenance is on you
  • Default build is CPU-only and needs AVX
  • InsightFace-based builds carry non-commercial model terms
  • No published RAM or throughput sizing

Frequently asked questions

Is CompreFace free?

Yes. CompreFace is open source under the Apache 2.0 licence and self-hosted, so you pay only for your own hardware. If you choose an InsightFace-based custom build, check InsightFace's model licence for commercial use.

Is CompreFace still maintained?

Development has slowed. The latest release, v1.2.0, was published on August 22, 2023, and the last commit on the main branch was in November 2023. The repository is not archived and has about 235 open issues.

What are CompreFace's hardware requirements?

Docker and Docker Compose on an x86 machine with AVX support for the default build. InsightFace-based custom builds need AVX2, and GPU builds need an NVIDIA GPU with CUDA.

How do I install CompreFace?

Install Docker and Docker Compose, download the archive from the latest GitHub release, unzip it, run docker-compose up -d, and open http://localhost:8000/login. A single-container image (exadel/compreface) is also available.

Does CompreFace work with Home Assistant?

Yes, commonly through Double Take, which sends camera snapshots from Frigate to CompreFace for recognition. Home Assistant users describe it in forum threads and tutorials.

What face recognition model does CompreFace use?

The default build uses FaceNet with MTCNN detection. Custom builds use InsightFace models such as MobileFaceNet and SubCenter-ArcFace r100, with CPU and GPU variants.

Compare Alternatives

See every CompreFace alternative, compared

CompreFace

Free · Web, Docker · API

Enjoying this? Get one like it in your inbox each morning.

one email a day · unsubscribe in two clicks · no third-party tracking