Awesome
The world's simplest facial recognition api for .NET
This repository is porting https://github.com/ageitgey/face_recognition by C#.
This package supports cross platform, Windows, Linux and MacOSX!!
| Package | OS | x86 | x64 | ARM | ARM64 | Nuget |
|---|---|---|---|---|---|---|
| FaceRecognitionDotNet (CPU) | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | ✓ | - | - | | |
| FaceRecognitionDotNet for CUDA 9.2 | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | - | - | - | | |
| FaceRecognitionDotNet for CUDA 10.0 | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | - | - | - | | |
| FaceRecognitionDotNet for CUDA 10.1 | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | - | - | - | | |
| FaceRecognitionDotNet for CUDA 10.2 | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | - | - | - | | |
| FaceRecognitionDotNet for CUDA 11.0 | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | - | - | - | | |
| FaceRecognitionDotNet for CUDA 11.1 | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | - | - | - | | |
| FaceRecognitionDotNet for CUDA 11.2 | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | - | - | - | | |
| FaceRecognitionDotNet for Intel MKL | Windows | - | ✓ | - | - |  |
| Linux | - | ✓ | - | - | | |
| OSX | - | ✓ | - | - | | |
| FaceRecognitionDotNet for ARM | Windows | - | - | - | - |  |
| Linux | - | - | - | - | | |
| OSX | - | - | - | - | |
:warning: FaceRecognitionDotNet for ARM is not tested yet
Support API
| face_recognition API | Corresponding API | Note |
|---|---|---|
| batch_face_locations | BatchFaceLocations | |
| compare_faces | CompareFaces | |
| face_distance | FaceDistance | |
| face_encodings | FaceEncodings | |
| face_landmarks | FaceLandmarks | And support Helen dataset :warning: |
| face_locations | FaceLocations | And support to get confidence and use custom face detector |
| load_image_file | LoadImageFile | |
| - | CropFaces | Crop image with specified locations |
| - | EyeBlinkDetect | Detect person is blinking or not<br>Support Large model and Helen dataset :warning: |
| - | LoadImage | From memory data or System.Drawing.Bitmap |
| - | PredictAge | Predict human age.<br>Use Adience Benchmark Of Unfiltered Faces For Gender And Age Classification dataset :warning: |
| - | PredictEmotion | Predict emotion for human face.<br>Use Corrective re-annotation of FER - CK+ - KDEF :warning: |
| - | PredictGender | Predict human gender.<br>Use UTKFace dataset :warning: |
| - | PredictProbabilityAge | Predict probability of human age.<br>Use Adience Benchmark Of Unfiltered Faces For Gender And Age Classification dataset :warning: |
| - | PredictProbabilityEmotion | Predict probability of emotion from human face.<br>Use Corrective re-annotation of FER - CK+ - KDEF :warning: |
| - | PredictProbabilityGender | Predict probability of human gender.<br>Use UTKFace dataset :warning: |
| - | PredictHeadPose | Predict human head pose.<br>Use 300W-LP dataset :warning: |
:warning: Warning
You must train dataset by yourself. I will NOT provide pretrained model file due to avoiding license issue. You can check the following examples to train dataset.
- tools/AgeTraining
- tools/EmotionTraining
- tools/EmotionTrainingV2
- tools/GenderTraining
- tools/HeadPoseTraining
- tools/HelenTraining
Demo
Face Recognition
<img src="images/1.png" width="480"/> <img src="images/2.png" width="480"/>
Other Face Functions
| Face Landmark | Age and Gender Classification | Head Pose Estimation | Emotion Estimation |
|---|---|---|---|
| <img src="images/3.jpg" width="240"/> | <img src="examples/CustomClassificationDemo/images/result.png" width="240"/> | <img src="images/4.png" width="240"/> | <img src="images/5.jpg" width="240"/> |
Document
FaceRecognitionDotNet support full xml document for Visual Studio. A xml document is written English and Japanese. And you can check online document at FaceRecognitionDotNet API Document
Dependencies Libraries and Products
face_recognition
License: The MIT License
Author: Adam Geitgey
Principal Use: The world's simplest facial recognition api for Python and the command line. Main goal of FaceRecognitionDotNet is what ports face_recognition by C#.
face_recognition_models
License: Creative Commons Zero v1.0 Universal License
Author: Adam Geitgey
Principal Use: Trained models for the face_recognition python library
dlib
License: Boost Software License
Author: Davis E. King
Principal Use: A toolkit for making real world machine learning and data analysis applications in C++.
DlibDotNet
License: The MIT License
Author: Takuya Takeuchi
Principal Use: Use dlib interface via .NET. This library is developed by this owner.
OpenCVSharp
License: The BSD 3-Clause License
Author: shimat
Principal Use: Loading image data by opencv wrapper for example