Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
2ba4c31
feat(ocr): add olmocr profiles and plain-text parsing
s-jse Apr 5, 2026
d89bfb8
build(repo): slim runtime extras and pin ruff
s-jse Apr 5, 2026
cb4a520
feat(runtime): add uv-managed runtime installers
s-jse Apr 5, 2026
b3d267b
refactor(providers)!: remove in-process vllm backend
s-jse Apr 5, 2026
63e3ca0
docs(repo): consolidate install and provider guidance
s-jse Apr 5, 2026
7cfcc1e
fix(docs): move badges to the top of the README file
s-jse Apr 5, 2026
aa2ba0e
refactor(runtime)!: remove managed vllm runtime support
s-jse Apr 6, 2026
be5249c
build(hf): support transformers 5.x
s-jse Apr 6, 2026
6dafe58
feat(ocr): add chandra-ocr-2 support
s-jse Apr 6, 2026
98a3684
fix(evaluation): initialize metrics in worker processes
s-jse Apr 6, 2026
71d0509
feat(hf): add Liquid LFM2.5-VL OCR backend
s-jse Apr 6, 2026
aaac23a
fix(mistral): require pinned OCR models and retry transient failures
s-jse Apr 6, 2026
29b8d06
feat(benchmark): retain OCR metadata in benchmark outputs
s-jse Apr 6, 2026
36d0c7e
fix(providers): retry transient provider API errors
s-jse Apr 6, 2026
a0377ac
style(providers): format specs module
s-jse Apr 6, 2026
9aecd0f
chore(benchmarks): refresh benchmark results
s-jse Apr 6, 2026
3b5101f
docs(benchmarking): update benchmarking instructions and clarify outp…
s-jse Apr 6, 2026
9dc80f7
docs: add logos to the benchmark table
s-jse Apr 6, 2026
b989362
fix(ocr): allow empty model responses
s-jse Apr 7, 2026
a56e1bc
fix(ocr): harden dots.ocr generation handling
s-jse Apr 7, 2026
a58e244
feat(ocr): add PaddleOCR-VL 1.5 presets
s-jse Apr 7, 2026
f837911
test(hf): cover dots and Paddle OCR backends
s-jse Apr 7, 2026
89f6ae1
chore(benchmarking): tune benchmark runs and refresh scores
s-jse Apr 7, 2026
eb1fd19
feat(providers): add dots.mocr OCR support
s-jse Apr 7, 2026
03682e8
chore(benchmark): add dots.mocr test results
s-jse Apr 7, 2026
cdf37de
feat(providers): add DeepSeek OCR 2 support
s-jse Apr 7, 2026
d4cf2a5
chore(benchmark): add DeepSeek OCR 2 leaderboard result
s-jse Apr 7, 2026
4086aaa
feat(providers): add Gemini 3.1 Pro Preview model to benchmark results
s-jse Apr 7, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
# <img src="static/churro.png" alt="CHURRO logo" width="40" /> CHURRO

CHURRO is an OCR toolkit for historical document transcription, built to make handwritten and printed sources readable at high accuracy and lower cost.

It works with all major OCR proividers and vision-language models, and provides first-party support for the CHURRO 3B model and CHURRO-DS dataset.

[![Model](https://img.shields.io/badge/Model-CHURRO%203B-8A4FFF)](https://huggingface.co/stanford-oval/churro-3B)
[![Dataset](https://img.shields.io/badge/Dataset-CHURRO--DS-0A7BBB)](https://huggingface.co/datasets/stanford-oval/churro-dataset)
[![Paper](https://img.shields.io/badge/Paper-arXiv-B31B1B)](https://arxiv.org/abs/2509.19768)
[![Docs](https://img.shields.io/badge/Docs-Documentation-8B451F)](https://stanford-oval.github.io/Churro/)
[![Leaderboard](https://img.shields.io/badge/Leaderboard-Benchmark%20Snapshot-6B7280)](https://stanford-oval.github.io/Churro/leaderboard.html)
[![GitHub Stars](https://img.shields.io/github/stars/stanford-oval/churro?style=social)](https://github.com/stanford-oval/churro/stargazers)

CHURRO is an OCR toolkit for historical document transcription, built to make handwritten and printed sources readable at high accuracy and lower cost.

It works with all major OCR providers and vision-language models, and provides first-party support for the CHURRO 3B model and CHURRO-DS dataset.


- CHURRO 3B exceeds the accuracy of Gemini 2.5 Pro at 15.5x lower cost.
- CHURRO-DS contains ~100K pages from 155 historical collections spanning 22 centuries and 46 language clusters.
Expand All @@ -24,7 +24,8 @@ It works with all major OCR proividers and vision-language models, and provides
## Quick Try

```bash
pip install "churro-ocr[hf]"
uv tool install churro-ocr
churro-ocr install hf
churro-ocr transcribe --image scan.png --backend hf --model stanford-oval/churro-3B
```

Expand Down
Loading