face-comparer 2.0

A Python module for face comparison using face_recognition and Base64 conversion.

Face Comparer

Overview

This Python module provides functionality to encode images to Base64 format and compare faces. It supports both file-based and Base64-based image comparisons.

Table of Contents

• Installation
• Usage
  • Importing the Module
  • Convert Image to Base64
  • Convert Base64 to Image
  • Compare Faces from Image Paths
  • Compare Faces from Base64 Strings
• Features
• Limitations
• License

Installation

Ensure you have the required dependencies installed before using this module:

pip install face_recognition numpy pillow

Usage

Importing the Module

from face_comparer import ImageConverter, FaceComparer

Convert Image to Base64

converter = ImageConverter()
base64_string = converter.image_to_base64("path_to_image.jpg")

Convert Base64 to Image

image_array = converter.base64_to_image(base64_string)

Compare Faces from Image Paths

comparer = FaceComparer()
result = comparer.compare_faces("image1.jpg", "image2.jpg")
print(result)

Compare Faces from Base64 Strings

result = comparer.compare_faces_from_base64(base64_string1, base64_string2)
print(result)

Features

• Convert images to Base64 format and vice versa.
• Compare faces using face_recognition.
• Handle both file paths and Base64 encoded images.

Limitations

• Requires images to have at least one recognizable face.
• Works best with clear, front-facing images.

License

This project is licensed under the MIT License.