Skip to main content

MiniCPM brand logo above MiniCPM-OCR: fast, accurate document parsing into text, tables, and formulas, with a lightning arrow connecting documents to structured results; a decision model helps identify regions that need review (illustration).

MiniCPM-OCR 1.0 Guide Hugging Face ModelScope   MiniCPM-OCR Jev Guide Hugging Face ModelScope

Official Demo (CN / Global)  ·  Basic Demo (CN / Global)
Get Started  ·  Weights  ·  Free API  ·  Skill  ·  Local Deployment  |  中文
Join the Community  ·  Feishu / Lark  ·  Discord

MiniCPM-OCR is a family of models for efficient document parsing and text recognition. MiniCPM-OCR 1.0 parses Chinese and English documents and PDFs, balancing quality and efficiency across challenging inputs such as scans, photographs, curved pages, and recaptured documents. MiniCPM-OCR Jev evaluates OCR results at the region level, distinguishing problematic regions from reliable ones. It works with different parsing models to help users locate content that needs review.

MiniCPM-OCR 1.0

MiniCPM-OCR 1.0 (1.3B) is the first OCR-specific model in the MiniCPM-V/o family. It focuses on text-centric document understanding, covering text, tables, formulas, charts, seals, and structured information extraction. Its key features include:

  • 🏆 SOTA document parsing: MiniCPM-OCR 1.0 achieves a SOTA score of 93.68 on Real5-OmniDocBench, a benchmark for real-world document parsing, and demonstrates leading parsing capabilities on OmniDocBench v1.6, Wild-OmniDocBench, and olmOCR-Bench. It supports Chinese and English documents and PDFs, handling both standard documents and challenging capture conditions, including scans, curved pages, photographs, skewed pages, and recaptured documents.
  • ⚡ Efficient inference. With DSpark decoding acceleration (DSpark-BF16, DSpark-GGUF), MiniCPM-OCR 1.0 improves end-to-end processing efficiency by 55%. Its throughput is approximately 1.49× that of PaddleOCR-VL-1.6 and 3.62× that of MinerU2.5 Pro, reducing the time needed for large-scale document parsing.
  • 🔍 General recognition and information extraction: MiniCPM-OCR 1.0 achieves a SOTA score of 54.7 on OCRBench v2, demonstrating strong general OCR capabilities. It also supports key information extraction (KIE), extracting relevant document content for downstream information management and automated processing.
  • 🛠️ Easy deployment and development: MiniCPM-OCR 1.0 supports vLLM, SGLang, llama.cpp, and Ollama from day one, with multiple chip platforms and quantized versions available at release. It supports further fine-tuning and provides a pip SDK and a full-featured API for application integration and customization. You can also get started quickly with SKILL.md. Explore parsing results with the Official Demo (CN / Global) or Basic Demo (CN / Global).

SOTA Performance, Higher Throughput

Among the open-source OCR models shown below, MiniCPM-OCR 1.0 achieves 1.2 pages/s and the highest overall performance on OmniDocBench v1.6, Real5-OmniDocBench, Wild-OmniDocBench, and olmOCR-Bench.

Throughput and parsing quality of open-source OCR models. The horizontal axis shows throughput in pages per second on a logarithmic scale; the vertical axis shows the equally weighted average score across four document parsing benchmarks.

See the reproduction guide for test settings and reproduction details, and the model guide throughput evaluation for each model's throughput.

Benchmark Comparisons

Radar chart comparing MiniCPM-OCR 1.0 with other OCR models across six benchmarks; some values remain to be confirmed.

View complete MiniCPM-OCR 1.0 evaluation results

Detailed OCR model results on OmniDocBench v1.6, Real5, Wild, olmOCR-Bench, CHAOS-Bench, and OCRBench v2.

See the MiniCPM-OCR 1.0 guide for per-benchmark bar charts and throughput details.

Examples

Left to right: original document, detected layout, and rendered Markdown.

English Documents

English document animation: original, detected layout, and rendered Markdown.

More English Examples

Original documents and parsed results, side by side.

English examples comparing inputs and results: handwriting, historical and scanned documents, newspapers, financial statements, and key information extraction.

Chinese Documents

Chinese document animation: original, detected layout, and rendered Markdown.

More Chinese Examples

Original documents and parsed results, side by side.

Chinese examples comparing inputs and results: handwritten notes, complex formulas, newspapers, financial statements, stamped documents, illustrations, and key information extraction.

MiniCPM-OCR Jev

MiniCPM-OCR Jev is an OCR correctness decision model for text, formulas, and tables. Given an image and its corresponding OCR result, it returns a quality score from 0 to 1 to help select reliable results and locate content that needs review.

  • 🛡️ Strong performance in a small model: With only 2B parameters, MiniCPM-OCR Jev achieves an AUROC (×100) of 93.6 on JevOCRBench, outperforming JEV-35B-A3B (90.1) and approaching Qwen3.5-397B-A17B (93.8).
  • 🧩 Consistent generalization: Across parsing results from MiniCPM-OCR 1.0, GLM-OCR, PaddleOCR-VL-1.6, and Xiaomi-OCR-0, its AUROC (×100) ranges from 91.9 to 93.4.

Evaluation Results

