☁️
☁️
⭐
✨
⭐
✨
🚀 2026 Enterprise Edition • v2.1.0 • 74/74 Tests Passing

Next-Gen Biometric AI Platform!

Enterprise biometric identification powered by Multi-Layer Anti-Spoofing (EAR blink, 2D FFT moiré, 3D pose), Apple Face ID multi-angle wizard, FastAPI edge microservices, and RTSP IP streaming ✨

99.2%+ Accuracy & Liveness
60+ FPS YuNet + cKDTree
74 / 74 Unit Tests Passing
< 1 ms O(log N) Retrieval
face_recognition_live.py (v2.1.0)
😀
🟢 99.4% • Liveness PASS
Nilay Naha
ID: EMP_001
Anti-Spoof: PASS (EAR + FFT + 3D)
Pose: Yaw -1.2° | Pitch +2.1°
Engine: YuNet DNN (60 FPS)
💎

Enterprise Features

Comprehensive 2026 biometric AI architecture and security suite

Multi-Layer Anti-Spoofing

Dynamic EAR blink detection, 2D FFT screen moiré replay defense, and 3D solvePnP Euler angle head-pose verification with nose ray tracking.

Apple Face ID Guided Wizard

Interactive 36-segment circular HUD guiding Frontal, Left, Right, Up, and Down angles to build robust L2-normalized Fréchet centroid vectors.

O(log N) Spatial Retrieval

SciPy cKDTree Euclidean nearest-neighbor index delivering sub-millisecond recognition across 10,000+ faces at 60+ FPS via YuNet DNN.

FastAPI Edge Microservice

High-throughput asynchronous REST API and real-time WebSockets with interactive OpenAPI Swagger UI (/docs) and ReDoc (/redoc).

RTSP Stream & Motion Gating

Threaded IP camera stream with zero-latency buffer-drop and OpenCV MOG2 motion gating reducing idle CPU power consumption by over 90%.

AES-256 Fernet & Audit Logs

Encrypted biometric templates (.dat), path traversal sanitization, and tamper-evident SHA-256 chained cryptographic audit trails.

Offline TTS Voice Announcer

Integrated AudioAnnouncer speech engine providing natural voice greetings ("Access Granted, Welcome Nilay!") with zero cloud dependencies.

Executive HTML Analytics

Automated attendance tracking with Indian Standard Time (IST) logging, exportable to Apple-styled executive HTML dashboards and CSV.

Real-time Security Webhooks

Instant asynchronous HTTP dispatch for access-control IoT door relays, Slack alerts, and Discord channel security notifications.

74 / 74 Verified Tests

Complete pytest test suite with 100% passing automated verification across API, Face ID wizard, RTSP streaming, and encryption.

One-Click Batch Launchers

Instant execution scripts: run_gui.bat, run_api.bat, run_face_id_wizard.bat, and run_rtsp_stream.bat for plug-and-play operation.

Challenge-Response Mode

Interactive anti-spoofing challenge prompts (random blinks, directional head turns) defeating pre-recorded video injection attacks.

📸

Interactive Showcase

Explore the desktop app, enrollment wizard, REST API, and RTSP stream

Modern Apple-Inspired Dark GUI

Real-time video canvas with color-coded bounding boxes, live anti-spoofing feedback, and voice announcements.

Face Recognition System - GUI Interface

Screenshot: FRC SS.png

  • 60+ FPS real-time detection & recognition
  • Multi-layer anti-spoofing badge (EAR + FFT + 3D)
  • Offline TTS voice greetings ("Access Granted!")
  • Instant attendance export to CSV and HTML

Apple Face ID Multi-Angle Enrollment Wizard

Interactive 36-segment circular HUD with 5-pose angular calibration (Yaw ±25°, Pitch ±18°) and Frechet centroid vectors.

👤
POSES: 5 / 5 COMPLETE (100%)
Frontal ✓ | Left (-25°) ✓ | Right (+25°) ✓ | Up (+18°) ✓ | Down (-18°) ✓
  • 36-segment green circular progress HUD
  • Real-time 3D solvePnP head-pose angle feedback
  • Multi-angle L2-normalized Frechet centroid computation
  • Launch with run_face_id_wizard.bat

