★ Reading this for free? Get 20 structured AI courses + per-chapter AI tutor — the first chapter of every course free, no card.Start free in 30 seconds

OpenBMB · Vision-Language · Open Weights

MiniCPM-V: Phone-Class Vision AI for 6-8GB VRAM (and Why the Default Tag Is a Trap)

If you have 8GB+ VRAM, run ollama run minicpm-v4.5 (8.7B params, 6.1GB download, 40K context). On 6GB or less — or CPU-only — run minicpm-v4.6 (1B-class, 1.6GB, 256K context). Do not pull the plain minicpm-v tag: its 5.4M downloads point at the two-year-old v2.6. That tag trap is the single most useful thing to know about this family, so we start there — then the VRAM arithmetic, setup commands, and the honest version of the benchmark story.

📅 Published: August 30, 2026🔄 Last Updated: August 30, 2026✓ Manually Reviewed

Quick answer: which tag, what VRAM

MiniCPM-V 4.5 is the pick for 8GB+ cards — OpenBMB's model card reports a 77.0 OpenCompass average, which it says beats GPT-4o-latest, Gemini-2.0 Pro, and Qwen2.5-VL 72B. MiniCPM-V 4.6 is the pick for everything smaller — a 1.6GB download that OpenBMB ships on iPhones, Android, and HarmonyOS devices with open-sourced edge code.

Your hardwarePull thisDownloadContext
8GB+ VRAM GPU / 16GB Macminicpm-v4.56.1GB40K
4-6GB VRAM / iGPU / mini PCminicpm-v4.61.6GB256K
CPU-only laptopminicpm-v4.61.6GB256K
Legacy tutorials onlyminicpm-v (v2.6, 2024)5.5GB (q4_0)32K

Download sizes and context windows: Ollama library tag pages, August 2026.

ollama run minicpm-v4.5

Not sure what fits your card? See the best Ollama models for 8GB VRAM or the full Ollama RAM/VRAM table.

Key takeaways

  • The 5.4M-pull minicpm-v tag is frozen at v2.6 (2024). The current models live under minicpm-v4.5 and minicpm-v4.6.
  • v4.5 (8.7B) is the quality pick — 77.0 OpenCompass average per OpenBMB, claimed above Qwen2.5-VL 72B.
  • v4.6 (1B-class) is genuinely phone-sized — 1.6GB download, 256K context, ships on iOS/Android/HarmonyOS.
  • OCR and document extraction are the killer apps — receipts, invoices and screenshots into structured JSON, with nothing leaving the machine.
  • Apache-2.0 weights on v4.5/v4.6 per the official model cards — free commercial use.

The version trap: minicpm-v is not the latest MiniCPM-V

The Ollama model called minicpm-v — 5.4M pulls, one of the most-downloaded vision models in the entire library — was last updated over a year ago and serves MiniCPM-V 2.6, released in 2024. OpenBMB never updated that listing. When 4.5 and 4.6 arrived, they were published as separate models: minicpm-v4.5 (22.6K pulls as of August 2026) and minicpm-v4.6 (added to the official Ollama library around June 2026; 29.3K pulls and already ahead of 4.5).

The practical consequence: almost everyone who typed ollama run minicpm-v this year got a model two generations behind — 65.2 on OpenCompass versus 77.0 for v4.5, per OpenBMB's own numbers. That is not a subtle difference. v2.6 was pitched against GPT-4o mini and Claude 3.5 Sonnet; v4.5 is pitched against GPT-4o-latest and Qwen2.5-VL 72B.

This page uses the versionless URL deliberately: OpenBMB ships roughly two versions a year, and the advice here is organized so the matrix below stays useful when v5 lands. The project itself is one of the larger open-vision efforts around — about 26K GitHub stars on OpenBMB/MiniCPM-V as of August 2026.

Version matrix

Three versions matter in August 2026: v2.6 (legacy default), v4.5 (quality pick), v4.6 (efficiency pick). Everything below is from OpenBMB's model cards and the Ollama library listings.

VersionOllama nameParams / baseReleasedContextPulls
v4.5minicpm-v4.58.7B — SigLIP2-400M + Qwen3-8BAug 202540K22.6K
v4.6minicpm-v4.61B-class — SigLIP2-400M + Qwen3.5-0.8BMay 2026256K29.3K
v2.6 (legacy)minicpm-v8B — SigLIP-400M + Qwen2-7B202432K5.4M

Sources: OpenBMB model cards and changelog; Ollama library, August 2026.

