BaiduQianfanOCRForConditionalGeneration

Qianfan OCR — Hardware Requirements & GPU Compatibility

Vision

Qianfan-OCR is Baidu's 4.7-billion-parameter vision-language model for document intelligence rather than general chat. It pairs a Qianfan-ViT vision encoder with a Qwen3-4B language backbone, doing direct image-to-Markdown conversion alongside table extraction, chart understanding, and document Q&A in one end-to-end model instead of a multi-stage pipeline. It also has an optional "Layout-as-Thought" mode that reasons about page layout before producing output. At under 5 billion parameters, it runs on a single consumer or prosumer GPU once quantized. Context length is 32,768 tokens, extendable further per Baidu's documentation. It is released under the Apache 2.0 license, permitting unrestricted commercial and research use. Published in March 2026, Baidu reports it as its top-scoring end-to-end model on public document-parsing benchmarks, supporting 192 languages.

4.7B params · dense33K contextApache 2.0Mar 202631.2K downloads1.2K likes1.6K quant downloads

Your hardware

Verdicts below are for the reference RTX 4090. Set yours to personalise the page.

Detection reads your browser's GPU name with no data sent anywhere.

Runs great on a 24 GB GPU

Runs from 8 GB (Q4_K_M · 32K)Best on 24 GB (Q4_K_M · ~197 tok/s · 32K)Macs from 8 GB (Q4_K_M · ~22 tok/s)

Apache 2.0

Reference GPU · RTX 4090 24 GB

Estimates, ±20% · how we estimate

Run Qianfan OCR

One recommended way. Every other method, OS and quant is in the step-by-step guide.Each way opens a step-by-step guide for your OS and quant.

Ways to runOther ways

each opens step-by-step

Run in cloud

Your own private copy · Q4_K_M · 24 GB GPU

The easiest way to try this model
Running in a few minutes, easy setup
Chat right here or connect any app

$5+ bonus for new users

Run Qianfan OCR

4.7 GB VRAM at 16K context · fits the RTX 4090 (19.3 GB free)

Works on macOS, Windows and Linux.

Install Ollama (Linux)
$curl -fsSL https://ollama.com/install.sh | sh
Install Ollama (macOS / Windows)
Download and run the app; it installs the ollama command.
Download Ollama ↗
Run Q4_K_M
$ollama run hf.co/Reza2kn/Qianfan-OCR-GGUF:Q4_K_M
Raise the context window
Type it inside the chat. For the API server instead, start it with OLLAMA_CONTEXT_LENGTH=16384 ollama serve.
$/set parameter num_ctx 16384
A larger context needs more memory than the weights alone.
Use the API
Ollama serves its API on http://localhost:11434.

Works on macOS, Windows and Linux.

Install LM Studio
Desktop app for macOS (Apple silicon), Windows and Linux.
lmstudio.ai ↗
Download the model
In the app press Ctrl/Cmd + Shift + M and paste https://huggingface.co/Reza2kn/Qianfan-OCR-GGUF, then pick Q4_K_M. Or use the CLI (run LM Studio once first):
$lms get https://huggingface.co/Reza2kn/Qianfan-OCR-GGUF@Q4_K_M
Open on Hugging Face ↗
Load and chat
Open the model loader, select the model and set Context Length to 16384. Leave GPU offload at maximum if it fits.
Start the local server (optional)
$lms server start

Works on macOS, Windows and Linux.

Install llama.cpp (macOS)
MacPorts, Nix and conda-forge also work.
$brew install llama.cpp
Install options ↗
Install llama.cpp (Windows)
$winget install llama.cpp
Install llama.cpp (Linux)
Download the prebuilt llama-*-bin-ubuntu-* archive for your GPU backend (CPU, Vulkan) from the releases page, unpack it and run the binaries from that folder. Homebrew (brew install llama.cpp) and conda-forge also work on Linux.
llama.cpp releases ↗
Start the server
Downloads the model on first run. The chat UI and an OpenAI-compatible API are at http://localhost:8080.
$llama-server -hf Reza2kn/Qianfan-OCR-GGUF:Q4_K_M -c 16384 -ngl 99 --port 8080