The table below reports overall and per-category AUROC (×100) on JevOCRBench. Higher values indicate better discrimination between correct and incorrect parsing results.

Overall, text, formula, and table AUROC results on JevOCRBench, highlighting MiniCPM-OCR Jev.

Review-Free Accuracy

Accuracy at different review-free rates across three document types.

Accuracy versus review-free rate for legal documents, financial receipts, and complex documents.

Set the threshold only after checking it on a small batch from the real application.

Decision Examples

Jev scores for text, formula, and table recognition.

Original images, two OCR candidates, and their Jev scores for text, formulas, and tables.

See the MiniCPM-OCR Jev model guide for more on usage, technical specifications, evaluation results, and efficiency results.

Using MiniCPM-OCR

Choose how to integrate MiniCPM-OCR 1.0 and MiniCPM-OCR Jev:

Skill

Ask a coding agent to follow the MiniCPM-OCR 1.0 skill to set up the environment, download models, and parse your first document. Send the following instruction to the agent:

Read and execute https://github.com/OpenBMB/MiniCPM-OCR/blob/main/docs/SKILL_en.md

Ask a coding agent to follow the MiniCPM-OCR Jev skill to deploy, start, and verify the scoring service locally — either from the Docker image or with the SDK, using vLLM, SGLang, llama.cpp, or Ollama as the inference backend. Send the following instruction to the agent:

Read and execute https://github.com/OpenBMB/MiniCPM-OCR/blob/main/docs/SKILL_jev_en.md

If you have already cloned this repository, you can use ./docs/SKILL_en.md and ./docs/SKILL_jev_en.md directly.

Free API

Use the Free API to access MiniCPM-OCR 1.0 recognition and MiniCPM-OCR Jev quality scoring.

MiniCPM-OCR 1.0 API docs  ·  MiniCPM-OCR Jev API example

Local Deployment

Run the models on your own hardware: MiniCPM-OCR 1.0 parses PDFs and images into Markdown or JSON, while MiniCPM-OCR Jev scores the parsing results.

MiniCPM-OCR 1.0 deployment tutorial · MiniCPM-OCR Jev deployment tutorial

Fine-Tuning

Model Fine-tuning tutorial
MiniCPM-OCR 1.0 LLaMA-Factory · Swift
MiniCPM-OCR Jev Swift

Model Weights

Model Description Main Model Weights DSpark Heads
MiniCPM‑OCR 1.0 Efficient document parsing and text recognition for Chinese and English documents and PDFs, balancing quality and speed across scans, photographs, curved pages, and recaptured documents. 🤗  ModelScope BF16
🤗  ModelScope GGUF
🤗  ModelScope AWQ
🤗  ModelScope GPTQ
🤗  ModelScope BF16
🤗  ModelScope GGUF
MiniCPM‑OCR Jev An OCR correctness decision model for text, formulas, and tables. Given an image and its OCR result, it returns a quality score from 0 to 1. 🤗  ModelScope BF16 🤗  ModelScope GGUF
🤗  ModelScope AWQ 🤗  ModelScope GPTQ

Join the Community

Join the MiniCPM-OCR community to share experiences, give feedback, and hear about upcoming events. Click a link or scan a QR code to join.

China · Feishu / Lark Global · Discord
Scan to join the MiniCPM-OCR Feishu community
Join Feishu / Lark
Scan to join the MiniCPM-OCR Discord community
Join Discord

💡 FAQ and Troubleshooting

See the FAQ for common questions about installation, model downloads, GPU memory, input formats, and unexpected outputs.

Star History

GitHub star history for MiniCPM-OCR over time.

📄 License

The entire project is released under the Apache License 2.0, including code, documentation, and model weights for MiniCPM-OCR 1.0 and MiniCPM-OCR Jev.

Metadata

Release files for minicpm-ocr 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for minicpm-ocr 1.0.3
File Size Uploaded Provenance Actions
minicpm_ocr-1.0.3.tar.gz 91.7 kB With provenance Details for minicpm_ocr-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for minicpm-ocr 1.0.3
File Interpreter ABI Platform Actions
minicpm_ocr-1.0.3-py3-none-any.whl Python 3 none any Details for minicpm_ocr-1.0.3-py3-none-any.whl

Total release size: 199.9 kB

Release files / minicpm_ocr-1.0.3.tar.gz

Download URL minicpm_ocr-1.0.3.tar.gz
Size 91.7 kB
Tags Source
SHA-256 checksum
How to use checksums
4455f0a22cc8a296ede52ca65267901f14c20fbb508c06f7fc8c0e0d9f4a00cb
BLAKE2b-256 checksum
How to use checksums
2cfe08918ef7fffe58f28b8e7f0116baaeda8a4171b2126bf668530ed5eedde6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / minicpm_ocr-1.0.3-py3-none-any.whl

Download URL minicpm_ocr-1.0.3-py3-none-any.whl
Size 108.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f76c0ca6dd411f512a0f2b1f478443475fd46ba7cab2aeff2ba1f29b2641b189
BLAKE2b-256 checksum
How to use checksums
9bfc4f79f8895b8047272a3ee28c16034721611f61ed26922309e6371303d322
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for minicpm-ocr 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for minicpm_ocr-1.0.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page