The interesting design choice in 4.6: instead of scaling up, OpenBMB scaled down — a 1B-class model with mixed 4x/16x visual-token compression that they say cuts visual-encoding FLOPs by more than half and delivers ~1.5x the token throughput of its own Qwen3.5-0.8B base. It is a different tool than 4.5, not a replacement: think "good-enough vision everywhere" versus "best vision an 8GB card can hold." OpenBMB also maintains a MiniCPM-o omni sibling that adds speech in and out; it is not in the Ollama library.

VRAM requirements

Plan for 8GB of VRAM to run the 8B versions comfortably. On 6GB, drop to a smaller quant or accept partial CPU offload. v4.6 fits nearly anywhere. The sizing rule: start from the download size and add roughly 1-1.5GB for the vision projector and the KV cache. minicpm-v4.5 ships as a 6.1GB download, so budget about 7-7.5GB resident at a normal context length — which is why an 8GB card is the comfortable floor and a 6GB card is not. Check the real number for your own setup with ollama ps, which prints resident size and whether the model landed 100% on GPU.

Ollama's minicpm-v4.5 ships two tags (latest and 8b, both 6.1GB) — no quant ladder. If you want to pick your own quant, OpenBMB publishes the full GGUF set on Hugging Face (openbmb/MiniCPM-V-4_5-gguf); file sizes below are from that repo:

MiniCPM-V 4.5 quantFile sizeRealistic home
Q4_04.77 GB6GB card (tight) / 8GB
Q4_K_M (recommended)5.03 GB8GB card (RTX 3060 Ti / 4060)
Q5_K_M5.85 GB8GB card
Q6_K6.72 GB8GB (tight) / 12GB
Q8_08.71 GB12GB card (RTX 3060 12GB / 4070)
F1616.4 GB24GB card / 18GB+ Mac

File sizes: openbmb/MiniCPM-V-4_5-gguf on Hugging Face. Card recommendations are our guidance.

If you are right on the 6GB line — a GTX 1660, RTX 2060, or laptop 3060 — the 8B models nearly fill the card at Q4. Take v4.6 instead and keep headroom, or check what else runs well on 6GB VRAM. On Apple Silicon, unified memory makes this easier: a 16GB M-series Mac has room for v4.5 at ~7GB resident alongside the OS, and 18GB or more leaves space to keep a text model loaded at the same time.

Ollama setup

One gotcha first: 4.5 and 4.6 require a current Ollama build. An older runtime will pull the classic minicpm-v without complaint and then refuse minicpm-v4.6 outright, telling you to download the latest version. The newer SigLIP2/Qwen3-era architectures need runtime support older binaries do not have, so the registry declines rather than handing over a file the runner cannot open. Update first, then it is two commands — Ollama handles the vision projector automatically, no separate CLIP download:

# Quality pick (8GB+ VRAM):
ollama run minicpm-v4.5 "What's in this image? ./invoice.png"

# Efficiency pick (anything, even CPU):
ollama run minicpm-v4.6 "Transcribe the text in ./receipt.jpg"

Want a specific quant? The Ollama listing only carries the default, but you can run OpenBMB's GGUF builds straight from Hugging Face using Ollama's standard hf.co/ syntax:

ollama run hf.co/openbmb/MiniCPM-V-4_5-gguf:Q4_K_M

Via the API (for scripts and apps)

curl http://localhost:11434/api/chat -d '{
  "model": "minicpm-v4.5",
  "messages": [{
    "role": "user",
    "content": "Extract every line item and total from this receipt as JSON.",
    "images": ["<base64-encoded image>"]
  }]
}'

Real uses for this class of model: receipt and invoice extraction, screenshot-to-text for documentation, alt-text generation, photo-library sorting — the jobs covered in our local AI vision tasks guide. A model this light also suits always-on camera analysis; see the Frigate + Ollama AI cameras setup.

How fast will it be on your hardware?

You can bound this arithmetically without running anything. Token generation is memory-bandwidth bound — the machine reads roughly the whole model once per token — so the ceiling is your memory bandwidth divided by the model size. We have not benchmarked this model, so what follows is calculation rather than measurement, and it is an upper bound: attention, the vision encoder pass and framework overhead all take a cut, and real output lands well below the ceiling.

throughput ceiling (tok/s) = memory bandwidth (GB/s) / model size (GB)

minicpm-v4.5 = 6.1 GB   ·   minicpm-v4.6 = 1.6 GB
HardwareBandwidth (vendor spec)v4.5 ceilingv4.6 ceiling
RTX 3060 12GB360 GB/s≤ 59 tok/s≤ 225 tok/s
RTX 4060 Ti 16GB288 GB/s≤ 47 tok/s≤ 180 tok/s
RTX 3090 24GB936 GB/s≤ 153 tok/s≤ 585 tok/s
Apple M3 Pro150 GB/s≤ 24 tok/s≤ 93 tok/s
Apple M4 Pro273 GB/s≤ 44 tok/s≤ 170 tok/s
CPU only, DDR5-5600 dual channel~89 GB/s≤ 14 tok/s≤ 55 tok/s

