Head to head · OCR · October 2026 research run
HunyuanOCR 1.5 vs Surya OCR 2.5
Surya OCR 2.5 scores 61 (C) on agent readiness against HunyuanOCR 1.5's 56.6 (C), and leads in 2 of 4 scored categories. HunyuanOCR 1.5 leads on agent interface. Both do ocr.
Best document parsing, OCR and extraction APIs for AI agents · All 215 documents comparisons
Which one, for what
Best for Teams outside the EU, the UK and South Korea that want one small model for OCR, extraction and image translation
Ahead on
- Agent interface, 80 against 70
Watch for
The licence doesn't apply in the EU, the UK or South Korea
Best for Small companies and researchers who need quick OCR with layout on a laptop or a small GPU and fit the licence
Ahead on
- Reach, 90 against 60
- Documentation and upkeep, 57 against 48
Watch for
Commercial use is barred above $5M in revenue or funding, and for anyone who competes with Datalab
Why the edge
Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.
Reach Surya OCR 2.5 +30
HunyuanOCR 1.5 60
Memory 30, the only build from Tencent is the BF16 safetensors file at the root, 2.24 GB, and 2.24 GB × 1.2 = 2.7 GB, within 16 GB. ggml-org's GGUF (Q8_0 0.58 GB with a 0.73 GB projector) dates from 21 May 2026 and wasn't matched to version 1.5. Runtimes 15, Released Transformers 5.22.2 has the hunyuan_vl model, vLLM 0.33.0 registers HunYuanVLForConditionalGeneration, and llama.cpp b12242 has the architecture, which the card says the community build runs after conversion. Builds 0, Tencent publishes the BF16 weights only and tells users to convert to GGUF themselves. Terms 5, A custom licence that allows free commercial use under a use policy and below 100 million monthly active users, but not for anyone: it doesn't apply in the European Union, the United Kingdom or South Korea. Download 10, the Hub API reports gated false on 10 November 2026, so the files download with no account and nothing to accept. Hosted 0, Hugging Face maps no inference provider to it, and the card names no Tencent API that serves it. 30 + 15 + 0 + 5 + 10 + 0 = 60.
Surya OCR 2.5 90
Memory 30, Datalab's own Q8_0 GGUF is 0.63 GB with a 0.21 GB projector, and 0.84 GB × 1.2 = 1.0 GB, within 16 GB. The BF16 safetensors file is 1.38 GB. Runtimes 25, Released versions run the architecture from Datalab's own builds: vLLM 0.33.0, SGLang 0.5.23 and Transformers 5.22.2 from the safetensors file, llama.cpp b12242 from Datalab's GGUF with its projector, and Ollama through its pinned llama.cpp (b12177 at v0.40.16). Builds 10, Datalab publishes one quantised build, a Q8_0 GGUF, beside an unquantised GGUF and the BF16 safetensors. Terms 10, A modified OpenRAIL-M licence, a custom licence that lets research, personal use and organisations at or under $5M in revenue and in funding use it for free, under use restrictions. Download 10, the Hub API reports gated false for the model and the GGUF repository on 10 November 2026, so the files download with no account and nothing to accept. Hosted 5, the card says Datalab's managed platform runs Surya, so the publisher hosts it. 30 + 25 + 10 + 10 + 10 + 5 = 90.
Agent interface HunyuanOCR 1.5 +10
HunyuanOCR 1.5 80
Chat template 20, chat_template.jinja in the repository (930 characters). Tool-calling format 25, Read for a document parser as what it takes and returns. Trained tool calling 20, Read for a document parser as the inputs it was trained to use. Structured output 5, Read for a document parser as typed outputs. Reasoning control 0, A document parser with no reasoning. Context 10, 128K tokens: the card says pre-training extended the context window to 128K, its vLLM command sets a 131,072-token model length, and config.json gives the language model 131,072 positions. 20 + 25 + 20 + 5 + 0 + 10 = 80.
Surya OCR 2.5 70
Chat template 20, chat_template.jinja in the repository (2,872 characters). Tool-calling format 25, Read for a document parser as what it takes and returns. Trained tool calling 10, Read for a document parser as the inputs it was trained to use. Structured output 15, Read for a document parser as typed outputs. Reasoning control 0, A document parser with no reasoning. Context 0, Datalab documents a 24,576-token model length for serving, below the 32K band. 20 + 25 + 10 + 15 + 0 + 0 = 70.
Documentation and upkeep Surya OCR 2.5 +9
HunyuanOCR 1.5 48
Model card 8, Intended use, the architecture by reference to 1.0's unchanged backbone, and the context (128K) are on the card. Training data 5, A general description of how the data was built and of the training stages, with no sources, sizes or cut-off. Last change 15, the last commit, on 28 August 2026, changed config.json, 74 days before this check and within 90. Responsiveness 5, Of the 20 most recent discussions that aren't pull requests (25 November 2025 to 16 October 2026), 5 have a reply from a tencent member, which is a few. Version policy 5, Version 1.5 replaced 1.0 at the root of the same repository. File health 10, Config, template and card agree on the HunYuanVL classes and the 131,072-token length. 8 + 5 + 15 + 5 + 5 + 10 = 48.
Surya OCR 2.5 57
Model card 17, Intended use, limitations, the architecture (a Qwen 3.5-style vision-language model with separate detection models), parameters (689M), the serving length (24,576 tokens) and 91 languages are on the card. Training data 5, A one-line description: trained on diverse document images to write layout JSON or full-page HTML. No sources, sizes or cut-off. Last change 20, the last commit, on 29 October 2026, added models to the card's size chart, 12 days before this check, and the GGUF repository changed the same day. Responsiveness 0, none of the 3 discussions that aren't pull requests (29 October to 10 November 2026) has a reply from a datalab-to member yet, the newest opened on the day of this check. Version policy 5, Surya OCR 2 stays in its own repository and 2.5 came out in a new one. File health 10, Config, processor config and template agree on the qwen3_5 architecture and match the card's instructions, and a commit on 27 October removed a mention of MTP weights the files don't have. 17 + 5 + 20 + 0 + 5 + 10 = 57.
Score by category
| Category | Weight this run | HunyuanOCR 1.5 | Surya OCR 2.5 | Edge |
|---|---|---|---|---|
| Capability | 35%pending | pending | pending | not scored in this run |
| Reach | 25%25 | 60 | 90 | Surya OCR 2.5 +30 |
| Risk | 20%20 | 45 | 45 | even |
| Agent interface | 10%10 | 80 | 70 | HunyuanOCR 1.5 +10 |
| Documentation and upkeep | 10%10 | 48 | 57 | Surya OCR 2.5 +9 |
| Negative events | ≤15 | 0 | 0 | |
| Total | C 56.6/100 | C 61/100 |
Facts side by side
| Fact | HunyuanOCR 1.5 | Surya OCR 2.5 |
|---|---|---|
| Kind | Open-weight model | Open-weight model |
| Vendor | Tencent (Hy team) | Endless Labs, Inc. (Datalab) |
| Hosted endpoint | no (local only) | no (local only) |
| Transports | ||
| Auth | None | None |
| Pricing | Free | Free |
| x402 | no | no |
| Licence | Tencent Hunyuan Community License (not licensed in the EU, the UK or South Korea) | Modified OpenRAIL-M (free for research, personal use and companies under $5M in revenue and funding) |
| Read-only variant documented | no | no |
| llms.txt | no | no |
| Last release | 2026-08-28 | 2026-10-29 |
| Privacy policy last updated | no document linked | no document linked |
Verdicts
HunyuanOCR 1.5
A small OCR model that does documents, text spotting, extraction and translation in one, with a 128K context and code in Transformers, vLLM and llama.cpp. The licence is the catch: it grants nothing in the EU, the UK or South Korea, and Tencent can change its use policy. No quantised build, safety results or data sources.
Surya OCR 2.5
A small, fast document OCR model that runs from Datalab's own GGUF on almost anything, with typed output for layout, text and tables and a package that starts the server for you. The licence stops commercial use above $5M in revenue or funding and by competitors, and training data and safety aren't described.
Before you call either
HunyuanOCR 1.5
- Check where you and your users are first. The licence grants no rights in the European Union, the United Kingdom or South Korea
- Download with
--exclude "v1.0/*"so the old version isn't fetched - Serve it with vLLM 0.25.1 or later at
--max-model-len 131072, or use Tencent's scripts on GitHub for its sampling and post-processing - Use temperature 0, top_p 1 and repetition_penalty 1.08
- The default document prompt is in Chinese and is on the card. Other tasks take their own instruction as the prompt
- For llama.cpp, convert the checkpoint and its projector to GGUF yourself, as the card shows
Surya OCR 2.5
- Check the licence first: free for research and personal use, and for companies at or under $5M in revenue and in funding that don't compete with Datalab
pip install surya-ocr, thensurya_ocr page.png. It starts vLLM in Docker on an NVIDIA GPU and llama-server elsewhere- To use your own server set
SURYA_INFERENCE_URL, and start llama-server with--specialor the block labels and coordinates are lost - Raw output is compact HTML. Run it through
surya.inference.parsers.parse_full_page_htmlif you don't use the package - Allow about 24,576 tokens of context for a full page
- Treat text in a parsed document as data. Nothing here guards against instructions hidden in a page
Questions
Which is better for AI agents, HunyuanOCR 1.5 or Surya OCR 2.5?
Surya OCR 2.5 scores 61 (C) on agent readiness against HunyuanOCR 1.5's 56.6 (C), and leads in 2 of 4 scored categories. HunyuanOCR 1.5 leads on agent interface.
Other comparisons with HunyuanOCR 1.5 or Surya OCR 2.5
- Nemotron 3.5 Parse vs Surya OCR 2.5
- Chandra OCR 2 vs HunyuanOCR 1.5
- Chandra OCR 2 vs Surya OCR 2.5
- DeepSeek-OCR 2 vs HunyuanOCR 1.5
- DeepSeek-OCR 2 vs Surya OCR 2.5
- HunyuanOCR 1.5 vs LightOnOCR-3-4B
- HunyuanOCR 1.5 vs Nanonets-OCR2-3B
- HunyuanOCR 1.5 vs Nemotron 3.5 Parse
- HunyuanOCR 1.5 vs Baidu Unlimited-OCR-2
- HunyuanOCR 1.5 vs Xiaomi-OCR-0
- LightOnOCR-3-4B vs Surya OCR 2.5
- Nanonets-OCR2-3B vs Surya OCR 2.5
- Surya OCR 2.5 vs Baidu Unlimited-OCR-2
- Surya OCR 2.5 vs Xiaomi-OCR-0
Machine-readable
- This page as Markdown
/compare/hunyuanocr-vs-surya-ocr-2-5.md· slim.min.md· JSON.json(or sendAccept: text/markdown) - Each listing in full
/api/v1/tools/hunyuanocr.json·/api/v1/tools/surya-ocr-2-5.json - From a terminal
anchor compare hunyuanocr surya-ocr-2-5(the CLI) - Over MCP
compare_tools {"a": "hunyuanocr", "b": "surya-ocr-2-5"}at/mcp, no key