Works on macOS, Windows and Linux.

Option A: Docker Model Runner
Docker Desktop: Settings > AI > Enable Docker Model Runner. Docker Engine on Linux: install the docker-model-plugin package.
$docker model run hf.co/Reza2kn/Qianfan-OCR-GGUF:Q4_K_M
Model Runner docs ↗
The quant tag after the repo is how Hugging Face cards write it; if your Docker version rejects it, drop the tag and pick the quant by repo.
Option B: llama.cpp server image (NVIDIA)
Needs the NVIDIA Container Toolkit. Models are cached in the llama-cache volume. Open http://localhost:8080.
$docker run --gpus all -p 8080:8080 -v llama-cache:/root/.cache ghcr.io/ggml-org/llama.cpp:server-cuda -hf Reza2kn/Qianfan-OCR-GGUF:Q4_K_M -c 16384 -ngl 99 --host 0.0.0.0 --port 8080
Image tags (cuda13, vulkan, rocm) ↗
Cache path inside the image is not in the docs; remove the -v flag if the volume complains.

Linux only.

Install vLLM
Linux only; on Windows run it inside WSL2. NVIDIA GPU shown; AMD ROCm, Intel and CPU builds have their own install pages.
$uv venv --python 3.12 --seed
$source .venv/bin/activate
$uv pip install vllm --torch-backend=auto
vLLM installation ↗
Serve the model
OpenAI-compatible API at http://localhost:8000/v1.
$vllm serve baidu/Qianfan-OCR --max-model-len 16384
Runs the original weights, not the Q4_K_M GGUF; needs ~10 GB of GPU memory.

macOS only.

MLX supports only macOS, so follow these steps for that setup.

Install mlx-lm
$pip install mlx-lm
Chat in the terminal
$mlx_lm.chat --model jason1966/Qianfan-OCR-MLX-4bit
Downloads the model on first run. The MLX repo has its own quantisation; it may not match the quant selected above.
Or start a local server
Listens on http://localhost:8080.
$mlx_lm.server --model jason1966/Qianfan-OCR-MLX-4bit

Works on macOS, Windows and Linux.

Install Jan
jan.ai ↗
Find the model
Open the Hub tab, paste this model ID in Search, and choose Q4_K_M if offered.
$Reza2kn/Qianfan-OCR-GGUF
Use the local API (optional)
Settings > Local API Server > Start Server. It listens on http://127.0.0.1:1337.

Rent GPUs hourly to run Q4_K_M right there. Pricing comes from partner marketplaces and varies.

Available GPU rentals for Q4_K_M, prioritized by value
GPU	Speed	$/1M tokens	Rent
RTX 3080 Ti (12 GB)CheapestCheapest7 GB free	~178 tok/s	$0.19	Deploy on Vast.aifrom $0.12/hr (opens in new tab)	12 GB · 7 GB free · ~178 tok/s · $0.19 / 1M tokens
RTX 3060 12GB7 GB free	~70 tok/s	$0.24	Deploy on Vast.aifrom $0.061/hr (opens in new tab)	7 GB free · ~70 tok/s · $0.24 / 1M tokens
RTX 4060 (8 GB)3 GB free	~53 tok/s	$0.45	Deploy on Vast.aifrom $0.086/hr (opens in new tab)	8 GB · 3 GB free · ~53 tok/s · $0.45 / 1M tokens
RTX A4000 (16 GB)11 GB free	~87 tok/s	$0.28	Deploy on Vast.aifrom $0.088/hr (opens in new tab)	16 GB · 11 GB free · ~87 tok/s · $0.28 / 1M tokens
RTX 4070 SUPER (12 GB)7 GB free	~98 tok/s	$0.29	Deploy on Vast.aifrom $0.10/hr (opens in new tab)	12 GB · 7 GB free · ~98 tok/s · $0.29 / 1M tokens
RTX PRO 4500 (32 GB)27 GB free	~175 tok/s	$0.54	Deploy on RunPodfrom $0.34/hr (opens in new tab)	32 GB · 27 GB free · ~175 tok/s · $0.54 / 1M tokens
RTX 4090 (24 GB)19 GB free	~197 tok/s	$0.48	Deploy on RunPodfrom $0.34/hr (opens in new tab)	24 GB · 19 GB free · ~197 tok/s · $0.48 / 1M tokens
A40 (48 GB)43 GB free	~136 tok/s	$0.72	Deploy on RunPodfrom $0.35/hr (opens in new tab)	48 GB · 43 GB free · ~136 tok/s · $0.72 / 1M tokens
L4 (24 GB)19 GB free	~59 tok/s	$2.09	Deploy on RunPodfrom $0.44/hr (opens in new tab)	24 GB · 19 GB free · ~59 tok/s · $2.09 / 1M tokens

