// Tencent Hunyuan / Hy · Vision-language
HunyuanOCR: VRAM & local deployment
1.12B parameters. About 2.1 GB at 4-bit and 3.8 GB at BF16 with one 8K-token request.
released 2025-11-18licence: Commercial with conditionsmemory figures are estimates
01Specs
| Publisher | Tencent · tencent |
|---|---|
| Family / series | Tencent Hunyuan / Hy · HunyuanOCR |
| Type | Vision-language (image-text-to-text) |
| Parameters | 1.12B Source: counted from official safetensors weights |
| Context length | 128K tokens (131,072)max_position_embeddings in config.json |
| Architecture | 24 layers · GQA |
| Released weights | BF16 · 2.2 GBdownload |
| Licence | tencent-hunyuan-community · Commercial with conditionsCommercial use allowed under the publisher’s own licence terms (user caps, acceptable-use policy, attribution or region limits). Read it before shipping. |
| Released | 2025-11-18 (Hugging Face repo created) |
02How much VRAM it needs (estimate)
Total = weights + 10% + 0.5GB overhead + KV cache for one request (FP16 KV). More concurrent users multiply the KV column.
| Precision | Weights | Total @ 8K | Total @ 32K | Total @ 128K | Smallest GPU | Mac |
|---|---|---|---|---|---|---|
| BF16 / FP16 (original) | 2.2 GB | 3.8 GB | 6.2 GB | 15.8 GB | 8GB GPU | Mac 16GB |
| FP8 / INT8 / Q8_0 | 1.2 GB | 2.6 GB | 5.0 GB | 14.7 GB | 8GB GPU | Mac 16GB |
| 4-bit (Q4_K_M / AWQ / GPTQ-Int4) | 0.7 GB | 2.1 GB | 4.5 GB | 14.1 GB | 8GB GPU | Mac 16GB |
KV cache per request: 8K 0.8 GB · 32K 3.2 GB · 128K 12.9 GB
Bits per weight: BF16 16, FP8 8.5, 4-bit 4.85. “Fits” = total ≤ 90% of memory; Mac GPU can use ~2/3 of unified memory (≤36GB) or ~3/4 (larger). For MoE, all experts must be in memory, so size by total parameters. Method →
03How to run it
Only runtimes the publisher or the runtime’s official library names for this model.
- vLLM — mentioned in the official model card
- llama.cpp — mentioned in the official model card
- Transformers — mentioned in the official model card
04Official repositories & quantised builds
1 official repo(s) from tencent.
- HunyuanOCR main
05Other Tencent Hunyuan / Hy models
All 19 →| Model | Params | 4-bit total | Released |
|---|---|---|---|
| Hy-Memory-30B-A3B | 30.1B / 3B | 21.4 GB | 2026-10-15 |
| Hy4-preview | 770B / 49B | 515 GB | 2026-08-27 |
| Hy3 | 295B / 21B | 200 GB | 2026-07-02 |
| Hy-MT2-1.8B | 2.04B | 2.4 GB | 2026-05-11 |
| Hy-MT2-7B | 8.03B | 6.9 GB | 2026-05-11 |
| Hy-MT2-30B-A3B | 30.1B / 3B | 21.4 GB | 2026-05-11 |
| Hy3-preview | 295B / 21B | 200 GB | 2026-04-13 |
| HY-MT1.5-1.8B | 2.04B | 2.4 GB | 2025-12-25 |
06Sources
Data checked 2026-08-28. Parameters, context and licence are copied from the official repository; memory figures are our estimates.