Text / WORKFLOW

Extract text from documents locally with MiniCPM-OCR 1.0

Run OpenBMB’s 1.3B MiniCPM-OCR 1.0 with Ollama on Windows, Mac or Linux, extract a document page image to a text file, and check it against the original.

Verified sourceSource checked 11/9/2026
LOCAL
Freshness 93 out of 100. Release age: 18 days old, Oct 27, 2026. Measures age, not quality.
Popularity 70 out of 100. 143,265 downloads in 30 days; 457 lifetime likes. Checked Nov 13, 2026. Measures adoption, not quality.
What do these scores mean?

Two ways to compare models. Neither score measures answer quality, benchmark performance, or whether a model fits your machine.

Freshness · release age

A new release starts at 100. The score halves every 180 days: 100 × 2^(−age in days / 180). When the release date is unavailable, a repository date is a fallback—not proof of when the model was released. Missing dates stay unscored.

Check the date source
Popularity · adoption

Downloads over the past 30 days carry 80% of the score; lifetime likes carry 20%. Both use a logarithmic scale, capped at 10 million downloads and 100,000 likes. If likes are unavailable, downloads carry all the weight. Missing download statistics stay unscored.

round(80 × min(1, log10(1 + downloads) / 7) + 20 × min(1, log10(1 + likes) / 5))

Check the statistics source
Scores as of Nov 14, 2026. Statistics checked Nov 13, 2026. Statistics are marked for refresh after 72 hours.Full scoring method

Before you begin

Hardware

Estimates for one page image at the default context. Not measured by YouRunAI; OpenBMB reports about 1.2 pages per second on an RTX 5090 with its accelerated vLLM pipeline, not this Ollama route.

MachineMiniCPM-OCR 1.0 · Q4_K_MMiniCPM-OCR 1.0 · Q8_0MiniCPM-OCR 1.0 · F16
NVIDIA · 6 GB VRAMFits on the GPUFits on the GPUFits on the GPU
AMD Radeon · 8 GB VRAMUses Ollama’s supported ROCm/Vulkan driver; CPU fallback otherwiseSame driver requirementSame driver requirement
Intel Arc · 8 GB VRAMRuns on CPU unless Ollama’s Vulkan backend detects the GPU; still practicalSame; still practicalSame; slower on CPU
Apple Silicon · 8 GB unified memoryComfortableComfortableWorks; close other apps
CPU only · 8 GB RAMPractical for single pagesPractical, slightly slowerSlower; prefer Q4_K_M
PRIVATE OCR · OLLAMASOURCE-LINKED SETUP

Extract text from documents locally with MiniCPM-OCR 1.0

Install Ollama, pull OpenBMB’s official package and turn a page image into a text file on your own computer. Then check it line by line against the page.

Choose a package Run its commands Check the result
01
BEFORE YOU BEGIN

Choose your package

Select the weights you want. The instructions, downloads and settings change with your choice.

The publisher has not provided a complete memory target for this task. Check its hardware guidance before starting.

CURRENT SETUP

MiniCPM-OCR 1.0 · Q4_K_M · official

Start at 16,384 tokens of context, Ollama’s default for this package, for one page. The 1.4 GB package needs a little more memory than its size; very large page images use more context, so reduce the image to about 2,000 pixels on the long side if memory is short.

Freshness 93 out of 100. Release age: 18 days old, Oct 27, 2026. Measures age, not quality.
Popularity 70 out of 100. 143,265 downloads in 30 days; 457 lifetime likes. Checked Nov 13, 2026. Measures adoption, not quality.
What do these scores mean?

Two ways to compare models. Neither score measures answer quality, benchmark performance, or whether a model fits your machine.

Freshness · release age

A new release starts at 100. The score halves every 180 days: 100 × 2^(−age in days / 180). When the release date is unavailable, a repository date is a fallback—not proof of when the model was released. Missing dates stay unscored.

Check the date source
Popularity · adoption

Downloads over the past 30 days carry 80% of the score; lifetime likes carry 20%. Both use a logarithmic scale, capped at 10 million downloads and 100,000 likes. If likes are unavailable, downloads carry all the weight. Missing download statistics stay unscored.

round(80 × min(1, log10(1 + downloads) / 7) + 20 × min(1, log10(1 + likes) / 5))

Check the statistics source
Scores as of Nov 14, 2026. Statistics checked Nov 13, 2026. Statistics are marked for refresh after 72 hours.Full scoring method
View weight source
02
THE WORKFLOW

Set up MiniCPM-OCR 1.0 · Q4_K_M on your machine

