Add pipeline tag and library name
#1
by
nielsr
HF Staff
- opened
README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
|
|
|
|
|
|
| 3 |
---
|
| 4 |
|
| 5 |
<div align="center">
|
|
@@ -20,6 +22,8 @@ license: apache-2.0
|
|
| 20 |
|
| 21 |
**STEP3-VL-10B** is a lightweight open-source foundation model designed to redefine the trade-off between compact efficiency and frontier-level multimodal intelligence. Despite its compact **10B parameter footprint**, STEP3-VL-10B excels in **visual perception**, **complex reasoning**, and **human-centric alignment**. It consistently outperforms models under the 10B scale and rivals or surpasses significantly larger open-weights models (**10Γβ20Γ its size**), such as GLM-4.6V (106B-A12B), Qwen3-VL-Thinking (235B-A22B), and top-tier proprietary flagships like Gemini 2.5 Pro and Seed-1.5-VL.
|
| 22 |
|
|
|
|
|
|
|
| 23 |
<div align="center">
|
| 24 |
<img src="figures/performance.png" alt="Performance Comparison" width="800"/>
|
| 25 |
<p><i>Figure 1: Performance comparison of STEP3-VL-10B against SOTA multimodal foundation models. SeRe: Sequential Reasoning; PaCoRe: Parallel Coordinated Reasoning.</i></p>
|
|
@@ -27,8 +31,8 @@ license: apache-2.0
|
|
| 27 |
|
| 28 |
The success of STEP3-VL-10B is driven by two key strategic designs:
|
| 29 |
|
| 30 |
-
1. **Unified Pre-training on High-Quality Multimodal Corpus:** A single-stage, fully unfrozen training strategy on a 1.2T token multimodal corpus, focusing on two foundational capabilities: **reasoning**
|
| 31 |
-
2. **Scaled Multimodal Reinforcement Learning and Parallel Reasoning:** Frontier capabilities are unlocked through a rigorous post-training pipeline comprising two-stage supervised finetuning (SFT) and **over 1,400 iterations of RL
|
| 32 |
|
| 33 |
## π₯ Model Zoo
|
| 34 |
|
|
@@ -55,42 +59,11 @@ STEP3-VL-10B delivers best-in-class performance across major multimodal benchmar
|
|
| 55 |
| **HMMT 2025** | 78.18 | **92.14** | 57.29 | 67.71 | 65.68 | 51.30 |
|
| 56 |
| **LiveCodeBench** | 75.77 | **76.43** | 48.71 | 69.45 | 72.01 | 57.10 |
|
| 57 |
|
| 58 |
-
<!-- > **Note:** **SeRe** (Sequential Reasoning) uses a max length of 64K tokens; **PaCoRe** (Parallel Coordinated Reasoning) synthesizes 16 SeRe rollouts with a max length of 128K tokens. -->
|
| 59 |
-
|
| 60 |
> **Note on Inference Modes:**
|
| 61 |
>
|
| 62 |
> **SeRe (Sequential Reasoning):** The standard inference mode using sequential generation (Chain-of-Thought) with a max length of 64K tokens.
|
| 63 |
>
|
| 64 |
-
> **PaCoRe (Parallel Coordinated Reasoning):** An advanced mode that scales test-time compute. It aggregates evidence from **16 parallel rollouts** to synthesize a final answer
|
| 65 |
-
>
|
| 66 |
-
> _Unless otherwise stated, scores below refer to the standard SeRe mode. Higher scores achieved via PaCoRe are explicitly marked._
|
| 67 |
-
|
| 68 |
-
### Comparison with Open-Source Models (7Bβ10B)
|
| 69 |
-
|
| 70 |
-
| Category | Benchmark | STEP3-VL-10B | GLM-4.6V-Flash (9B) | Qwen3-VL-Thinking (8B) | InternVL-3.5 (8B) | MiMo-VL-RL-2508 (7B) |
|
| 71 |
-
| :----------------- | :--------------- | :----------: | :-----------------: | :--------------------: | :---------------: | :------------------: |
|
| 72 |
-
| **STEM Reasoning** | MMMU | **78.11** | 71.17 | 73.53 | 71.69 | 71.14 |
|
| 73 |
-
| | MathVision | **70.81** | 54.05 | 59.60 | 52.05 | 59.65 |
|
| 74 |
-
| | MathVista | **83.97** | 82.85 | 78.50 | 76.78 | 79.86 |
|
| 75 |
-
| | PhyX | **59.45** | 52.28 | 57.67 | 50.51 | 56.00 |
|
| 76 |
-
| **Recognition** | MMBench (EN) | **92.05** | 91.04 | 90.55 | 88.20 | 89.91 |
|
| 77 |
-
| | MMStar | **77.48** | 74.26 | 73.58 | 69.83 | 72.93 |
|
| 78 |
-
| | ReMI | **67.29** | 60.75 | 57.17 | 52.65 | 63.13 |
|
| 79 |
-
| **OCR & Document** | OCRBench | **86.75** | 85.97 | 82.85 | 83.70 | 85.40 |
|
| 80 |
-
| | AI2D | **89.35** | 88.93 | 83.32 | 82.34 | 84.96 |
|
| 81 |
-
| **GUI Grounding** | ScreenSpot-V2 | 92.61 | 92.14 | **93.60** | 84.02 | 90.82 |
|
| 82 |
-
| | ScreenSpot-Pro | **51.55** | 45.68 | 46.60 | 15.39 | 34.84 |
|
| 83 |
-
| | OSWorld-G | **59.02** | 54.71 | 56.70 | 31.91 | 50.54 |
|
| 84 |
-
| **Spatial** | BLINK | **66.79** | 64.90 | 62.78 | 55.40 | 62.57 |
|
| 85 |
-
| | All-Angles-Bench | **57.21** | 53.24 | 45.88 | 45.29 | 51.62 |
|
| 86 |
-
| **Code** | HumanEval-V | **66.05** | 29.26 | 26.94 | 24.31 | 31.96 |
|
| 87 |
-
|
| 88 |
-
### Key Capabilities
|
| 89 |
-
|
| 90 |
-
- **STEM Reasoning:** Achieves **94.43%** on AIME 2025 and **75.95%** on MathVision (with PaCoRe), demonstrating exceptional complex reasoning capabilities that outperform models 10Γβ20Γ larger.
|
| 91 |
-
- **Visual Perception:** Records **92.05%** on MMBench and **80.11%** on MMMU, establishing strong general visual understanding and multimodal reasoning.
|
| 92 |
-
- **GUI & OCR:** Delivers state-of-the-art performance on ScreenSpot-V2 (**92.61%**), ScreenSpot-Pro (**51.55%**), and OCRBench (**86.75%**), optimized for agentic and document understanding tasks.
|
| 93 |
-
- **Spatial Understanding:** Demonstrates emergent spatial awareness with **66.79%** on BLINK and **57.21%** on All-Angles-Bench, establishing strong potential for embodied intelligence applications.
|
| 94 |
|
| 95 |
## ποΈ Architecture & Training
|
| 96 |
|
|
@@ -101,24 +74,11 @@ STEP3-VL-10B delivers best-in-class performance across major multimodal benchmar
|
|
| 101 |
- **Projector:** Two consecutive stride-2 layers (resulting in 16Γ spatial downsampling).
|
| 102 |
- **Resolution:** Multi-crop strategy consisting of a 728Γ728 global view and multiple 504Γ504 local crops.
|
| 103 |
|
| 104 |
-
### Training Pipeline
|
| 105 |
-
|
| 106 |
-
- **Pre-training:** Single-stage, fully unfrozen strategy using AdamW optimizer (Total: 1.2T tokens, 370K iterations).
|
| 107 |
-
- Phase 1: 900B tokens.
|
| 108 |
-
- Phase 2: 300B tokens.
|
| 109 |
-
- **Supervised Finetuning (SFT):** Two-stage approach (Total: ~226B tokens).
|
| 110 |
-
- Stage 1: 9:1 text-to-multimodal ratio (~190B tokens).
|
| 111 |
-
- Stage 2: 1:1 text-to-multimodal ratio (~36B tokens).
|
| 112 |
-
- **Reinforcement Learning:** Total >1,400 iterations.
|
| 113 |
-
- **RLVR:** 600 iterations (Tasks: mathematics, geometry, physics, perception, grounding).
|
| 114 |
-
- **RLHF:** 300 iterations (Task: open-ended generation).
|
| 115 |
-
- **PaCoRe Training:** 500 iterations (Context length: 64K max sequence).
|
| 116 |
-
|
| 117 |
## π οΈ Quick Start
|
| 118 |
|
| 119 |
### Inference with Hugging Face Transformers
|
| 120 |
|
| 121 |
-
We introduce how to use our model at inference stage using transformers library. It is recommended to use python=3.10, torch>=2.1.0, and transformers=4.57.0 as the development environment.
|
| 122 |
|
| 123 |
```python
|
| 124 |
from transformers import AutoProcessor, AutoModelForCausalLM
|
|
@@ -130,7 +90,7 @@ key_mapping = {
|
|
| 130 |
"vit_large_projector": "model.vit_large_projector",
|
| 131 |
}
|
| 132 |
|
| 133 |
-
model_path = "stepfun-ai/Step3-VL-10B
|
| 134 |
|
| 135 |
processor = AutoProcessor.from_pretrained(model_path, trust_remote_code=True)
|
| 136 |
|
|
@@ -182,4 +142,4 @@ If you find this project useful in your research, please cite our technical repo
|
|
| 182 |
|
| 183 |
## π License
|
| 184 |
|
| 185 |
-
This project is open-sourced under the [Apache 2.0 License](https://www.google.com/search?q=LICENSE).
|
|
|
|
| 1 |
---
|
| 2 |
license: apache-2.0
|
| 3 |
+
library_name: transformers
|
| 4 |
+
pipeline_tag: image-text-to-text
|
| 5 |
---
|
| 6 |
|
| 7 |
<div align="center">
|
|
|
|
| 22 |
|
| 23 |
**STEP3-VL-10B** is a lightweight open-source foundation model designed to redefine the trade-off between compact efficiency and frontier-level multimodal intelligence. Despite its compact **10B parameter footprint**, STEP3-VL-10B excels in **visual perception**, **complex reasoning**, and **human-centric alignment**. It consistently outperforms models under the 10B scale and rivals or surpasses significantly larger open-weights models (**10Γβ20Γ its size**), such as GLM-4.6V (106B-A12B), Qwen3-VL-Thinking (235B-A22B), and top-tier proprietary flagships like Gemini 2.5 Pro and Seed-1.5-VL.
|
| 24 |
|
| 25 |
+
The model was presented in the paper [STEP3-VL-10B Technical Report](https://huggingface.co/papers/2601.09668).
|
| 26 |
+
|
| 27 |
<div align="center">
|
| 28 |
<img src="figures/performance.png" alt="Performance Comparison" width="800"/>
|
| 29 |
<p><i>Figure 1: Performance comparison of STEP3-VL-10B against SOTA multimodal foundation models. SeRe: Sequential Reasoning; PaCoRe: Parallel Coordinated Reasoning.</i></p>
|
|
|
|
| 31 |
|
| 32 |
The success of STEP3-VL-10B is driven by two key strategic designs:
|
| 33 |
|
| 34 |
+
1. **Unified Pre-training on High-Quality Multimodal Corpus:** A single-stage, fully unfrozen training strategy on a 1.2T token multimodal corpus, focusing on two foundational capabilities: **reasoning** and **perception**. By jointly optimizing the Perception Encoder and the Qwen3-8B decoder, STEP3-VL-10B establishes intrinsic vision-language synergy.
|
| 35 |
+
2. **Scaled Multimodal Reinforcement Learning and Parallel Reasoning:** Frontier capabilities are unlocked through a rigorous post-training pipeline comprising two-stage supervised finetuning (SFT) and **over 1,400 iterations of RL**. Beyond sequential reasoning, we adopt **Parallel Coordinated Reasoning (PaCoRe)**, which allocates test-time compute to aggregate evidence from parallel visual exploration.
|
| 36 |
|
| 37 |
## π₯ Model Zoo
|
| 38 |
|
|
|
|
| 59 |
| **HMMT 2025** | 78.18 | **92.14** | 57.29 | 67.71 | 65.68 | 51.30 |
|
| 60 |
| **LiveCodeBench** | 75.77 | **76.43** | 48.71 | 69.45 | 72.01 | 57.10 |
|
| 61 |
|
|
|
|
|
|
|
| 62 |
> **Note on Inference Modes:**
|
| 63 |
>
|
| 64 |
> **SeRe (Sequential Reasoning):** The standard inference mode using sequential generation (Chain-of-Thought) with a max length of 64K tokens.
|
| 65 |
>
|
| 66 |
+
> **PaCoRe (Parallel Coordinated Reasoning):** An advanced mode that scales test-time compute. It aggregates evidence from **16 parallel rollouts** to synthesize a final answer.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 67 |
|
| 68 |
## ποΈ Architecture & Training
|
| 69 |
|
|
|
|
| 74 |
- **Projector:** Two consecutive stride-2 layers (resulting in 16Γ spatial downsampling).
|
| 75 |
- **Resolution:** Multi-crop strategy consisting of a 728Γ728 global view and multiple 504Γ504 local crops.
|
| 76 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 77 |
## π οΈ Quick Start
|
| 78 |
|
| 79 |
### Inference with Hugging Face Transformers
|
| 80 |
|
| 81 |
+
We introduce how to use our model at inference stage using transformers library. It is recommended to use python=3.10, torch>=2.1.0, and transformers=4.57.0 as the development environment.
|
| 82 |
|
| 83 |
```python
|
| 84 |
from transformers import AutoProcessor, AutoModelForCausalLM
|
|
|
|
| 90 |
"vit_large_projector": "model.vit_large_projector",
|
| 91 |
}
|
| 92 |
|
| 93 |
+
model_path = "stepfun-ai/Step3-VL-10B"
|
| 94 |
|
| 95 |
processor = AutoProcessor.from_pretrained(model_path, trust_remote_code=True)
|
| 96 |
|
|
|
|
| 142 |
|
| 143 |
## π License
|
| 144 |
|
| 145 |
+
This project is open-sourced under the [Apache 2.0 License](https://www.google.com/search?q=LICENSE).
|