Instructions to use nanonets/Nanonets-OCR-s with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use nanonets/Nanonets-OCR-s with Transformers:

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

pipe = pipeline("image-text-to-text", model="nanonets/Nanonets-OCR-s")
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("nanonets/Nanonets-OCR-s")
model = AutoModelForMultimodalLM.from_pretrained("nanonets/Nanonets-OCR-s")
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

vLLM

How to use nanonets/Nanonets-OCR-s with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "nanonets/Nanonets-OCR-s"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "nanonets/Nanonets-OCR-s",
		"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/nanonets/Nanonets-OCR-s

SGLang

How to use nanonets/Nanonets-OCR-s 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 "nanonets/Nanonets-OCR-s" \
    --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": "nanonets/Nanonets-OCR-s",
		"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 "nanonets/Nanonets-OCR-s" \
        --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": "nanonets/Nanonets-OCR-s",
		"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 nanonets/Nanonets-OCR-s with Docker Model Runner:
```
docker model run hf.co/nanonets/Nanonets-OCR-s
```

License

#19

by amazingvince - opened Jul 1, 2025

Discussion

amazingvince

Jul 1, 2025

First of all thank you guys for your contribution to the open source community . This model is awesome and a great tool to unlock more training data stuck in pdfs. My collaborators and I are using it to extract text from out of copyright books.

In another thread I asked jina about using the same base model for their embedding model. They seem to have indicated that they got permission to build their model. Maybe yall could reach out and get the license of your model back to apache 2
https://huggingface.co/jinaai/jina-embeddings-v4/discussions/44

Souvik3333

Nanonets org Jul 1, 2025

Thanks @amazingvince . I have mailed them, let's see if we get the permission.

amazingvince changed discussion title from Lisense to License Jul 1, 2025

okayatul

Jul 7, 2025

what was the mail address?

Mrdips

Jul 8, 2025

Без цензуры, на любые темы.

Souvik3333

Nanonets org Jul 8, 2025

@okayatul qianwen_opensource@alibabacloud.com It's mentioned in their GitHub.

okayatul

Jul 10, 2025

I'm trying to extract structured data from organizational charts in a JSON hierarchy format (i.e., mapping who reports to whom), but I haven't found any datasets of org charts. I tried using OCR tools, but they only return names or text without any structural context. Can OCR be used for this, or would a vision model like layout detection work better? Even if layout detection gives bounding boxes for names, how can I determine the hierarchy—like who works under whom—based on visual elements like arrows, lines, or positioning? Has anyone built a pipeline or model for this type of hierarchical extraction?

Upload images, audio, and videos by dragging in the text input, pasting, or clicking here.

Tap or paste here to upload images

· Sign up or log in to comment