Upload face API

.dockerignore

@@ -0,0 +1,4 @@
+venv
+__pycache__
+.env
+*.pyc

.env

@@ -0,0 +1,14 @@
+# Face Verification API Configuration
+# Copy this file to .env and adjust values as needed
+
+# Face matching threshold (0.0 to 1.0)
+# Lower = stricter matching, Higher = more lenient
+# Default 0.6 is recommended for balance between security and usability
+FACE_MATCH_THRESHOLD=0.6
+
+# CORS allowed origins (comma-separated)
+# Use * for development, restrict in production
+ALLOWED_ORIGINS=*
+
+# Server port
+PORT=8000

Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.11-slim
+
+RUN apt-get update && apt-get install -y \
+    build-essential cmake \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+COPY . /app
+
+RUN pip install --upgrade pip && pip install -r requirements.txt
+
+ENV PORT=7860
+CMD ["python", "main.py"]

README.md

@@ -1,12 +1,122 @@
----
-title: Face Api
-emoji: 📊
-colorFrom: indigo
-colorTo: purple
-sdk: docker
-pinned: false
-license: apache-2.0
-short_description: Face api
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Face Verification API
+
+A self-hosted Python backend for face enrollment and authentication, replacing FaceIO.
+
+## Prerequisites
+
+- Python 3.9+
+- pip (Python package manager)
+- CMake and dlib dependencies (required for face_recognition)
+
+### Windows Setup
+
+1. Install Visual Studio Build Tools with C++ development tools
+2. Install CMake: `winget install cmake`
+
+### Linux/Mac Setup
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install build-essential cmake
+
+# macOS
+brew install cmake
+```
+
+## Installation
+
+```bash
+cd services/face-api
+
+# Create virtual environment
+python -m venv venv
+
+# Activate virtual environment
+# Windows:
+venv\Scripts\activate
+# Linux/Mac:
+source venv/bin/activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+## Configuration
+
+Copy `.env.example` to `.env` and adjust settings:
+
+```bash
+cp .env.example .env
+```
+
+Configuration options:
+- `FACE_MATCH_THRESHOLD`: Face matching strictness (0.6 recommended)
+- `ALLOWED_ORIGINS`: CORS origins (comma-separated)
+- `PORT`: Server port (default: 8000)
+
+## Running the Server
+
+```bash
+# Development with auto-reload
+python -m uvicorn main:app --reload --host 0.0.0.0 --port 8000
+
+# Production
+python main.py
+```
+
+## API Endpoints
+
+### Health Check
+```
+GET /health
+```
+
+### Enroll Face
+```
+POST /enroll
+Content-Type: application/json
+
+{
+  "image_base64": "base64_encoded_image",
+  "user_id": "user_uuid",
+  "metadata": {} // optional
+}
+```
+
+Response:
+```json
+{
+  "success": true,
+  "face_id": "face_user_uuid_timestamp",
+  "face_embedding": [128 float values],
+  "message": "Face enrolled successfully"
+}
+```
+
+### Verify Face
+```
+POST /verify
+Content-Type: application/json
+
+{
+  "image_base64": "base64_encoded_image",
+  "stored_embedding": [128 float values],
+  "user_id": "user_uuid" // optional
+}
+```
+
+Response:
+```json
+{
+  "success": true,
+  "match": true,
+  "confidence": 0.85,
+  "message": "Face verified successfully"
+}
+```
+
+## Testing
+
+```bash
+curl http://localhost:8000/health
+```

cmake_check.txt

@@ -0,0 +1,3 @@
+cmake version 3.31.6-msvc6
+
+CMake suite maintained and supported by Kitware (kitware.com/cmake).

install_log.txt