Compare GPUs →

Your own private copy of Qianfan OCR · Q4_K_M · OpenAI-compatible API

Open the llama.cpp listing on RunPod
Open on RunPodServerless (opens in new tab)
New to RunPod? Sign up and add credit first.
2
Fill in the form
Press Deploy and fill in:
Model
Reza2kn/Qianfan-OCR-GGUF
Quantization
q4_k_m
Context Size
16384
After pasting the model press Esc — don’t pick a suggestion. Press Next.
Create the endpoint
Keep the default 24 GB and 48 GB, then Create Endpoint. Right away: Manage → Edit endpoint → Max workers 1 → Save (changing settings later restarts the worker).
The first start downloads the model, usually 5–15 min. After that, replies after a pause come in seconds.
Create an API key
RunPod → Settings → API Keys → Create. Pick “Restricted” with access to this endpoint only.

Use it

Copy the endpoint URL from its page on RunPod (any of its links works) and paste it with the key. Both stay in this browser.

Endpoint URL

API key

Chats and keys stay only in this browser.

https://api.runpod.ai/v2/<ENDPOINT_ID>/openai/v1

Put your endpoint ID in place of <ENDPOINT_ID>. The API key is the one from step 2.

from openai import OpenAI
client = OpenAI(base_url="https://api.runpod.ai/v2/<ENDPOINT_ID>/openai/v1", api_key="rpa_...")
r = client.chat.completions.create(
    model="any",
    messages=[{"role": "user", "content": "Hello!"}])
print(r.choices[0].message.content)

Works with any OpenAI client.

https://api.runpod.ai/v2/<ENDPOINT_ID>/openai/v1

Put your endpoint ID in place of <ENDPOINT_ID>. The API key is the one from step 2.

Free on Windows, macOS, Linux, iOS, Android and the web.

Open the web app ↗ (opens in a new tab)Download ↗ (opens in a new tab)

1. Settings → Model Provider → Add → Add Custom Provider
2. API Mode OpenAI API Compatible; paste the API key and the base URL as API Host
3. Model → Fetch, pick the model
4. New chat → pick the provider → start chatting

Free and open source for Windows, macOS and Linux.

Download Jan ↗ (opens in a new tab)

1.Settings → next to Model Providers press +
2.API format OpenAI-compatible; Base URL is the base URL above (with /v1); API key is your key; Create
3.If no model appears, click + in Models and type any
4.New chat → pick the model → start chatting

How Much VRAM Does Qianfan OCR Need?

Select a quantization level; the listed hardware adheres to it.

