Home

Awesome

<h1 align="center">Exadel CompreFace is a leading free and open-source face recognition system</h1> <p align="center"> <a target="_blank" href="https://exadel.com/solutions/compreface/"> <img src="https://user-images.githubusercontent.com/3736126/147130206-17234c47-8d40-490f-8d93-57014fa6d87e.png" alt="angular-logo" height="250px"/> </a> <br> <i>Exadel CompreFace is a free and open-source face recognition service that can be easily integrated into any system without prior machine learning skills. CompreFace provides REST API for face recognition, face verification, face detection, landmark detection, mask detection, head pose detection, age, and gender recognition and is easily deployed with docker. </i> <br> </p> <p align="center"> <a href="https://exadel.com/solutions/compreface/"><strong>Official website</strong></a> <br> </p> <p align="center"> <a href="#contributing">Contributing</a> · <a href="https://github.com/exadel-inc/CompreFace/issues">Submit an Issue</a> · <a href="https://exadel.com/news/tag/compreface/">Blog</a> · <a href="https://gitter.im/CompreFace/community">Community chat</a> <br> </p> <p align="center"> <a href="https://www.apache.org/licenses/LICENSE-2.0"> <img src="https://img.shields.io/github/license/exadel-inc/CompreFace" alt="GitHub license" /> </a>&nbsp; <a href="https://github.com/exadel-inc/CompreFace/graphs/contributors"> <img src="https://img.shields.io/github/contributors/exadel-inc/CompreFace" alt="GitHub contributors" /> </a>&nbsp; </p> <hr>

Table Of Contents

Overview

Exadel CompreFace is a free and open-source face recognition GitHub project. Essentially, it is a docker-based application that can be used as a standalone server or deployed in the cloud. You don’t need prior machine learning skills to set up and use CompreFace.

The system provides REST API for face recognition, face verification, face detection, landmark detection, mask detection, head pose detection, age, and gender recognition. The solution also features a role management system that allows you to easily control who has access to your Face Recognition Services.

CompreFace is delivered as a docker-compose config and supports different models that work on CPU and GPU. Our solution is based on state-of-the-art methods and libraries like FaceNet and InsightFace.

Screenshots

<p align="center"> <img src="https://github.com/exadel-inc/CompreFace/assets/3736126/7b86a96f-844b-4e4b-9456-c53f6e45f305" alt="compreface-recognition-page" width=390px style="padding: 0px 10px 0px 0px;"> <img src="https://github.com/exadel-inc/CompreFace/assets/3736126/51efb9d0-70cc-4902-bc3f-fd85de004b67" alt="compreface-dashboard-page" width="390px" style="padding: 0px 0px 0px 10px;"> </p> <details> <summary> <b>More Screenshots</b> </summary> <!-- have to be followed by an empty line! --> <p align="center"> <img src="https://github.com/exadel-inc/CompreFace/assets/3736126/3ae0ce68-588b-4370-8eaf-32668c96fa63" alt="compreface-verification-page" width=390px style="padding: 0px 10px 0px 0px;"> <img src="https://github.com/exadel-inc/CompreFace/assets/3736126/9246702d-1c9b-4435-8098-89e0fb616b0d" alt="compreface-detection-page" width="390px" style="padding: 0px 0px 0px 10px;"> </p> <p align="center"> <img src="https://github.com/exadel-inc/CompreFace/assets/3736126/3a5787e6-9a85-4852-92dc-a82fe7ef8f7c" alt="compreface-services-page" width=390px style="padding: 0px 10px 0px 0px;"> <img src="https://github.com/exadel-inc/CompreFace/assets/3736126/e7fd0258-2643-4cec-809d-988502eb857f" alt="compreface-wizzard-page" width="390px" style="padding: 0px 0px 0px 10px;"> </p> </details>

Videos

<p align="center"> <a target="_blank" href="https://www.youtube.com/watch?v=LS4sVTnI-gI"> <img src="https://user-images.githubusercontent.com/3736126/241272669-8609463b-8b22-4ae7-bf21-36761f00734b.jpg" alt="CompreFace Face Detection Demo" width=390px style="padding: 0px 10px 0px 0px;"> </a> <a target="_blank" href="https://www.youtube.com/watch?v=jkiA3S-LYSk"> <img src="https://user-images.githubusercontent.com/3736126/242002411-3c06d3f7-c0ac-49f8-ac79-42bd8c431570.png" alt="CompreFace Appery.io Demo" width=390px style="padding: 0px 10px 0px 0px;"> </a> </p> <details> <summary> <b>More Videos</b> </summary> <!-- have to be followed by an empty line! --> <p align="center"> <a target="_blank" href="https://www.youtube.com/watch?v=cF3P7bTJXY0"> <img src="https://user-images.githubusercontent.com/3736126/241274256-0dc6d8a0-91d5-42c4-b029-200b72bb169b.jpg" alt="CompreFace .NET SDK Demo" width=390px style="padding: 0px 10px 0px 0px;"> </a> <a target="_blank" href="https://www.youtube.com/watch?v=9mQULPrTVP4"> <img src="https://user-images.githubusercontent.com/3736126/241274522-a152221f-e382-416c-9a71-f7694e73cf3e.jpg" alt="CompreFace JavaScript SDK Demo" width=390px style="padding: 0px 10px 0px 0px;"> </a> </p> </details>

News and updates

Subscribe to CompreFace News and Updates to never miss new features and product improvements.

Features

The system can accurately identify people even when it has only “seen” their photo once. Technology-wise, CompreFace has several advantages over similar free face recognition solutions. CompreFace:

Functionalities

Getting Started with CompreFace

Requirements

  1. Docker and Docker compose (or Docker Desktop)
  2. CompreFace could be run on most modern computers with x86 processor and AVX support. To check AVX support on Linux run lscpu | grep avx command

To get started (Linux, MacOS):

  1. Install Docker and Docker Compose
  2. Download the archive from our latest release: https://github.com/exadel-inc/CompreFace/releases
  3. Unzip the archive
  4. Open the terminal in this folder and run this command: docker-compose up -d
  5. Open the service in your browser: http://localhost:8000/login

To get started (Windows):

  1. Install Docker Desktop
  2. Download the archive from our latest release: https://github.com/exadel-inc/CompreFace/releases
  3. Unzip the archive
  4. Run Docker
  5. Open Command prompt (write cmd in windows search bar)
  6. Open folder where you extracted zip archive (Write cd path_of_the_folder, press enter).
  7. Run command: docker-compose up -d
  8. Open http://localhost:8000/login

Getting started for contributors

Follow this link

CompreFace SDKs

SDKRepository
JavaScripthttps://github.com/exadel-inc/compreface-javascript-sdk
Pythonhttps://github.com/exadel-inc/compreface-python-sdk
.NEThttps://github.com/exadel-inc/compreface-net-sdk

Documentation

More documentation is available here

Contributing

We want to improve our open-source face recognition solution, so your contributions are welcome and greatly appreciated.

For more information, visit our contributing guide, or create a discussion.

License info

CompreFace is open-source real-time facial recognition software released under the Apache 2.0 license.