Files
ModelForge/docs/architecture/OCR_MODEL_SELECTION.md
T

44 lines
2.4 KiB
Markdown

# OCR model selection
M11 used the ModelForge Hugging Face provider for a bounded TrOCR shortlist; no web scraping or
mass-download was used.
| Candidate | Exact revision | Outcome |
| --- | --- | --- |
| `microsoft/trocr-small-handwritten` | `b4648cfa171985a6745f37ddd637e98c0da958ac` | task mismatch; not selected |
| `microsoft/trocr-base-printed` | `93450be3f1ed40a930690d951ef3932687cc1892` | deep preflight; blocked |
| `microsoft/trocr-large-printed` | `9ff792d8e7c22061f2ee67e1ed2246b1f9ef1e98` | larger duplicate direction; not downloaded |
| `microsoft/trocr-base-handwritten` | `eaacaf452b06415df8f10bb6fad3a4c11e609406` | task mismatch despite clearer license metadata |
The selected base-printed revision exposed a safe eight-file Safetensors plan of 1,334,746,034 bytes;
the parallel 1,333,508,485-byte PyTorch pickle weight was correctly excluded. Execution nevertheless
stopped before download: upstream scanning was incomplete and license metadata was absent/unknown.
The immutable discovery assessment is `license_blocked`. No security gate was weakened to manufacture
quality evidence.
The existing `microsoft/trocr-small-printed` candidate remains quality-blocked at CER 0.721246 and WER
0.976190. PaddleOCR-VL remains blocked because its exact revision requires custom code;
`trust_remote_code=false` remains mandatory. Final state is therefore:
```text
document.ocr@1: PLATFORM_READY / NO_PRODUCTION_MODEL
```
## Closure refresh — 2026-08-26
The official Hugging Face API was queried again for the bounded shortlist. The exact revisions did
not change:
- `microsoft/trocr-small-handwritten@b4648cfa171985a6745f37ddd637e98c0da958ac` still has no
declared license and exposes one pickle weight with no Safetensors weight;
- `microsoft/trocr-base-printed@93450be3f1ed40a930690d951ef3932687cc1892` still has no
declared license and exposes both Safetensors and pickle weights, with no affirmative repository
security status returned;
- `microsoft/trocr-large-printed@9ff792d8e7c22061f2ee67e1ed2246b1f9ef1e98` still has no
declared license and exposes both weight formats;
- `microsoft/trocr-base-handwritten@eaacaf452b06415df8f10bb6fad3a4c11e609406` still declares
MIT and exposes both weight formats, but remains a task mismatch.
This refresh does not satisfy the license/scanner gate for the printed candidate. No candidate was
downloaded or executed, and the final state remains `PLATFORM_READY / NO_PRODUCTION_MODEL`.