VRAM	+32K	+128K	File	Quality	On RTX 4090 (reference)
2.5 GB	5.3 GB	—	1.8 GB	2-bit · K-quant — 2-bit quantization with K-quant improvements	Fits: 32K context · ~262 tok/s
2.6 GB	5.4 GB	—	2.1 GB	3-bit small — 3-bit small quantization	Fits: 32K context · ~256 tok/s
2.8 GB	5.6 GB	—	2.2 GB	3-bit medium — 3-bit medium quantization	Fits: 32K context · ~234 tok/s
2.9 GB	5.7 GB	—	2.6 GB	4-bit · legacy — 4-bit legacy quantization	Fits: 32K context · ~229 tok/s
3.2 GB	6 GB	—	2.6 GB	4-bit small — 4-bit small quantization	Fits: 32K context · ~207 tok/s
3.3 GB	6.2 GB	—	2.7 GB	4-bit medium — 4-bit medium quantization — most popular sweet spot	Fits: 32K context · ~197 tok/s
3.8 GB	6.6 GB	—	3.1 GB	5-bit small — 5-bit small quantization	Fits: 32K context · ~175 tok/s
3.9 GB	6.7 GB	—	3.2 GB	5-bit medium — 5-bit medium quantization — good quality/size tradeoff	Fits: 32K context · ~169 tok/s
4.4 GB	7.2 GB	—	3.6 GB	6-bit, very good — 6-bit quantization, very good quality	Fits: 32K context · ~149 tok/s
5.2 GB	8.1 GB	—	4.7 GB	8-bit, near-lossless — 8-bit quantization, near-lossless	Fits: 32K context · ~125 tok/s
10.0 GB	12.8 GB	—	8.8 GB	16-bit · bfloat — Brain floating point 16 — preferred for training	Fits: 32K context · ~66 tok/s

Selected Q4_K_M

4-bit medium quantization

4.7GBat 16K context

Weights: 2.8 GB
KV cache: 1.5 GB
Overhead: 0.3 GB

Fits RTX 4090 (reference) · 19.4 GB free · ~197 tok/s

≥50 tok/s needs ≥256 GB/s · RTX 5090 ~350, RTX 3090 Ti ~197

Which Hardware Can Run Qianfan OCR?

Q4_K_M · 3.3 GB

Qianfan OCR (Q4_K_M) requires 3.3 GB of VRAM to load the model weights. For comfortable inference with headroom for KV cache and system overhead, 5+ GB is recommended. Using the full 33K context window can add up to 2.8 GB, bringing total usage to 6.2 GB. 52 GPUs can run it, including NVIDIA GeForce RTX 5090, NVIDIA GeForce RTX 3090 Ti. 163 devices with unified memory can run Qianfan OCR, including Mac Studio (M3 Ultra, 256GB), Mac Studio (M3 Ultra, 512GB), MacBook Air 13" M3 (8 GB).

By VRAM tier · typical GPUs and Macs at Q4_K_M

Typical hardwareQuantVRAMtok/sContext that fits

8 GB · RTX 4060Q4_K_M · 4.7 GB · ~53 tok/s · 32K4.7~5332K8 GB tier →

12 GB · RTX 3060 12GBQ4_K_M · 4.7 GB · ~70 tok/s · 32K4.7~7032K12 GB tier →

16 GB · RTX 5060 Ti 16GBQ4_K_M · 4.7 GB · ~87 tok/s · 32K4.7~8732K16 GB tier →

24 GB · RTX 4090referenceQ4_K_M · 4.7 GB · ~197 tok/s · 32K4.7~19732K24 GB tier →

Mac 32 GB · Mac Mini M4Q4_K_M · 4.7 GB · ~25 tok/s · 32K4.7~2532KMacs →

Mac 64 GB · Mac Studio M4 MaxQ4_K_M · 4.7 GB · ~115 tok/s · 32K4.7~11532KMacs →

Alternatives to Qianfan OCR

Similar models

5tok/s on RTX 4090

Model	Score	VRAM	tok/s	Why it is similar
Qwen3.5 4BAlibaba	98.5	3.4 GB	~201	same size
Molmo2 4BAllen AI	—	4.7 GB	~193	same size
Qwen3 VL 4B InstructAlibaba	—	4.5 GB	~208	same size
Qwen3.6 27B MTPLX Optimized SpeedYoussofal	—	4 GB	~185	same size
Gemma 4 E2B IT Qat Q4 0 UnquantizedGoogle	—	3.5 GB	~192	same size

Specifications

