churro-ocr 0.2.0

Library-first OCR and layout detection for historical documents

churro-ocr

churro-ocr is a Python toolkit for OCR and page detection on historical documents.

Full documentation and project overview live at https://stanford-oval.github.io/Churro/.

Install

Install only the pieces you need:

pip install churro-ocr
pip install "churro-ocr[llm]"
pip install "churro-ocr[local]"
pip install "churro-ocr[hf]"
pip install "churro-ocr[vllm]"
pip install "churro-ocr[azure]"
pip install "churro-ocr[mistral]"
pip install "churro-ocr[pdf]"
pip install "churro-ocr[all]"

Which API Should You Use?

Goal	API
OCR one page or one image	OCRClient
Detect page crops only	DocumentPageDetector
Run an end-to-end image or PDF OCR workflow	DocumentOCRPipeline
Tune backend/provider options directly	build_ocr_backend(...) + OCRBackendSpec

Quick Start

from churro_ocr.ocr import OCRClient
from churro_ocr.providers import OCRBackendSpec, build_ocr_backend

backend = build_ocr_backend(
    OCRBackendSpec(
        provider="litellm",
        model="vertex_ai/gemini-2.5-flash",
    )
)

page = OCRClient(backend).ocr_image(image_path="scan.png")

print(page.text)

More

• Overview: https://stanford-oval.github.io/Churro/
• Getting started: https://stanford-oval.github.io/Churro/getting-started.html
• Benchmark leaderboard: https://stanford-oval.github.io/Churro/leaderboard.html
• Provider setup: https://stanford-oval.github.io/Churro/guides/providers.html
• CLI docs: https://stanford-oval.github.io/Churro/cli.html
• API reference: https://stanford-oval.github.io/Churro/api/index.html