Bandwidth figures from NVIDIA and Apple specification pages; model sizes from the Ollama library. Ceilings are division, not benchmarks. The v4.6 column in particular is optimistic — at 1.6GB the model stops being bandwidth-bound and becomes overhead-bound, so treat those figures as "fast enough that the number stops mattering".

For the number that actually applies to you, run it and read the eval rate:

ollama run minicpm-v4.5 --verbose "Describe this image: ./receipt.jpg"
ollama ps   # resident size, and whether it is 100% GPU

The practical shape of it: on any modern discrete GPU an 8B-class vision model reads a document image and emits structured JSON in single-digit seconds, and the interesting constraint is accuracy on fine print rather than speed. That is the honest pitch for this family — local document extraction at zero API cost, with nothing leaving the machine.

Benchmarks

v4.5's headline number is a 77.0 OpenCompass average across 8 benchmarks — which OpenBMB says beats GPT-4o-latest, Gemini-2.0 Pro, and Qwen2.5-VL 72B — from a model that fits on an 8GB card. These are the vendor's published figures, so read them the way you read any model card: directionally real, best-case framing. We have not reproduced them independently.

ClaimNumberSource
v4.5 OpenCompass average (8 benchmarks)77.0MiniCPM-V-4_5 model card
v4.5 Video-MME73.5MiniCPM-V-4_5 model card
v4.5 video token compression96x (6 frames → 64 tokens), up to 10FPSMiniCPM-V-4_5 model card
v4.6 vs its own Qwen3.5-0.8B base~1.5x token throughput; AA Intelligence Index 13 vs 10MiniCPM-V-4_6 model card
v4.6 quality class"Qwen3.5-2B level" on OpenCompass, OCRBench, HallusionBenchMiniCPM-V-4_6 model card
v2.6 OpenCompass average (legacy)65.2Ollama library description

Two claims worth pausing on. First, "beats Qwen2.5-VL 72B" is an aggregate-average claim — a 72B model will still win plenty of individual hard cases, especially dense charts and long documents. Second, the video numbers come from OpenBMB's own inference stack with the 96x compression pipeline, which you cannot reproduce through Ollama (see limitations). Even discounting both, the 11.8-point OpenCompass jump over v2.6 (65.2 → 77.0) is the gap that matters: v2.6 is what most of those 5.4M pulls actually installed, and v4.5 is a straight upgrade at the same VRAM cost.

MiniCPM-V vs Qwen3-VL

Pick MiniCPM-V 4.5 for the best single-model result on one 8GB card; pick Qwen3-VL when you want a family that scales with your hardware. This is the comparison most people are actually making in 2026, and it is closer than the pull counts suggest — the two overlap more than the branding implies, since MiniCPM-V literally uses Qwen LLMs as its language backbone.

  • Capability ceiling: Qwen's larger vision variants win outright. MiniCPM-V's counter is efficiency — OpenBMB reports 4.5 (8.7B) beating the previous-generation Qwen2.5-VL 72B on the OpenCompass average.
  • Footprint: nothing in the Qwen vision lineup touches minicpm-v4.6's 1.6GB with a 256K context window.
  • Ecosystem: Qwen has broader tooling and sizes, so your prompts survive a hardware upgrade; MiniCPM-V has the only first-party iOS/Android/HarmonyOS deployment story.

We cover the other side in depth — our Qwen 3 VL local setup guide walks through qwen3-vl:7b, the direct size-class rival to minicpm-v4.5. If you have the VRAM for either, run both on your actual documents for an afternoon; on OCR-heavy work the differences are smaller than the benchmark deltas imply. Against older options, 4.5 makes Qwen2-VL 7B and Llama 3.2 11B Vision hard to recommend for new installs — same VRAM class, older results.

