👏 Product List

https://github.com/kby-ai/Product

👏 We have published the Face Liveness Detection, Face Recognition SDK and ID Card Recognition SDK for the server.

• FaceLivenessDetection-Docker

• FaceRecognition-Docker

• IDCardRecognition-Docker

This is the Face Liveness Detection Python project for Windows.

The demo is integrated with KBY-AI's Face Liveness Detection Server SDK.

We can customize the SDK to align with your specific requirements.

For other solutions, please explore the following:

Face Liveness Detection - Android(Basic SDK)

Face Liveness Detection - iOS(Basic SDK)

Face Recognition - Android(Standard SDK)

Face Recognition - iOS(Standard SDK)

Face Recognition - Flutter(Standard SDK)

Face Recognition - React-Native(Standard SDK)

Face Recognition - React-Native(Standard SDK)

Face Attribute - Android(Premium SDK)

Face Attribute - iOS(Premium SDK)

You can test the SDK using images from the following URL: https://web.kby-ai.com

To test the API, you can use Postman. Here are the endpoints for testing:

• Test with an image file: Send a POST request to http://18.221.33.238:8080/check_liveness.

• Test with a base64-encoded image: Send a POST request to http://18.221.33.238:8080/check_liveness_base64.

  You can download the Postman collection to easily access and use these endpoints. click here

  

This project uses KBY-AI's Face Liveness Detection Server SDK, which requires a license per machine.

• The code below shows how to use the license: https://github.com/kby-ai/FaceLivenessDetection-Windows/blob/e7ffeecc21f6053828a744e127ddef2e8a34c4a2/test.py#L32-L44

• In order to request the license, please provide us with the machine code obtained from the "getMachineCode" function.

  Please contact us:

  Email: [email protected]
  
  Telegram: @kbyai
  
  WhatsApp: +19092802609
  
  Skype: live:.cid.66e2522354b1049b
  
  

We have not published facesdk1.dll. If you need the SDK DLL, please get in touch with us.

• CPU: 2 cores or more (Recommended: 8 cores)
• RAM: 4 GB or more (Recommended: 8 GB)
• HDD: 4 GB or more (Recommended: 8 GB)
• OS: Windows 7 or later
• Dependency: OpenVINO™ Runtime (Version: 2022.3), ncnn Runtime(20220721) or later, Vulkan SDK Runtime(1.3.250)

• Clone the project:

  git clone https://github.com/kby-ai/FaceLivenessDetection-Windows.git
  

• Download the model from Google Drive and unzip: click here

• Run the python code:

  python test.py
  

• Send us the machine code and replace the license.txt file you received. Then, run python code again.

  

  

• Step One

  First, obtain the machine code for activation and request a license based on the machine code.

  machineCode = getMachineCode()
  print("machineCode: ", machineCode.decode('utf-8'))
  

• Step Two

  Next, activate the SDK using the received license.

  setActivation(license.encode('utf-8'))
  

  If activation is successful, the return value will be SDK_SUCCESS. Otherwise, an error value will be returned.

• Step Three

  After activation, call the initialization function of the SDK.

  initSDK("data".encode('utf-8'))
  

  The first parameter is the path to the model.

  If initialization is successful, the return value will be SDK_SUCCESS. Otherwise, an error value will be returned.

• SDK_ERROR

  This enumeration represents the return value of the 'initSDK' and 'setActivation' functions.

  Feature	Value	Name
  Successful activation or initialization	0	SDK_SUCCESS
  License key error	-1	SDK_LICENSE_KEY_ERROR
  AppID error (Not used in Server SDK)	-2	SDK_LICENSE_APPID_ERROR
  License expiration	-3	SDK_LICENSE_EXPIRED
  Not activated	-4	SDK_NO_ACTIVATED
  Failed to initialize SDK	-5	SDK_INIT_ERROR

• FaceBox

  This structure represents the output of the face detection function.

  Feature	Type	Name
  Face rectangle	int	x1, y1, x2, y2
  Liveness score (0 ~ 1)	float	liveness
  Face angles (-45 ~ 45)	float	yaw, roll, pitch
  Face quality (0 ~ 1)	float	face_quality
  Face luminance (0 ~ 255)	float	face_luminance
  Eye distance (pixels)	float	eye_dist
  Eye closure (0 ~ 1)	float	left_eye_closed, right_eye_closed
  Face occlusion (0 ~ 1)	float	face_occlusion
  Mouth opening (0 ~ 1)	float	mouth_opened
  68 points facial landmark	float[]	landmarks_68

  68 points facial landmark

  

• Face Detection

  The Face SDK provides a single API for detecting faces, performing liveness detection, determining face orientation (yaw, roll, pitch), assessing face quality, detecting facial occlusion, eye closure, mouth opening, and identifying facial landmarks.

  The function can be used as follows:

  faceBoxes = (FaceBox * maxFaceCount)()
  faceCount = faceDetection(image_np, image_np.shape[1], image_np.shape[0], faceBoxes, maxFaceCount)
  

  This function requires 5 parameters.

  • The first parameter: the byte array of the RGB image buffer.
  • The second parameter: the width of the image.
  • The third parameter: the height of the image.
  • The fourth parameter: the 'FaceBox' array allocated with 'maxFaceCount' for storing the detected faces.
  • The fifth parameter: the count allocated for the maximum 'FaceBox' objects.

  The function returns the count of the detected face.

The default thresholds are as the following below: https://github.com/kby-ai/FaceLivenessDetection-Windows/blob/e7ffeecc21f6053828a744e127ddef2e8a34c4a2/test.py#L13-L25