modelscope / modelscope/ms-swift
swift train ↔ vLLM rollout multimodal alignment
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 15.7k
- Forks
- 1.7k
- Avg merge
- 1d 16h
- Merged PRs (30d)
- 136
Description
Background
In on-policy RL training (GRPO / OPD / GKD), rollout and training must consume the same multimodal inputs (input_ids, pixel_values, input_features, etc.). Otherwise, logprobs are computed on mismatched prompts/tensors.
This table tracks swift train vs vLLM rollout alignment per model family. The goal is to verify parity for GRPO/OPD and to expand coverage as we add more models and modalities.
— = modality not supported.
✅ = aligned.
❌ = not aligned (tracked upstream).
Alignment results
| Model family | image | video | audio |
|---|---|---|---|
| Qwen3-VL | ✅ | ❌ | — |
| Qwen3.5 | ✅ | ❌ | — |
| Qwen2.5-Omni | ✅ | ✅ | ✅ |
| Qwen3-Omni | ✅ | ✅ | ✅ |
| Gemma4 | ✅ | ❌ | ✅ |
Known upstream issues (vLLM)
- Qwen3-VL / Qwen3.5 video — vLLM drops the outer
<|vision_start|>/<|vision_end|>wrapper during video prompt expansion, causing a 2-token mismatch vs HuggingFace: #46817 - Gemma4 video — vLLM uses a per-frame image path and incorrect video metadata/timestamps vs Transformers
Gemma4VideoProcessor: #46988
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the alignment table and the linked vLLM issues #46817 and #46988. Compare swift train and vLLM multimodal inputs for the listed model families and modalities, then update the alignment results when parity has been verified or a remaining mismatch is clearly recorded.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- machine-learning
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100