Honest limitations

  • !The video capability mostly does not survive Ollama. Ollama's API passes still images, so the 96x-compression, 10FPS pipeline behind the Video-MME score needs the inference paths OpenBMB documents in its repo. Through Ollama, multi-frame work is manual: extract frames with ffmpeg and send several stills per request.
  • !Needs a current Ollama for 4.5/4.6. Older runtimes refuse the pull entirely rather than failing at load time. Home servers running a pinned Ollama version need an upgrade first.
  • !Fine print on low-contrast backgrounds is the weak spot. Small text against busy or dark backgrounds is where OCR in this size class degrades first, and improving it is one of the things OpenBMB says it targeted in the 4.x line. Budget a verification pass when extracting from dashboard screenshots or dark-mode UIs.
  • !Benchmark claims are vendor-published. "Beats GPT-4o-latest" is OpenBMB's claim on one benchmark suite, not a general-capability statement. On open-ended visual reasoning, frontier hosted models remain clearly ahead.
  • !The naming will bite again. Roughly two releases a year, each under a new Ollama name, while the 5.4M-pull default stays frozen. Whatever tutorial you follow, check which tag it pulls. (Also odd: flagship 4.5 carries the family's shortest context at 40K, while tiny 4.6 gets 256K.)

Frequently asked questions

Which MiniCPM-V version should I install?
On a GPU with 8GB+ VRAM: minicpm-v4.5 (8.7B parameters, 6.1GB download) — the family flagship, with a published OpenCompass average of 77.0. On 4-6GB VRAM, integrated graphics, a mini PC, or CPU-only: minicpm-v4.6 (1B-class, 1.6GB download, 256K context). Only pull the plain minicpm-v tag if you specifically want the 2024-era v2.6 that older tutorials were written against — despite its 5.4M pulls, it is two major versions behind.
How much VRAM does MiniCPM-V need?
Plan for 8GB to run the 8B-class versions. Ollama publishes minicpm-v4.5 as a 6.1GB download; budget roughly 1-1.5GB on top of the file size for the vision projector and KV cache, which puts it near 7-7.5GB resident at a normal context length. A 6GB card can still manage the 8B models with a smaller quant (OpenBMB’s GGUF repo publishes a 4.77GB Q4_0 for 4.5, and the legacy minicpm-v listing carries lower-bit tags) or with a few layers offloaded to CPU. minicpm-v4.6 is a 1.6GB download and runs on virtually anything, including CPU-only machines — that is the point of it. Confirm the actual figure on your own machine with ollama ps.
MiniCPM-V vs Qwen3-VL — which should I run locally?
Same size class, different strengths. MiniCPM-V’s edge is efficiency: OpenBMB claims 4.5 (8.7B) beats the far larger Qwen2.5-VL 72B on the OpenCompass average, and the whole project is engineered for phones and small GPUs — 96x video token compression, mixed 4x/16x image compression in 4.6, open-sourced iOS/Android/HarmonyOS code. Qwen3-VL’s edge is range and ecosystem: one family across many sizes with broader tooling, so your prompts survive a hardware upgrade. For a single 8GB card doing OCR, screenshots, and image Q&A, pull minicpm-v4.5 first; if you expect to outgrow 8GB, start with Qwen3-VL.
Why does ollama pull minicpm-v4.6 fail with "requires a newer version"?
The 4.5 and 4.6 releases use newer architectures (SigLIP2 encoder, Qwen3-era LLMs) that older Ollama runtimes cannot load, so the registry refuses the pull outright rather than downloading something the runner cannot open. The error text points you at the fix: update Ollama (ollama.com/download or your package manager), then pull again. Runtimes old enough to predate those architectures will still pull the legacy minicpm-v tag happily, which is why the failure looks selective.
Can MiniCPM-V really run on a phone?
That is the design goal, and OpenBMB backs it with code rather than just claims: the repo ships open-sourced edge adaptation code for iOS, Android, and HarmonyOS, with on-device screen recordings, and claims real-time video understanding on an iPad for 4.6. The 1B-class 4.6 (SigLIP2-400M + Qwen3.5-0.8B) is the version built for this. On a desktop or home server, the same efficiency just buys headroom — 1.6GB leaves your VRAM free for a bigger text model running alongside.

Put a vision model to work locally

The Local AI Master deployment course covers wiring models like MiniCPM-V into real pipelines — document extraction, camera feeds, and app integration — on hardware you already own.

See the course →

Related models & guides

🎯
AI Learning Path

Go from reading about AI to building with AI

20 structured courses. Hands-on projects. Runs on your machine. Start free.

Or own it for life — Lifetime $149 $599, pay once
LM

Written by the Local AI Master Team

The team behind Local AI Master

We build Local AI Master around practical, testable local AI workflows: model selection, hardware planning, RAG systems, agents, and MLOps. The goal is to turn scattered tutorials into a structured learning path you can follow on your own hardware.

✓ Local AI Curriculum✓ Hands-On Projects✓ Open Source Contributor
More on AI Models Directory
See the full AI Models Directory guide.
📚
Free · no account required

Grab the AI Starter Kit — career roadmap, cheat sheet, setup guide

No spam. Unsubscribe with one click.

🎯
AI Learning Path

Found your model? Now build something with it.

25 hands-on courses — RAG, agents, fine-tuning — all running locally. First chapter free, no card.

Or own it for life — Lifetime $149 $599, pay once
Free Tools & Calculators