OpenModelsHQ

HunyuanOCR

Tencent HunyuanVisionDenseCustom licenseChina Desk

HunyuanOCR is an open-weight vision and language model from Tencent Hunyuan with 1.1B parameters. At 4-bit it needs about 1.6 GB of memory, so the smallest current device that fits it is the Mac mini M6 (16GB).

Overview

Estimated memory at 4-bit
1.6GB

Includes room for an 8k context and runtime overhead. More context needs more memory.

Total parameters
1.1B
Dense
Context window
128K
131,072 tokens
Cheapest API, blended / 1M
No hosted API
Weights only

Key information

Lab
Tencent Hunyuan
Released
18 Nov 2025
Parameters
1.1B
Type
Vision and language
Context
131,072 tokens
HF downloads, 30 days
642,291
View all

Will it run on your hardware?

How we estimate
Memory needed vs devices
HunyuanOCR needs about 1.6 GB at 4-bit, 2.2 GB at 8-bit and 3.3 GB at 16-bit. At 4-bit it fits GeForce RTX 5060 Ti 16GB, GeForce RTX 5090, DGX Spark, Mac Studio M5 Ultra (256GB). Dashed lines are usable memory on each device; a model fits when its estimate stays within 90% of it. Log scale. 8k context.
Memory needed vs devices: data
Estimate or deviceMemory
Q41.6 GB
Q82.2 GB
BF163.3 GB
RTX 5060 Ti 16 GB16 GB usable
RTX 5090 32 GB32 GB usable
DGX Spark 128 GB108.8 GB usable
Mac Studio M5 Ultra 256 GB192 GB usable

Single-device memory estimate. Pick a device to update the On your device column.

36 GB usable memory

FormatMemory neededOn your deviceExample hardware
4-bit (Q4)≈ 1.6 GBFits 4%Mac mini M6 (16GB)16 GB memory
8-bit (Q8)≈ 2.2 GBFits 6%Mac mini M6 (16GB)16 GB memory
16-bit (BF16)≈ 3.3 GBFits 9%Mac mini M6 (16GB)16 GB memory

Fits means the estimate stays within 90% of usable memory. Tight is above 90% and up to 100%. Too big is above 100%. These are memory checks, not speed or compatibility tests.

Mac allowances are 66% of total RAM up to 36 GB, and 75% above. AI boxes allow 85% because their memory is shared with the operating system.

Where to run it

On a Mac

No trusted MLX build found yet.

Check your Mac

With GGUF

Choose a file for llama.cpp or a compatible app.

ggml-org/HunyuanOCR-GGUFFind compatible hardware

Through an API

No hosted API found.

GGUF with llama.cppView repository
llama-cli -hf ggml-org/HunyuanOCR-GGUF \
  -c 8192 -p "Explain how a transformer works."

Example commands built from the repository ids above. They need a working install of llama.cpp. We have not run them; check each repository for available files.

More about this model

Frequently asked questions

How much memory does HunyuanOCR need? At an 8k context, about 1.6 GB at 4-bit, 2.2 GB at 8-bit and 3.3 GB at 16-bit (BF16). A longer context needs more.

Can I run HunyuanOCR on a Mac? The smallest current Mac that fits the 4-bit estimate of 1.6 GB is the Mac mini M6 (16GB). We have not found a trusted MLX build yet, but a GGUF build is available.

Does the full context fit? HunyuanOCR supports up to 131,072 tokens of context. Our memory estimates use 8k, so long prompts need more memory than shown.

What does it cost through an API? We did not find a hosted API for this model.

License in plain English

Custom license. This model uses a custom license rather than a standard one. Read it on the model card before using the model commercially. This summary is not legal advice.

Read the license on the model card

OMHQ RigBench

Not yet tested. We show no speed or quality score without a measurement.

Revision history and sources

Last updated . Sources:Hugging Face model card, GGUF repository.