A production-ready facial recognition microservice for RCians Attendease. This service provides robust endpoints for facial encoding extraction, validation, and comparison, extending the capabilities of the attendease-backend (Spring) service.

• Face Encoding Extraction - Extract 128-dimensional facial encodings from images
• Face Verification - Compare and authenticate facial encodings with configurable thresholds
• Multi-Image Registration - Register users with 5+ images for enhanced accuracy
• Health Monitoring - Built-in health checks and integrated test execution
• Security Scans - Automated dependency and code security scanning
• Test Coverage - Comprehensive test suite with 30+ unit tests
• Docker Ready - Containerized deployment support
• Interactive API Docs - Auto-generated Swagger and ReDoc documentation

• Python 3.10, 3.11, or 3.12 (3.13.6 recommended for development)
• CMake 3.16.0 or higher
• pip (Python package installer)

• Install CMake

git clone https://github.com/AttendeaseApp/facial-recognition-service.git
cd facial-recognition-service

Windows (PowerShell):

python -m venv .venv
.\.venv\Scripts\Activate.ps1

pip install -r dev-requirements.txt

uvicorn main:app --reload --port 8001

The application should be available at:

• API: http://127.0.0.1:8001
• Swagger Documentation: http://127.0.0.1:8001/docs
• ReDoc Documentation: http://127.0.0.1:8001/redoc

pytest tests/

# Execute tests through the API
curl http://127.0.0.1:8001/health/run-tests

# View cached results
curl http://127.0.0.1:8001/health/test-summary

facial-recognition-service/
├── .github/
│   └── workflows/           # CI/CD pipelines
├── src/
│   ├── api/
│   │   ├── facial_registration/
│   │   ├── facial_verification/
│   │   └── health_check/
│   ├── service/
│   │   └── image_processing/ # Services
│   └── data/                # Request/response models
├── tests/                   # Unit tests
│   └── test_image_processing_service.py
├── main.py                  # Application entry point
├── dev-requirements.txt     # Project dependencies
├── pyproject.toml          # Project configuration
├── Dockerfile
└── README.md

Jake Viado

• GitHub: @jakeeviado

for RCIANS ATTENDEASE