Skip to main content

Biometric Face Recognition for Healthcare

Stateless, high-performance face recognition API designed for hospital IT systems. Identify unresponsive patients in real-time with sub-100ms inference.

Get StartedAPI Reference
POST /compare
Response
✓ Match: 94.7% probability

Quick Start

Get up and running with Iris in minutes

1

Install dependencies

Install Rust and OpenCV on your system
brew install opencv
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2

Clone and setup

Clone the repository and download AI models
git clone https://github.com/crane04/iris.git
cd iris
chmod +x setup.sh
./setup.sh
The setup script downloads YuNet (face detection) and SFace (face recognition) ONNX models from OpenCV Zoo.
3

Start the server

Launch Iris on port 8080
cargo run --release
The API will be available at http://localhost:8080
4

Make your first request

Compare a target face against a database of people
curl -X POST http://localhost:8080/compare \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://example.com/patient-photo.jpg",
    "people": [
      {
        "name": "John Doe",
        "image_url": "https://example.com/john-database.jpg"
      }
    ]
  }'

{
  "matches": [
    {
      "name": "John Doe",
      "probability": 94.7
    }
  ]
}

Key Features

Built for healthcare infrastructure with privacy and performance in mind

Zero Persistence

Images processed in RAM and destroyed immediately. No biometric data touches the disk.

Sub-100ms Inference

Powered by Rust and ONNX-accelerated YuNet and SFace models for real-time identification.

Built-in Rate Limiting

5 requests per second per IP with burst support to prevent abuse.

CORS-Enabled API

Pre-configured for secure communication with authorized hospital frontends.

Flexible Image Input

Accepts both URL and Base64-encoded images for maximum integration flexibility.

Request Monitoring

Real-time statistics and health monitoring endpoints for operational visibility.

Explore the Documentation

Dive deeper into Iris capabilities

🏗️

Architecture Overview

Understand how Iris processes faces with stateless design and ONNX models

Learn more
🔒

Privacy & Security

Discover how Iris protects patient data with zero persistence and secure processing

Learn more
⚡

API Reference

Complete documentation for the /compare, /stats, and /health endpoints

View API docs
🐳

Docker Deployment

Deploy Iris in containers for production hospital environments

Deploy now

Ready to integrate Iris?

Start building biometric identification into your hospital IT systems in minutes with our comprehensive API and deployment guides.

Get StartedView on GitHub