CompreFace: Free and Open-Source Face Recognition System with REST API

CompreFace: Free and Open-Source Face Recognition System with REST API

Summary

CompreFace is a leading free and open-source face recognition system that offers a robust REST API for various facial analysis tasks. It can be easily integrated into any system without requiring prior machine learning expertise, thanks to its Docker-based deployment. This powerful solution supports face recognition, detection, verification, and more, leveraging state-of-the-art methods like FaceNet and InsightFace.

Repository Info

Updated on April 12, 2026
View on GitHub

Tags

face recognitioncomputer visiondockerREST APIopen sourceJavamachine learningface detection

Click on any tag to explore related repositories

Introduction

CompreFace is a powerful, free, and open-source face recognition system designed for easy integration into any application. Built on Docker, it simplifies the deployment of advanced facial analysis capabilities, making them accessible even without prior machine learning skills. CompreFace provides a comprehensive REST API that supports a wide range of functionalities, including face recognition, verification, detection, landmark detection, mask detection, head pose detection, and age and gender recognition. It leverages cutting-edge libraries like FaceNet and InsightFace to deliver accurate and reliable results.

Installation

Getting started with CompreFace is straightforward, primarily requiring Docker and Docker Compose.

Requirements

  • Docker and Docker Compose (or Docker Desktop for Windows)
  • A modern computer with an x86 processor and AVX support. You can check AVX support on Linux using lscpu | grep avx.

Steps to Get Started (Linux, MacOS, Windows)

  1. Install Docker and Docker Compose (if not already installed). For Windows, install Docker Desktop.
  2. Download the latest release archive from the official GitHub repository: https://github.com/exadel-inc/CompreFace/releases
  3. Unzip the downloaded archive to your desired directory.
  4. Open your terminal or command prompt, navigate to the unzipped folder, and run the following command: 
    docker-compose up -d
  5. Once the services are running, open your web browser and navigate to: http://localhost:8000/login

Examples of Functionalities

CompreFace offers a rich set of face recognition services through its REST API and a user-friendly UI panel for management:

  • Face Detection: Identify the presence and location of faces in an image.
  • Face Recognition: Match detected faces against a database of known individuals.
  • Face Verification: Confirm if two faces belong to the same person.
  • Landmark Detection: Pinpoint key facial features like eyes, nose, and mouth.
  • Age Recognition: Estimate the age of detected individuals.
  • Gender Recognition: Determine the gender of detected individuals.
  • Face Mask Detection: Identify if a person is wearing a face mask.
  • Head Pose Detection: Analyze the orientation of a person's head.

For detailed usage and API descriptions, refer to the comprehensive documentation.

Why Use CompreFace?

CompreFace stands out as a robust solution for several compelling reasons:

  • Open-Source and Self-Hosted: Provides complete control over your data and infrastructure, ensuring enhanced security and privacy.
  • Scalable Performance: Supports both CPU and GPU, allowing for flexible scaling to meet varying demands.
  • Easy Deployment: Can be deployed effortlessly in the cloud or on-premises using Docker, without requiring specialized machine learning expertise.
  • State-of-the-Art Technology: Built upon leading libraries like FaceNet and InsightFace, ensuring high accuracy and performance.
  • Comprehensive API: Offers a wide array of facial analysis services through a well-documented REST API.
  • Active Community & Development: Benefits from an active development team and community contributions, ensuring continuous improvement and support.

Links