📖 ArXiv │ 📀 CoT Dataset │ 📀 RL Dataset │ 🤗 Models
- [2025/09/19] Our paper has been accepted to NeurIPS 2025 🎉!
- [2025/06/01] We released our 3B Models (🤗VideoRFT-SFT-3B and 🤗VideoRFT-3B) to huggingface.
- [2025/05/25] We released our 7B Models (🤗VideoRFT-SFT-7B and 🤗VideoRFT-7B) to huggingface.
- [2025/05/20] We released our Datasets (📀CoT Dataset and 📀RL Dataset) to huggingface.
- [2025/05/18] Our paper is released on ArXiv, and we have open-sourced our code on GitHub!
Reinforcement fine-tuning (RFT) has shown great promise in achieving humanlevel reasoning capabilities of Large Language Models (LLMs), and has recently been extended to MLLMs. Nevertheless, reasoning about videos, which is a fundamental aspect of human intelligence, remains a persistent challenge due to the complex logic, temporal and causal structures inherent in video data. To fill this gap, we propose
To overcome the scarcity of video CoTs, we develop a scalable, cognitively inspired pipeline for high-quality video CoT dataset construction.
To further strength the RL phase, we introduce a novel semantic-consistency reward that explicitly promotes the alignment between textual reasoning with visual evidence.
Based on above pipeline, we construct two large-scale datasets, i.e., 📀VideoRFT-CoT-102K and 📀VideoRFT-RL-310K.
Python >= 3.11Pytorch >= 2.5.1transformers == 4.51.3vLLM == 0.7.3trl == 0.16.0
git clone https://github.com/QiWang98/VideoRFT
cd VideoRFT
# Create and activate environment
conda create -n VideoRFT python=3.11
conda activate VideoRFT
bash setup.sh
# Install decord for improved video processing
cd src/qwen-vl-utils
pip install -e .[decord]We begin with supervised fine-tuning on the VideoRFT-CoT dataset for one epoch:
bash ./src/scripts/run_sft_video.shThis step can be skipped by directly using our pretrained SFT models, available at 🤗VideoRFT-SFT-7B or 🤗VideoRFT-SFT-3B.
Next, perform reinforcement learning using the VideoRFT-RL dataset:
bash ./src/scripts/run_grpo_video.shTo enable faster training via vLLM acceleration:
bash ./src/scripts/run_grpo_vllm_qwen25vl.shNote: During training, we adopt the following settings for efficiency:
- VIDEO PIXELS: 128 × 28 × 28
- FPS FRAMES: 16
All frame-related configurations can be adjusted in src/qwen-vl-utils.
During inference, we increase the maximum frame resolution and length to boost performance:
- VIDEO PIXELS: 256 × 28 × 28
- FPS FRAMES: 32
You can configure these parameters in src/qwen-vl-utils.
We evaluate all models under a unified decoding configuration following the official Qwen2.5-VL demo:
top_p = 0.001temperature = 0.01
-
Download preprocessed evaluation JSONs from: [🤗 eval]
-
Download the video data from the official sites of each benchmark and organize them as specified in the JSON files.
-
Run the evaluation across all benchmarks:
bash ./src/eval_bench.shWe gratefully acknowledge the contributions of the open-source community, particularly DeepSeek-R1, Open-R1, and R1-V.
If you find this work helpful, please consider citing:
@article{VideoRFT,
title={VideoRFT: Incentivizing Video Reasoning Capability in MLLMs via Reinforced Fine-Tuning},
author={Wang, Qi and Yu, Yanrui and Yuan, Ye and Mao, Rui and Zhou, Tianfei},
booktitle={NeurIPS},
year={2025}
}



