Instructions to use 5CD-AI/Vintern-3B-beta with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use 5CD-AI/Vintern-3B-beta with Transformers:

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

pipe = pipeline("image-text-to-text", model="5CD-AI/Vintern-3B-beta", trust_remote_code=True)
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 AutoModel
model = AutoModel.from_pretrained("5CD-AI/Vintern-3B-beta", trust_remote_code=True, dtype="auto")

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use 5CD-AI/Vintern-3B-beta with vLLM:

Install from pip and serve model

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

SGLang

How to use 5CD-AI/Vintern-3B-beta 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 "5CD-AI/Vintern-3B-beta" \
    --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": "5CD-AI/Vintern-3B-beta",
		"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 "5CD-AI/Vintern-3B-beta" \
        --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": "5CD-AI/Vintern-3B-beta",
		"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 5CD-AI/Vintern-3B-beta with Docker Model Runner:
```
docker model run hf.co/5CD-AI/Vintern-3B-beta
```

Help me fix architectures config error while using model

by Vuthuy6586 - opened Jun 13, 2025

Discussion

Vuthuy6586

Jun 13, 2025

Hi bạn,
Mình sử dụng mô hình theo code bạn cung cấp, khi chạy thì có báo lỗi như sau, mình đã thử nhiều cách nhưng không biết cách sửa, không biết bạn có biết vấn đề này không :
File "/home/thuyvu/app_crawl_image/venv/lib/python3.12/site-packages/transformers/models/auto/auto_factory.py", line 531, in from_pretrained
config, kwargs = AutoConfig.from_pretrained(
^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/thuyvu/app_crawl_image/venv/lib/python3.12/site-packages/transformers/models/auto/configuration_auto.py", line 1167, in from_pretrained
return config_class.from_pretrained(pretrained_model_name_or_path, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/thuyvu/app_crawl_image/venv/lib/python3.12/site-packages/transformers/configuration_utils.py", line 573, in from_pretrained
return cls.from_dict(config_dict, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/home/thuyvu/app_crawl_image/venv/lib/python3.12/site-packages/transformers/configuration_utils.py", line 770, in from_dict
logger.info(f"Model config {config}")
^^^^^^^^
File "/home/thuyvu/app_crawl_image/venv/lib/python3.12/site-packages/transformers/configuration_utils.py", line 802, in repr
return f"{self.class.name} {self.to_json_string()}"
^^^^^^^^^^^^^^^^^^^^^
File "/home/thuyvu/app_crawl_image/venv/lib/python3.12/site-packages/transformers/configuration_utils.py", line 914, in to_json_string
config_dict = self.to_diff_dict()
^^^^^^^^^^^^^^^^^^^
File "/home/thuyvu/app_crawl_image/venv/lib/python3.12/site-packages/transformers/configuration_utils.py", line 822, in to_diff_dict
class_config_dict = self.class().to_dict() if not self.has_no_defaults_at_init else {}
^^^^^^^^^^^^^^^^
File "/home/thuyvu/.cache/huggingface/modules/transformers_modules/5CD-AI/Vintern-1B-v2/c3f01cf5b55816c092fb493babc672b0dc33c8bc/configuration_internvl_chat.py", line 49, in init
if llm_config['architectures'][0] == 'LlamaForCausalLM':
~~~~~~~~~~^^^^^^^^^^^^^^^^^
KeyError: 'architectures'

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