Choose where you want to run it. The instructions below update to match your selection.

CHOOSE YOUR SETUPWindows
01

Install Ollama for Windows

Download and install the current Ollama release, then make sure it is running. On Linux the official one-line installer sets it up as a service. Use the latest version: older releases may not recognise this new model architecture.

Download Ollama
02

Download the Q4_K_M OCR package

In PowerShell, pull OpenBMB’s official Q4_K_M package (1.4 GB, vision projector included). Ollama stores it for you, so there is no model folder to manage.

OpenBMB Ollama package and tags
PowerShell
ollama pull openbmb/minicpm-ocr1.0:q4_k_m
03

Put a document page in a test folder

Create a folder named ocr-test in your home folder and save a clear image of one document page in it as page.png: a scan, a phone photo of a printed page, or a PDF page exported as PNG. MiniCPM-OCR is trained for English and Chinese documents, including tables and formulas.

04

Extract the text into a file

In PowerShell, run the command below. It uses OpenBMB’s documented “Text Recognition:” prompt and saves the model’s output to page.md next to the image. A one-page document usually finishes in seconds once the model is loaded.

OpenBMB quick start
PowerShell
Set-Location "$HOME\ocr-test"
ollama run openbmb/minicpm-ocr1.0:q4_k_m "Text Recognition: ./page.png" | Out-File -Encoding utf8 page.md
05

Check the output against the page

Open page.md beside page.png and compare a few lines, numbers and any table cells. Plain text comes back as text; OpenBMB documents formulas as LaTeX. Correct anything the model misread before relying on it. Run the same command with another image to process the next page.

03
SUCCESS CHECK · MiniCPM-OCR 1.0 · Q4_K_M

A text file you checked against the page

page.md holds the recognised text from page.png, and spot checks of lines, numbers and table cells match the original page.

This guide covers one page image at a time through Ollama. For whole PDFs with layout, tables and reading order, use the companion guide Convert PDFs to Markdown locally with MiniCPM-OCR 1.0. Commands checked November 9, 2026; not run by YouRunAI.

Back to setup steps

When it doesn’t go to plan

Ollama says the model architecture is unknown.

Update Ollama to the latest release and pull the package again.

The output is empty or describes the image instead of transcribing it.

Keep the exact “Text Recognition:” prefix and the ./page.png path, and run the command from inside the ocr-test folder.

Accented or non-Latin characters look garbled on Windows.

Keep the Out-File -Encoding utf8 part of the command and open page.md in VS Code or Notepad, not the console.

REFERENCE LIBRARY

Sources and files

Original instructions, model files, and compatibility notes behind this setup.

3 SOURCES

The model behind this workflow

MiniCPM-OCR 1.0

Keep exploring

Text
SETUP GUIDE

Qwen3.5 · 9B private chat setup

Source-backed package and platform-route plan for private local chat with Qwen3.5 · 9B. Preserves the official Ollama 9B package, a smaller 4B family fallback, and a clearly labeled community uncensored GGUF option.

Freshness 37 out of 100. Release age: 260 days old, Feb 27, 2026. Measures age, not quality.
Popularity 91 out of 100. 6,201,482 downloads in 30 days; 2,357 lifetime likes. Checked Nov 13, 2026. Measures adoption, not quality.
SOFTWAREOllama
Coding
SETUP GUIDE

Build a private coding assistant with Qwen3.8 27B

Run Qwen3.8 27B with Ollama, connect it to Cline in VS Code, and make one reviewable code change in a tiny local project.

Freshness 68 out of 100. Repository age: 101 days old, Aug 5, 2026. Measures age, not quality.
Popularity 95 out of 100. 6,960,395 downloads in 30 days; 19,805 lifetime likes. Checked Nov 13, 2026. Measures adoption, not quality.
Arena Open Source Web coding: rank 13 of 63. Ranked model: Qwen3.8-27B. Original model ranking, not a benchmark of this package. Export dated Nov 11, 2026. Source checked Nov 13, 2026. Human preference ranking, not hardware suitability.+3
SOFTWAREOllama + Visual Studio Code + Cline + Python
Images
SETUP GUIDE

Create images locally with FLUX.2 Klein

Generate images from text prompts in ComfyUI with the fast distilled or more adjustable base 4B model. Save your results and reuse the visual workflow.

Freshness 31 out of 100. Release age: 303 days old, Jan 15, 2026. Measures age, not quality.
Popularity 77 out of 100. 438,415 downloads in 30 days; 1,117 lifetime likes. Checked Nov 13, 2026. Measures adoption, not quality.
SOFTWAREComfyUI