Instructions to use lmms-lab/LLaVA-OneVision-1.5-8B-Instruct with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use lmms-lab/LLaVA-OneVision-1.5-8B-Instruct with Transformers:

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

pipe = pipeline("image-text-to-text", model="lmms-lab/LLaVA-OneVision-1.5-8B-Instruct", 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("lmms-lab/LLaVA-OneVision-1.5-8B-Instruct", trust_remote_code=True, dtype="auto")

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use lmms-lab/LLaVA-OneVision-1.5-8B-Instruct with vLLM:

Install from pip and serve model

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

SGLang

How to use lmms-lab/LLaVA-OneVision-1.5-8B-Instruct 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 "lmms-lab/LLaVA-OneVision-1.5-8B-Instruct" \
    --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": "lmms-lab/LLaVA-OneVision-1.5-8B-Instruct",
		"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 "lmms-lab/LLaVA-OneVision-1.5-8B-Instruct" \
        --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": "lmms-lab/LLaVA-OneVision-1.5-8B-Instruct",
		"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 lmms-lab/LLaVA-OneVision-1.5-8B-Instruct with Docker Model Runner:
```
docker model run hf.co/lmms-lab/LLaVA-OneVision-1.5-8B-Instruct
```

LLaVA-OneVision-1.5-8B-Instruct

Commit History

Update README.md

bdf9518
verified

xiangan commited on Oct 21, 2025

Update README.md

9072dbf
verified

xiangan commited on Oct 21, 2025

Update README.md

ae3e394
verified

xiangan commited on Oct 21, 2025

Update README.md

80719a5
verified

xiangan commited on Oct 21, 2025

Update README.md

75a1758
verified

xiangan commited on Oct 21, 2025

Update README.md

59bcd19
verified

xiangan commited on Oct 21, 2025

Update README.md

35f4ece
verified

xiangan commited on Oct 21, 2025

Delete .gitattributes

2e2c9d4
verified

Yiye commited on Oct 14, 2025

Upload folder using huggingface_hub

9f0f75e
verified

Yiye commited on Oct 14, 2025

Update README.md

ae3f2e6
verified

xiangan commited on Oct 5, 2025

Update README.md

746e144
verified

xiangan commited on Oct 5, 2025

Improve model card: Add paper, project page, and code links (#3)

9206a19
verified

xiangan

nielsr HF Staff commited on Oct 5, 2025

Update README.md

491e88c
verified

Yiye commited on Sep 30, 2025

Update README.md

e6a9a0d
verified

xiangan commited on Sep 28, 2025

Update README.md

391f872
verified

xiangan commited on Sep 28, 2025

Upload 2 files

f30a35d
verified

xiangan commited on Sep 28, 2025

Update README.md

813bbd9
verified

xiangan commited on Sep 27, 2025

Update README.md

b2e3f0c
verified

xiangan commited on Sep 27, 2025