Instructions to use baidu/Unlimited-OCR with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use baidu/Unlimited-OCR with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("image-text-to-text", model="baidu/Unlimited-OCR", trust_remote_code=True)# Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("baidu/Unlimited-OCR", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use baidu/Unlimited-OCR with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "baidu/Unlimited-OCR" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "baidu/Unlimited-OCR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/baidu/Unlimited-OCR
- SGLang
How to use baidu/Unlimited-OCR 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 "baidu/Unlimited-OCR" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "baidu/Unlimited-OCR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'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 "baidu/Unlimited-OCR" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "baidu/Unlimited-OCR", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use baidu/Unlimited-OCR with Docker Model Runner:
docker model run hf.co/baidu/Unlimited-OCR
Feature Request: Option to Disable Post-Processing and Preserve Detection Tags
Hi,
I'm using Unlimited-OCR for document parsing and have noticed that the generated Markdown output is already post-processed. It appears that functions such as remove_det() (or similar post-processing) strip the original detection tags before the results are written to the output file.
Currently, the output is plain Markdown/text, for example:
Introduction
This is the first paragraph...
However, I need access to the original structural predictions from the model, such as:
<|det|>title<|/det|>Introduction
<|det|>text<|/det|>This is the first paragraph...
<|det|>table<|/det|>| Col1 | Col2 |
Having these tags would allow me to distinguish titles, headings, body text, tables, captions, formulas, and other document elements so I can perform my own custom post-processing and generate Markdown according to my application's requirements.
Would it be possible to add an option such as:
model.infer_multi(
...,
save_raw_output=True, # Save output before remove_det()/post-processing
)
or
model.infer_multi(
...,
post_process=False
)
This could save the raw decoder output (including the <|det|> tags) alongside the existing processed Markdown output.
This feature would be very useful for downstream applications that require document structure information instead of only flattened text.
Thank you!
This will be available in the native transformers implementation: https://github.com/huggingface/transformers/pull/46836