README.md

---
title: Yimlo OCR Verification
emoji: 🛡️
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---

# Yimlo OCR Verification Microservice

This is the official OCR backend for [yimlo.africa](https://yimlo.africa). It provides identity validation, proof of residence analysis, and bank/credit document verification.

## Architecture
- **Framework**: FastAPI
- **OCR Engine**: EasyOCR
- **Hosting**: Docker on HuggingFace Spaces
- **Integration**: SearchWorks 360 API

## Required Secrets
To run this service in production, the following secrets must be configured in your HuggingFace Space settings:
- `SW360_SESSION_TOKEN`: Your SearchWorks API key.

## Local Development
```bash
docker build -t yimlo-ocr .
docker run -p 7860:7860 -e SW360_SESSION_TOKEN=your_token yimlo-ocr
```