Instructions to use OpenGVLab/InternVL2-1B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use OpenGVLab/InternVL2-1B with Transformers:

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

pipe = pipeline("image-text-to-text", model="OpenGVLab/InternVL2-1B", 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("OpenGVLab/InternVL2-1B", trust_remote_code=True, dtype="auto")

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use OpenGVLab/InternVL2-1B with vLLM:

Install from pip and serve model

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

SGLang

How to use OpenGVLab/InternVL2-1B 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 "OpenGVLab/InternVL2-1B" \
    --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": "OpenGVLab/InternVL2-1B",
		"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 "OpenGVLab/InternVL2-1B" \
        --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": "OpenGVLab/InternVL2-1B",
		"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 OpenGVLab/InternVL2-1B with Docker Model Runner:
```
docker model run hf.co/OpenGVLab/InternVL2-1B
```

InternVL2-1B

Commit History

Make modeling_internvl_chat.py compatible with transformers v5

68196e7
verified

tengomucho HF Staff commited on 21 days ago

Add supports_gradient_checkpointing

0d75ccd
verified

czczup commited on Mar 25, 2025

Fix device_map

c7f0265
verified

czczup commited on Feb 5, 2025

Update README.md

3bc2e85
verified

czczup commited on Dec 18, 2024

Update README.md

8893062
verified

czczup commited on Dec 9, 2024

Apply Github PR #127 to all HF models

f40da88
verified

czczup commited on Dec 8, 2024

Update README.md

adc496f
verified

czczup commited on Dec 8, 2024

Update README.md

ddd8af5
verified

czczup commited on Dec 7, 2024

fix compatibility issue for transformers 4.46+

b5e11b0
verified

czczup commited on Dec 6, 2024

Update README.md

988ea31
verified

zwgao commited on Dec 4, 2024

Update README.md

4738f7f
verified

zwgao commited on Dec 4, 2024

fix compatibility issue for transformers 4.46+

e426377
verified

czczup commited on Nov 21, 2024

fix compatibility issue for transformers 4.46+

9ed07ff
verified

czczup commited on Nov 21, 2024

fix compatibility issue for transformers 4.46+

8d83190
verified

czczup commited on Nov 21, 2024

fix compatibility issue for transformers 4.46+

0284e5f
verified

czczup commited on Nov 21, 2024

fix config saving compatibility issue for transformers 4.45+ (#7)

18c8446
verified

czczup

katuni4ka commited on Nov 21, 2024