tencent
/

HunyuanOCR

Image-Text-to-Text

vision-language-model

document-parsing

information-extraction

text-image-translation

Model card Files Files and versions

Instructions to use tencent/HunyuanOCR with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use tencent/HunyuanOCR with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("image-text-to-text", model="tencent/HunyuanOCR")
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
pipe(text=messages)

# Load model directly
from transformers import AutoProcessor, AutoModelForMultimodalLM

processor = AutoProcessor.from_pretrained("tencent/HunyuanOCR")
model = AutoModelForMultimodalLM.from_pretrained("tencent/HunyuanOCR", device_map="auto")
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
inputs = processor.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=40)
print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

Notebooks
Google Colab
Kaggle
Local Apps Settings

How to use tencent/HunyuanOCR with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "tencent/HunyuanOCR"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "tencent/HunyuanOCR",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Use Docker

docker model run hf.co/tencent/HunyuanOCR

How to use tencent/HunyuanOCR with SGLang:

Install from pip and serve model

# Install SGLang from pip:
pip install sglang
# Start the SGLang server:
python3 -m sglang.launch_server \
    --model-path "tencent/HunyuanOCR" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "tencent/HunyuanOCR",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Use Docker images

docker run --gpus all \
    --shm-size 32g \
    -p 30000:30000 \
    -v ~/.cache/huggingface:/root/.cache/huggingface \
    --env "HF_TOKEN=<secret>" \
    --ipc=host \
    lmsysorg/sglang:latest \
    python3 -m sglang.launch_server \
        --model-path "tencent/HunyuanOCR" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "tencent/HunyuanOCR",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Docker Model Runner
How to use tencent/HunyuanOCR with Docker Model Runner:
```
docker model run hf.co/tencent/HunyuanOCR
```

HunyuanOCR / README.md

Commit History

README: drop preview notices; scope default OCR prompt to document parsing

3e68ee6
verified

EthannW commited on Jul 6

README: 1.0/1.5 layout note; scope default OCR prompt to document parsing (#31)

6503295

EthannW commited on Jul 6

Add HunyuanOCR-1.5 (target at root, DFlash under dflash/, archive 1.0 under v1.0/) (#30)

01b3ec8

EthannW commited on Jul 6

Update README (#26)

f6af82e
verified

EthannW commited on Jan 13

update README.md (#22)

987eba7
verified

EthannW commited on Dec 2, 2025

Update README (#15)

1ab3786
verified

EthannW commited on Nov 27, 2025

Update README (#14)

06f6dc1
verified

EthannW commited on Nov 27, 2025

Update README (#11)

9a0c818
verified

EthannW commited on Nov 26, 2025

update README (#8)

e268223
verified

EthannW commited on Nov 26, 2025

Update README.md (#7)

e412ba1
verified

EthannW commited on Nov 26, 2025

Update README (#6)

7502740
verified

EthannW commited on Nov 26, 2025

Update README (#5)

7d53690
verified

EthannW commited on Nov 26, 2025

Update README.md

885259f
verified

manaestras commited on Nov 25, 2025

Update README.md

d420772
verified

manaestras commited on Nov 25, 2025

Change Title link (#2)

ea397eb
verified

EthannW commited on Nov 25, 2025

Update README (#1)

b28a172
verified

EthannW commited on Nov 25, 2025

Update README.md

c3bf532
verified

manaestras commited on Nov 25, 2025

Update README.md

5bf2a1f
verified

manaestras commited on Nov 25, 2025

Update README.md

4be5a16
verified

manaestras commited on Nov 24, 2025

Update README.md

e6bffef
verified

manaestras commited on Nov 24, 2025

Update README.md

8ffabbf
verified

manaestras commited on Nov 24, 2025

Update README.md

95b9278
verified

manaestras commited on Nov 24, 2025

Update README.md

1ff0d18
verified

manaestras commited on Nov 24, 2025

Update README.md

45f0473
verified

manaestras commited on Nov 24, 2025

Update README.md

eb4cfe8
verified

manaestras commited on Nov 24, 2025

Create README.md

7b81346
verified

manaestras commited on Nov 24, 2025