HU

hunyuanocr

HunyuanocrGGUF by SandLogicTechnologiesUpdated 2026-08-04
Download on Hugging Face
Parameters539M
Context128K
Layers24
Architecturehunyuan_vl
Smallest quant0.3 GB
Quick answer

hunyuanocr needs about 1.6 GB of memory at IQ4_XS (a 0.3 GB file) with an 8K context window, so it fits on a 4 GB GPU. This repository has 3 quants, from 0.3 GB (IQ3_M) to 0.3 GB (IQ4_NL). Longer context needs more: at 32K tokens the KV cache alone adds about 3.2 GB.

hunyuanocr is a 539M-parameter Hunyuanocr model in GGUF format, quantized by SandLogicTechnologies. Its trained context length is 128K tokens. The repository has 3 quant files, from 0.3 GB (IQ3_M) to 0.3 GB (IQ4_NL).

Quants & memory

QuantFileEst. memoryvs VRAMResultDownload
IQ3_M0.3 GB 1.6 GB
Fits Get file →
IQ4_XS0.3 GB 1.6 GB
Fits Get file →
IQ4_NL0.3 GB 1.6 GB
Fits Get file →

What GPU do you need for hunyuanocr?

These figures add the file size, an fp16 KV cache at an 8K context window (worked out from this model’s own header) and about 0.5 GB for the runtime. They are estimates, so leave a little headroom, and expect to use less context or a smaller quant if you are right at the limit.

  • 4 GB VRAM: the best quant that fits is IQ4_NL (0.3 GB file, about 1.6 GB in use).

Which hunyuanocr quant should you choose?

IQ4_XS (0.3 GB) is the middle option in this repository. The usual sweet spot between file size and quality, and the quant most people start with.

If memory is tight, the smallest file is IQ3_M at 0.3 GB, with the quality trade-offs that come with fewer bits. A reasonable choice when a 4-bit file will not fit, mostly on larger models. Quality loss is noticeable but often acceptable.

New to quant names? Read GGUF quantization explained.

Specifications

Architecture from the GGUF header

Architecturehunyuan_vl
Parameters539M
Layers24
Trained context131,072 tokens
KV cache (fp16)96 KB per token

Source

Licenseapache-2.0
Downloads (HF)120
Last updated2026-08-04

Frequently asked questions about hunyuanocr

How much VRAM does hunyuanocr need?

About 1.6 GB at IQ4_XS with an 8K context window. That is the 0.3 GB file, plus the KV cache and roughly 0.5 GB of runtime overhead. Smaller quants need less and longer context needs more.

Can I run hunyuanocr on an 8 GB GPU?

Yes, with IQ4_NL: the 0.3 GB file needs about 1.6 GB at 8K context. Larger quants in this repository do not fit in 8 GB.

What is the file size of hunyuanocr GGUF?

It depends on the quant: IQ3_M is 0.3 GB, IQ4_XS is 0.3 GB, IQ4_NL is 0.3 GB.

What context length does hunyuanocr support?

The GGUF header lists a trained context length of 131,072 tokens (128K). The KV cache grows with the context you use: about 0.8 GB at 8K and 3.2 GB at 32K.

Where can I download hunyuanocr GGUF?

The files are on Hugging Face in the SandLogicTechnologies/hunyuanocr-GGUF repository. The download buttons on this page open the file on Hugging Face. ggufmodels.com does not host any model files.

What license does hunyuanocr use?

Hugging Face lists the license as apache-2.0. Licenses can differ between the quantized files and the original model, so check the repository and the base model before commercial use.

Other GGUFs of HunyuanOCR

Similar models

Browse all →

More from SandLogicTechnologies

All by SandLogicTechnologies →

More Hunyuanocr models

All Hunyuanocr →

Other tiny models

All tiny models →