Publisher: Baidu
Parameters: 4.7B
Architecture: QianfanOCRForConditionalGeneration
Context Length: 32,768 tokens
Vocabulary Size: 153,678
Release Date: 2026-03-18
License: Apache 2.0

Resources

Hugging Face model card (opens in a new tab)

Frequently Asked Questions

How much VRAM does Qianfan OCR need?

Qianfan OCR requires 3.3 GB of VRAM at Q4_K_M, or 10.0 GB at BF16. Full 33K context adds up to 2.8 GB (6.2 GB total).

VRAM = Weights + KV Cache + Overhead

Weights = 4.7B × 4.8 bits ÷ 8 = 2.8 GB

KV Cache + Overhead ≈ 0.5 GB (at 2K context + ~0.3 GB framework)

Fit ratings and hardware model lists check this model with room for a 16K-token context, which needs a little more memory.

KV Cache + Overhead ≈ 3.4 GB (at full 33K context)

VRAM usage by quantization

Q4_K_M

3.3 GB

Q4_K_M + full context

6.2 GB

Learn more about VRAM estimation →

What's the best quantization for Qianfan OCR?

For Qianfan OCR, Q4_K_M (3.3 GB) offers the best balance of quality and VRAM usage. Q5_K_S (3.8 GB) provides better quality if you have the VRAM. The smallest option is Q2_K at 2.5 GB.

VRAM requirement by quantization

Q2_K

2.5 GB~75%

Q4_0

2.9 GB~85%

Q4_K_M ★

3.3 GB~89%

Q5_K_S

3.8 GB~92%

Q6_K

4.4 GB~95%

BF16

10.0 GB~100%

★ Recommended — best balance of quality and VRAM usage.

Learn more about quantization →

Can I run Qianfan OCR on a Mac?

Yes — MacBook Air 13" M3 (8 GB) and 145 other Macs can run Qianfan OCR. Apple Silicon uses unified memory, so the model shares RAM with the system. At Q4_K_M you need at least 3.3 GB of usable unified memory (RAM minus macOS overhead).

Can I run Qianfan OCR locally?

Yes — Qianfan OCR can run locally on consumer hardware. Popular tools include Ollama, LM Studio, and llama.cpp.

How fast is Qianfan OCR?

At Q4_K_M, Qianfan OCR can reach ~1441 tok/s on AMD Instinct MI350X. On NVIDIA GeForce RTX 4090: ~197 tok/s. Speed depends mainly on GPU memory bandwidth. Real-world results typically within ±20%.

tok/s = (bandwidth GB/s ÷ model GB) × efficiency

Example: NVIDIA B200 → 8000 ÷ 3.33 × 0.65 = ~1562 tok/s

Estimated speed at Q4_K_M (3.3 GB)

NVIDIA B200

~1562 tok/s

NVIDIA GeForce RTX 4090

~197 tok/s

NVIDIA B300

~1562 tok/s

AMD Instinct MI350X

~1441 tok/s

Real-world results typically within ±20%. Speed depends on batch size, quantization kernel, and software stack.

Learn more about tok/s estimation →

What's the download size of Qianfan OCR?

At Q4_K_M, the download is about 2.84 GB. The full-precision BF16 version is 9.48 GB. The smallest option (Q2_K) is 2.02 GB.

Which GPUs can run Qianfan OCR?

52 consumer GPUs can run Qianfan OCR at Q4_K_M. Top options include AMD Radeon RX 6700 XT, AMD Radeon RX 6800, AMD Radeon RX 6800 XT. 52 GPUs have plenty of headroom for comfortable inference.

Which devices can run Qianfan OCR?

163 devices with unified memory can run Qianfan OCR at Q4_K_M (3.3 GB), including AMD Ryzen AI 9 HX 370 (Strix Point) Laptop, ASUS Ascent GX10, Beelink GTR9 Pro (Ryzen AI Max+ 395, 128 GB), Framework Desktop (Ryzen AI Max+ 395, 128 GB). Apple Silicon Macs use unified memory shared between CPU and GPU, making them well-suited for local LLM inference.