README.md

metadata

title: OCR Capacity Building as a Service
emoji: 🏥
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 6.20.0
python_version: 3.12.12
app_file: app.py
pinned: false
license: mit
hardware: zero-gpu
startup_duration_timeout: 30m
models:
  - ATH-MaaS/OvisOCR2
  - zai-org/GLM-OCR
preload_from_hub:
  - ATH-MaaS/OvisOCR2
  - zai-org/GLM-OCR
short_description: Open OCR API for DRC Ebola contact-tracing docs.

07/17 trigger rebuild

OCR Capacity Building as a Service

Open OCR API for Ebola contact-tracing documents in the DRC. Choose between ATH-MaaS/OvisOCR2 and zai-org/GLM-OCR, upload a page image or multi-page PDF, and stream Markdown (with LaTeX formulas and HTML tables).

OvisOCR2 emits figure placeholders that this Space materializes as cropped visual regions. GLM-OCR returns text recognition output without bbox crops.

Supported inputs

• Images: PNG, JPEG, WebP
• PDFs: up to 50 pages (rasterized locally; up to 4 pages per ZeroGPU lease)

API

Streaming endpoint: /run_ocr (also registered as MCP tool run_ocr).

On the live Space UI, open Use via API for copy-paste clients. Machine-readable docs:

• Gradio schema: /gradio_api/info
• OpenAPI: /docs · /openapi.json
• Health: /healthz

Arg	Type	Default	Description
image_path	FileData	required	Uploaded image or PDF
page_index	int	0	0-based start page for this lease
page_count	int	4	Max pages in this GPU batch
model_choice	str	"OvisOCR2"	"OvisOCR2" or "GLM-OCR"
prompt	str	""	Override; empty → model default

from gradio_client import Client, handle_file

client = Client("Tonic/ocr-ebola")
job = client.submit(
    handle_file("form.pdf"),
    0,
    4,
    "OvisOCR2",
    "",
    api_name="/run_ocr",
)
for chunk in job:
    print(chunk["event"], chunk.get("current_page"), chunk.get("char_count"))

Also available as an MCP tool named run_ocr. Health check: GET /healthz.

Local run

# Backend deps (Space installs requirements.txt automatically)
pip install -r requirements.txt

# Frontend (build once; commit dist/ for Spaces)
cd frontend && npm install && npm run build && cd ..

# Mock stream without loading weights (Windows PowerShell: $env:OCR_TEST_MODE=1)
OCR_TEST_MODE=1 python app.py

# Real models (needs CUDA)
python app.py

Open http://127.0.0.1:7860.