@@ -0,0 +1,112 @@
+Using pip 25.0.1 from C:\Users\Malar\Desktop\add\attendance-app\services\face-api\venv\Lib\site-packages\pip (python 3.12)
+Collecting dlib
+  Using cached dlib-20.0.0.tar.gz (3.3 MB)
+  Installing build dependencies: started
+  Running command pip subprocess to install build dependencies
+  Using pip 25.0.1 from C:\Users\Malar\Desktop\add\attendance-app\services\face-api\venv\Lib\site-packages\pip (python 3.12)
+  Collecting setuptools
+    Obtaining dependency information for setuptools from https://files.pythonhosted.org/packages/a3/dc/17031897dae0efacfea57dfd3a82fdd2a2aeb58e0ff71b77b87e44edc772/setuptools-80.9.0-py3-none-any.whl.metadata
+    Using cached setuptools-80.9.0-py3-none-any.whl.metadata (6.6 kB)
+  Collecting wheel
+    Obtaining dependency information for wheel from https://files.pythonhosted.org/packages/0b/2c/87f3254fd8ffd29e4c02732eee68a83a1d3c346ae39bc6822dcbcb697f2b/wheel-0.45.1-py3-none-any.whl.metadata
+    Using cached wheel-0.45.1-py3-none-any.whl.metadata (2.3 kB)
+  Using cached setuptools-80.9.0-py3-none-any.whl (1.2 MB)
+  Using cached wheel-0.45.1-py3-none-any.whl (72 kB)
+  Installing collected packages: wheel, setuptools
+    Creating C:\Users\Malar\AppData\Local\Temp\pip-build-env-6ojhd8_o\overlay\Scripts
+  Successfully installed setuptools-80.9.0 wheel-0.45.1
+  Installing build dependencies: finished with status 'done'
+  Getting requirements to build wheel: started
+  Running command Getting requirements to build wheel
+  running egg_info
+  writing tools/python\dlib.egg-info\PKG-INFO
+  writing dependency_links to tools/python\dlib.egg-info\dependency_links.txt
+  writing top-level names to tools/python\dlib.egg-info\top_level.txt
+  reading manifest file 'tools/python\dlib.egg-info\SOURCES.txt'
+  reading manifest template 'MANIFEST.in'
+  no previously-included directories found matching 'tools\python\build*'
+  no previously-included directories found matching 'dlib\cmake_utils\*\build*'
+  no previously-included directories found matching 'dlib\test'
+  warning: no previously-included files matching '*.pyc' found anywhere in distribution
+  adding license file 'LICENSE.txt'
+  writing manifest file 'tools/python\dlib.egg-info\SOURCES.txt'
+  Getting requirements to build wheel: finished with status 'done'
+  Preparing metadata (pyproject.toml): started
+  Running command Preparing metadata (pyproject.toml)
+  running dist_info
+  creating C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib.egg-info
+  writing C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib.egg-info\PKG-INFO
+  writing dependency_links to C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib.egg-info\dependency_links.txt
+  writing top-level names to C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib.egg-info\top_level.txt
+  writing manifest file 'C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib.egg-info\SOURCES.txt'
+  reading manifest file 'C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib.egg-info\SOURCES.txt'
+  reading manifest template 'MANIFEST.in'
+  no previously-included directories found matching 'tools\python\build*'
+  no previously-included directories found matching 'dlib\cmake_utils\*\build*'
+  no previously-included directories found matching 'dlib\test'
+  warning: no previously-included files matching '*.pyc' found anywhere in distribution
+  adding license file 'LICENSE.txt'
+  writing manifest file 'C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib.egg-info\SOURCES.txt'
+  creating 'C:\Users\Malar\AppData\Local\Temp\pip-modern-metadata-sqp11mfi\dlib-20.0.0.dist-info'
+  Preparing metadata (pyproject.toml): finished with status 'done'
+Building wheels for collected packages: dlib
+  Building wheel for dlib (pyproject.toml): started
+  Running command Building wheel for dlib (pyproject.toml)
+  running bdist_wheel
+  running build
+  running build_ext
+
+  ================================================================================
+  ================================================================================
+  ================================================================================
+
+                     CMake is not installed on your system!
+
+      Or it is possible some broken copy of cmake is installed on your system.
+      It is unfortunately very common for python package managers to include
+      broken copies of cmake.  So if the error above this refers to some file
+      path to a cmake file inside a python or anaconda or miniconda path then you
+      should delete that broken copy of cmake from your computer.
+
+      Instead, please get an official copy of cmake from one of these known good
+      sources of an official cmake:
+          - cmake.org (this is how windows users should get cmake)
+          - apt install cmake (for Ubuntu or Debian based systems)
+          - yum install cmake (for Redhat or CenOS based systems)
+
+      On a linux machine you can run `which cmake` to see what cmake you are
+      actually using.  If it tells you it's some cmake from any kind of python
+      packager delete it and install an official cmake.
+
+      More generally, cmake is not installed if when you open a terminal window
+      and type
+         cmake --version
+      you get an error.  So you can use that as a very basic test to see if you
+      have cmake installed.  That is, if cmake --version doesn't run from the
+      same terminal window from which you are reading this error message, then
+      you have not installed cmake.  Windows users should take note that they
+      need to tell the cmake installer to add cmake to their PATH.  Since you
+      can't run commands that are not in your PATH.  This is how the PATH works
+      on Linux as well, but failing to add cmake to the PATH is a particularly
+      common problem on windows and rarely a problem on Linux.
+
+  ================================================================================
+  ================================================================================
+  ================================================================================
+  error: subprocess-exited-with-error
+  
+  Building wheel for dlib (pyproject.toml) did not run successfully.
+  exit code: 1
+  
+  See above for output.
+  
+  note: This error originates from a subprocess, and is likely not a problem with pip.
+  full command: 'C:\Users\Malar\Desktop\add\attendance-app\services\face-api\venv\Scripts\python.exe' 'C:\Users\Malar\Desktop\add\attendance-app\services\face-api\venv\Lib\site-packages\pip\_vendor\pyproject_hooks\_in_process\_in_process.py' build_wheel 'C:\Users\Malar\AppData\Local\Temp\tmp_pksdet5'
+  cwd: C:\Users\Malar\AppData\Local\Temp\pip-install-0v9s1j6y\dlib_5c30ebd48f0e49868e1123af08a37856
+  Building wheel for dlib (pyproject.toml): finished with status 'error'
+  ERROR: Failed building wheel for dlib
+Failed to build dlib
+
+[notice] A new release of pip is available: 25.0.1 -> 25.3
+[notice] To update, run: python.exe -m pip install --upgrade pip
+ERROR: Failed to build installable wheels for some pyproject.toml based projects (dlib)

