Instructions to use docling-project/SmolDocling-256M-preview with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use docling-project/SmolDocling-256M-preview with Transformers:

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

pipe = pipeline("image-text-to-text", model="docling-project/SmolDocling-256M-preview")
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("docling-project/SmolDocling-256M-preview")
model = AutoModelForMultimodalLM.from_pretrained("docling-project/SmolDocling-256M-preview", 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

vLLM

How to use docling-project/SmolDocling-256M-preview with vLLM:

Install from pip and serve model

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

SGLang

How to use docling-project/SmolDocling-256M-preview 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 "docling-project/SmolDocling-256M-preview" \
    --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": "docling-project/SmolDocling-256M-preview",
		"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 "docling-project/SmolDocling-256M-preview" \
        --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": "docling-project/SmolDocling-256M-preview",
		"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 docling-project/SmolDocling-256M-preview with Docker Model Runner:
```
docker model run hf.co/docling-project/SmolDocling-256M-preview
```

Issue with AutoProcessor for ds4sd/SmolDocling-256M-preview

by dr-red - opened Mar 17, 2025

Discussion

dr-red

Mar 17, 2025

I’m trying to load the processor for ds4sd/SmolDocling-256M-preview using AutoProcessor, but I encounter the following error:
Code:

from transformers import AutoProcessor
processor = AutoProcessor.from_pretrained("ds4sd/SmolDocling-256M-preview")

Error:

ValueError: Unrecognized processing class in ds4sd/SmolDocling-256M-preview. Can't instantiate a processor, a tokenizer, an image processor or a feature extractor for this model. Make sure the repository contains the files of at least one of those processing classes.

How can I fix it?

asnassar

Docling org Mar 17, 2025

I don't know how you're getting this error unless you have an empty directory maybe at the path you are on. This definitely works, check the demo https://huggingface.co/spaces/ds4sd/SmolDocling-256M-Demo

asnassar changed discussion status to closed Mar 17, 2025

Shadokado

Mar 19, 2025

I’m trying to load the processor for ds4sd/SmolDocling-256M-preview using AutoProcessor, but I encounter the following error:
Code:

from transformers import AutoProcessor
processor = AutoProcessor.from_pretrained("ds4sd/SmolDocling-256M-preview")

Error:

ValueError: Unrecognized processing class in ds4sd/SmolDocling-256M-preview. Can't instantiate a processor, a tokenizer, an image processor or a feature extractor for this model. Make sure the repository contains the files of at least one of those processing classes.

How can I fix it?

Hi man, same problem here, did you succeed in the last 48h ? :D

asnassar

Docling org Mar 19, 2025

Which transformers version are you on? I see same problem on different models: https://huggingface.co/jadechoghari/vfusion3d/discussions/7

TrevorJS

Mar 19, 2025

@Shadokado Check to see if you have the primary docling package installed. If so it will pin your transformers version below the required version for this model.

TrevorJS

Mar 19, 2025

@dr-red oh sorry, you too ^^

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