Instructions to use Skywork/Skywork-R1V3-38B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use Skywork/Skywork-R1V3-38B with Transformers:

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

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

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use Skywork/Skywork-R1V3-38B with vLLM:

Install from pip and serve model

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

SGLang

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

fakerbaby commited on Jul 14, 2025

Commit

f921e66

verified ·

1 Parent(s): e0f5026

Update README.md

Browse files

Files changed (1) hide show

README.md +2 -2

README.md CHANGED Viewed

@@ -77,7 +77,7 @@ These innovations lead to Broad Reasoning Generalization, allowing our RL-powere
 # Visual-Language Models Benchmark Comparison
-| Category       | Benchmark               | Metric  | Skywork-38B | QVQ-72B | InternVL-78B | Qwen-72B | Claude 3.7 | GPT-4o |
 |----------------|-------------------------|---------|------------:|--------:|-------------:|--------:|----------:|---------:|
 | **General**    | MMMU (val)              | Acc.    | 🏆 **76.0**   | 70.3    | 72.2         | 70.3    | 75.0      | 70.7   |
 |                | EMMA (mini-cot)         | Acc.    | 40.3       | 32.0    | 38.3         | 39.3    |  **56.5**   | 36.0   |
@@ -86,7 +86,7 @@ These innovations lead to Broad Reasoning Generalization, allowing our RL-powere
 |                | MMstar                  | Acc.    | 70.6       | 60.8    |  **72.5**     | 70.8    | 68.8      | 65.1   |
 |                | MMBench-en-1.1          | Acc.    | 85.7       | 72.6*   | 87.7         |  **88.0** | 82.0      | 84.3   |
 |                | HallusionBench          | Acc.    | 🏆 **61.3**   | 55.3*   | 59.1         | 55.2    | 58.3      | 56.2   |
-| **Mathematics**| MathVista (mini)        | Acc.    | 77.1       | 71.4    |  **79.0**      | 74.8    | 66.8      | 62.9   |
 |                | MathVerse (vision-only) | Acc.    | 🏆 **59.6**   | 45.1    | 51.0         | 57.6    | 49.9*     | 49.9   |
 |                | MathVision              | Acc.    | 52.6       | 35.9    | 43.1         | 38.1    |  58.6   | 31.2   |
 |                | WeMath (strict)          | Acc.    |🏆 **56.5**   | 37.7    | 46.1         | 50.6    | 48.9*     | 50.6   |

 # Visual-Language Models Benchmark Comparison
+| Category       | Benchmark               | Metric  | Skywork-38B | QVQ-72B | InternVL-78B | QwenVL-72B | Claude 3.7 | GPT-4o |
 |----------------|-------------------------|---------|------------:|--------:|-------------:|--------:|----------:|---------:|
 | **General**    | MMMU (val)              | Acc.    | 🏆 **76.0**   | 70.3    | 72.2         | 70.3    | 75.0      | 70.7   |
 |                | EMMA (mini-cot)         | Acc.    | 40.3       | 32.0    | 38.3         | 39.3    |  **56.5**   | 36.0   |
 |                | MMstar                  | Acc.    | 70.6       | 60.8    |  **72.5**     | 70.8    | 68.8      | 65.1   |
 |                | MMBench-en-1.1          | Acc.    | 85.7       | 72.6*   | 87.7         |  **88.0** | 82.0      | 84.3   |
 |                | HallusionBench          | Acc.    | 🏆 **61.3**   | 55.3*   | 59.1         | 55.2    | 58.3      | 56.2   |
+| **Mathematics**| MathVista (mini)        | Acc.    | 🏆 **77.1**       | 71.4    |  72.2      | 74.8    | 66.8      | 62.9   |
 |                | MathVerse (vision-only) | Acc.    | 🏆 **59.6**   | 45.1    | 51.0         | 57.6    | 49.9*     | 49.9   |
 |                | MathVision              | Acc.    | 52.6       | 35.9    | 43.1         | 38.1    |  58.6   | 31.2   |
 |                | WeMath (strict)          | Acc.    |🏆 **56.5**   | 37.7    | 46.1         | 50.6    | 48.9*     | 50.6   |