main.py

@@ -0,0 +1,282 @@
+"""
+Face Verification API - Python backend for face enrollment and authentication.
+Replaces FaceIO with a self-hosted solution using face_recognition library.
+"""
+
+import base64
+import io
+import os
+import json
+from typing import Optional, List
+from contextlib import asynccontextmanager
+
+import numpy as np
+import face_recognition
+from PIL import Image
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from pydantic import BaseModel
+from dotenv import load_dotenv
+
+# Load environment variables
+load_dotenv()
+
+# Configuration
+FACE_MATCH_THRESHOLD = float(os.getenv("FACE_MATCH_THRESHOLD", "0.6"))
+ALLOWED_ORIGINS = os.getenv("ALLOWED_ORIGINS", "*").split(",")
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    """Application lifespan handler."""
+    print("🚀 Face Verification API starting...")
+    print(f"   Match threshold: {FACE_MATCH_THRESHOLD}")
+    yield
+    print("👋 Face Verification API shutting down...")
+
+
+app = FastAPI(
+    title="Face Verification API",
+    description="Self-hosted face enrollment and authentication service",
+    version="1.0.0",
+    lifespan=lifespan
+)
+
+# Configure CORS
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=ALLOWED_ORIGINS if ALLOWED_ORIGINS[0] != "*" else ["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+# Request/Response Models
+class EnrollRequest(BaseModel):
+    """Request model for face enrollment."""
+    image_base64: str
+    user_id: str
+    metadata: Optional[dict] = None
+
+
+class EnrollResponse(BaseModel):
+    """Response model for face enrollment."""
+    success: bool
+    face_id: str
+    face_embedding: List[float]
+    message: str
+
+
+class VerifyRequest(BaseModel):
+    """Request model for face verification."""
+    image_base64: str
+    stored_embedding: List[float]
+    user_id: Optional[str] = None
+
+
+class VerifyResponse(BaseModel):
+    """Response model for face verification."""
+    success: bool
+    match: bool
+    confidence: float
+    message: str
+
+
+class HealthResponse(BaseModel):
+    """Response model for health check."""
+    status: str
+    version: str
+
+
+def decode_base64_image(base64_string: str) -> np.ndarray:
+    """
+    Decode a base64 image string to a numpy array for face_recognition.
+    Supports both raw base64 and data URI format.
+    """
+    # Remove data URI prefix(es) if present
+    # Handle cases like "data:image/jpeg;base64,data:image/png;base64,..."
+    if "," in base64_string:
+        base64_string = base64_string.split(",")[-1]
+    
+    # Clean up the string and fix padding
+    base64_string = base64_string.strip()
+    padding = len(base64_string) % 4
+    if padding > 0:
+        base64_string += "=" * (4 - padding)
+    
+    try:
+        image_bytes = base64.b64decode(base64_string)
+        image = Image.open(io.BytesIO(image_bytes))
+        
+        # Convert to RGB if necessary (face_recognition requires RGB)
+        if image.mode != "RGB":
+            image = image.convert("RGB")
+        
+        return np.array(image)
+    except Exception as e:
+        raise HTTPException(
+            status_code=400,
+            detail=f"Invalid image data: {str(e)}"
+        )
+
+
+def extract_face_encoding(image: np.ndarray) -> np.ndarray:
+    """
+    Extract face encoding from an image.
+    Returns the 128-dimensional face encoding.
+    """
+    # Detect face locations
+    face_locations = face_recognition.face_locations(image, model="hog")
+    
+    if len(face_locations) == 0:
+        raise HTTPException(
+            status_code=400,
+            detail="No face detected in the image. Please ensure your face is clearly visible."
+        )
+    
+    if len(face_locations) > 1:
+        raise HTTPException(
+            status_code=400,
+            detail="Multiple faces detected. Please ensure only one face is visible."
+        )
+    
+    # Extract face encoding
+    face_encodings = face_recognition.face_encodings(image, face_locations)
+    
+    if len(face_encodings) == 0:
+        raise HTTPException(
+            status_code=400,
+            detail="Could not extract face features. Please try again with better lighting."
+        )
+    
+    return face_encodings[0]
+
+
+def compare_faces(stored_embedding: List[float], new_embedding: np.ndarray) -> tuple:
+    """
+    Compare two face embeddings and return match result and confidence.
+    """
+    stored_array = np.array(stored_embedding)
+    
+    # Calculate face distance (lower = more similar)
+    face_distance = face_recognition.face_distance([stored_array], new_embedding)[0]
+    
+    # Convert distance to confidence (invert so higher = more confident match)
+    confidence = 1.0 - face_distance
+    
+    # Check if faces match based on threshold
+    is_match = face_distance <= FACE_MATCH_THRESHOLD
+    
+    return is_match, float(confidence)
+
+
+@app.get("/health", response_model=HealthResponse)
+async def health_check():
+    """Health check endpoint."""
+    return HealthResponse(
+        status="healthy",
+        version="1.0.0"
+    )
+
+
+@app.post("/enroll", response_model=EnrollResponse)
+async def enroll_face(request: EnrollRequest):
+    """
+    Enroll a new face - extract and return face embedding for storage.
+    
+    The embedding should be stored in the database by the client app.
+    """
+    try:
+        # Decode image
+        image = decode_base64_image(request.image_base64)
+        
+        # Extract face encoding
+        face_encoding = extract_face_encoding(image)
+        
+        # Generate a simple face ID (timestamp-based)
+        import time
+        face_id = f"face_{request.user_id}_{int(time.time() * 1000)}"
+        
+        # Convert encoding to list for JSON serialization
+        embedding_list = face_encoding.tolist()
+        
+        return EnrollResponse(
+            success=True,
+            face_id=face_id,
+            face_embedding=embedding_list,
+            message="Face enrolled successfully. Store the embedding securely."
+        )
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(
+            status_code=500,
+            detail=f"Face enrollment failed: {str(e)}"
+        )
+
+
+@app.post("/verify", response_model=VerifyResponse)
+async def verify_face(request: VerifyRequest):
+    """
+    Verify a face against a stored embedding.
+    
+    Returns whether the faces match and the confidence score.
+    """
+    try:
+        # Validate stored embedding
+        if not request.stored_embedding or len(request.stored_embedding) != 128:
+            raise HTTPException(
+                status_code=400,
+                detail="Invalid stored embedding. Expected 128-dimensional vector."
+            )
+        
+        # Decode image
+        image = decode_base64_image(request.image_base64)
+        
+        # Extract face encoding from new image
+        face_encoding = extract_face_encoding(image)
+        
+        # Compare faces
+        is_match, confidence = compare_faces(request.stored_embedding, face_encoding)
+        
+        if is_match:
+            message = f"Face verified successfully (confidence: {confidence:.1%})"
+        else:
+            message = f"Face verification failed - faces do not match (confidence: {confidence:.1%})"
+        
+        return VerifyResponse(
+            success=True,
+            match=is_match,
+            confidence=confidence,
+            message=message
+        )
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(
+            status_code=500,
+            detail=f"Face verification failed: {str(e)}"
+        )
+
+
+@app.get("/")
+async def root():
+    """Root endpoint with API info."""
+    return {
+        "name": "Face Verification API",
+        "version": "1.0.0",
+        "endpoints": {
+            "/health": "Health check",
+            "/enroll": "Enroll a new face (POST)",
+            "/verify": "Verify a face against stored embedding (POST)"
+        }
+    }
+
+
+if __name__ == "__main__":
+    import uvicorn
+    port = int(os.getenv("PORT", "8000"))
+    uvicorn.run(app, host="0.0.0.0", port=port)

requirements.txt

@@ -0,0 +1,9 @@
+fastapi>=0.109.0
+uvicorn>=0.27.0
+# face_recognition>=1.3.0 (Installed manually with --no-deps to use dlib-bin)
+face_recognition_models>=0.3.0
+numpy>=1.24.0
+python-multipart>=0.0.6
+httpx>=0.26.0
+python-dotenv>=1.0.0
+pillow>=10.0.0

start-face-api.bat

@@ -0,0 +1,10 @@
+@echo off
+echo Starting Face API server...
+cd /d "%~dp0"
+if not exist "venv\Scripts\python.exe" (
+    echo Virtual environment not found. Please run set up first.
+    pause
+    exit /b
+)
+"venv\Scripts\python.exe" -m uvicorn main:app --reload --host 0.0.0.0 --port 8000
+pause