FastAPI Edge Microservice & WebSockets

Production-ready async REST API with interactive Swagger UI (/docs) and WebSocket video stream broadcasting.

POST /api/v1/recognize Recognize face with liveness analysis
POST /api/v1/enroll/composite 5-pose Apple Face ID composite enrollment
POST /api/v1/liveness Verify EAR blink, 2D FFT moiré & 3D pose
GET /api/v1/health System health, template counts & hardware status
WS /ws/stream Real-time WebSocket video frame & event stream
  • Interactive OpenAPI Swagger UI at /docs
  • Async ASGI server running on Uvicorn
  • High-throughput JSON endpoints for mobile & IoT
  • Launch with run_api.bat (Port 8000)

RTSP IP Camera Streaming & MOG2 Motion Gating

Threaded zero-latency buffer drop with OpenCV MOG2 background motion gating, slashing idle CPU by over 90%.

RTSP Stream Monitor — logs/rtsp_stream.log
[INFO] RTSP Stream initialized: rtsp://192.168.1.100:554/live
[INFO] cv2.CAP_PROP_BUFFERSIZE set to 1 (Zero-Latency Frame Buffer)
[POWER] MOG2 Motion Gating: NO MOTION detected (Idle power-saving mode active)
[EVENT] Motion threshold exceeded (Area: 1,420px) -> Awakening DNN recognition pipeline!
[WEBHOOK] Dispatching HTTP POST to https://company.internal/security/webhook
[SUCCESS] Webhook delivered: 200 OK (Latency: 14ms)
  • Automatic reconnection with exponential backoff
  • 90%+ idle compute reduction via MOG2 gating
  • Multi-endpoint HTTP webhook security dispatch
  • Launch with run_rtsp_stream.bat

One-Click Windows Launchers & CLI

Pre-configured batch scripts and commands for instant plug-and-play execution.

run_gui.bat Launches modern desktop dark GUI with real-time HUD
run_api.bat Starts FastAPI server on http://localhost:8000
run_face_id_wizard.bat Opens Apple Face ID 36-segment enrollment wizard
run_rtsp_stream.bat Launches IP camera stream with MOG2 motion gating
pytest — 74 Unit Tests Passing
$ pytest tests/ -v
============================== test session starts ==============================
collected 74 items

tests/test_api.py ..................                             [ 24%]
tests/test_composite_enrollment.py .........                    [ 36%]
tests/test_rtsp_webhooks.py ........                            [ 47%]
tests/test_face_recognition.py ................................ [ 90%]
tests/test_security_audit.py .......                            [100%]

========================= 74 passed in 2.08s =========================
  • 74 / 74 automated unit tests passing
  • Full CLI arguments (--api, --port, --host)
  • Offline execution with zero external telemetry
  • Plug-and-play batch launchers for Windows
⚙️

Get Started!

Choose your preferred launch or installation method

From GitHub

Clone the repository and run automated setup

git clone https://github.com/AmiNilay/face-recognition-system-version-control.git cd face-recognition-system-version-control ./INSTALL.bat
View Repository

Manual Install

Install full dependencies and run verification

pip install -r requirements.txt pytest tests/ -v
Read Word DOCX

System Requirements

OS: Windows 10/11, Linux, macOS
Python: 3.10 or higher
RAM: 4GB minimum (8GB recommended)
Video Input: USB Webcam or RTSP IP Camera
📚

Documentation

Guides, API specifications, and technical reference

Quick Start Guide

Get up and running with one-click scripts

→

FastAPI Spec & Docs

Interactive Swagger & REST endpoints

→

Technical DOCX

Complete 2026 enterprise architecture

→

Configuration

Liveness, RTSP, and recognition tuning

→

74 Unit Tests

Automated test suite & verification

→

FAQ & Support

Troubleshooting and community help

→
💬

Get In Touch!

Have questions or enterprise feature requests? We'd love to hear from you

GitHub

@AmiNilay

Repository

View Project

Report Issues

Issue Tracker

Support

Star on GitHub