OraRL README

The project's README from github.com/HVision-NKU/OraRL. As one markdown file: README.md.

简体中文

OraRL

Annotations as Rollouts

Efficient and scalable reinforcement learning for unified video MLLMs

Yunheng Li · Guohong Mu · Hao Li · Shengsheng Qian · Dingwen Zhang · Qibin Hou · Ming-Ming Cheng

📄 Paper   ·   🌐 Project Page   ·   🎮 Live Demo   ·   🤗 Models (4B / 9B)

⚙️ Environment   ·   🚀 Training   ·   📊 Evaluation   ·   ⚖️ License

Papers with Code: SOTA on ActivityNet-TimeLens Papers with Code: SOTA on Charades-TimeLens Papers with Code: SOTA on MeViS Papers with Code: SOTA on QVHighlights-TimeLens Validation Papers with Code: SOTA on VideoHolmes Papers with Code: #2 on ReasonVOS

View all 11 verified evaluations on Papers with Code

Animated OraRL method preview

▶ Click the image to watch the 1:38 project overview.

Why OraRL

OraRL in One Update

Animated OraRL framework

An OraRL update separates reliable annotation guidance from on-policy normalization:

  1. Build the group: append one serialized annotation rollout to the policy samples generated for the same prompt.
  2. Keep the baseline on-policy: estimate the group baseline from policy rewards only.
  3. Guide and select: convert the annotation-policy reward gap into a correction, then retain a sign-balanced subset for the update.

This design uses task-native annotations directly and requires no chain-of-thought supervision or decoding.

Video-ORA Results

Video-ORA-9B results across seven task families

Dataset-Level Results

Dataset-level benchmark matrix comparing Video-ORA with multimodal baselines

Video-ORA-9B leads the matched seven-family comparison without CoT decoding. Best and second-best values are highlighted per row; † denotes an original-report value whose frame, prompt, split, or decoding settings may differ. Averages require complete family coverage.

Model Scaling

Animated Video-ORA model scaling from 0.8B to 9B

Data Scaling

Animated OraRL data scaling and reward dynamics

Models

Model Backbone Released recipe Weights
Video-ORA-9B Qwen3.5-9B orarl_9b.yaml Hugging Face
Video-ORA-4B Qwen3.5-4B orarl_4b.yaml Hugging Face

vLLM Serving

Both Video-ORA checkpoints load directly with vLLM 0.19.1 for OpenAI-compatible serving:

MODEL=OraRL/Video-ORA-9B

vllm serve "$MODEL" \
  --served-model-name Video-ORA-9B \
  --trust-remote-code \
  --dtype bfloat16 \
  --tensor-parallel-size 1 \
  --max-model-len 131072 \
  --limit-mm-per-prompt '{"image": 1, "video": 1}'

Set --tensor-parallel-size to the GPU count for multi-GPU deployment and lower --max-model-len on smaller-memory devices. Use enable_thinking=false in the chat template for answer-only inference.

Use OraRL

The release is organized around three user-facing workflows:

  1. Environment: install the pinned CUDA stack that covers both the bundled trainer and the evaluators.
  2. Training: prepare licensed local training data and launch GRPO or OraRL on one or multiple nodes.
  3. Evaluation: download Video-ORA and OraRL-Data, then run a smoke test or the complete paper suite.

Training and evaluation are dry runs by default; inspect the resolved command before adding --run. Checkpoints and evaluation media are hosted under the OraRL Hugging Face organization.

Acknowledgements

OraRL is built on veRL — a high-performance RL framework with HybridEngine. We thank its authors and contributors for open-sourcing the training infrastructure.

License

OraRL source is released under Apache-2.0. Datasets, models, benchmarks, and optional dependencies retain their original licenses; see NOTICE.

Citation

If you find OraRL useful, please consider giving this repository a ⭐ and citing our paper.

@article{li2026orarl,
  title   = {Annotations as Rollouts: Efficient and Scalable
             Reinforcement Learning for Video MLLMs},
  author  = {Li, Yunheng and Mu, Guohong and Li, Hao and
             Qian, Shengsheng and Zhang, Dingwen and Hou, Qibin
             and Cheng, Ming-Ming},
  journal = {arXiv preprint arXiv:2608.20492},
  year    = {2026},
  url     = {https://arxiv.org/abs/2608.20492}
}

OraRL (HVision-NKU/OraRL)

Searching Database…

166 ·GitHub
Что это?OraRL — фреймворк обучения с подкреплением, который рассматривает аннотации как rollout'ы, чтобы эффективно обучать единые мультимодальные LLM для видео (MLLM) на семи семействах видеозадач.
Это готовое приложение или исследовательский фреймворк для обучения?Это исследовательская кодовая база на основе veRL, включающая рецепт обучения, средства оценки и выпущенные чекпоинты Video-ORA, а не приложение «включил и работает».
Как запустить OraRL?Следуйте трём процессам: установите зафиксированный CUDA-стек для Environment, подготовьте лицензированные локальные обучающие данные и запустите GRPO или OraRL на одном или нескольких узлах, затем скачайте Video-ORA и OraRL-Data, чтобы выполнить оценку.
Что нужно, чтобы развернуть выпущенные модели?Нужны GPU с CUDA и vLLM 0.19.1, чтобы загрузить чекпоинты Video-ORA-4B/9B (на бэкбонах Qwen3.5) для инференса, совместимого с OpenAI, настроив tensor-parallel-size и max-model-len под своё железо.
Есть ли подводные камни перед началом обучения или оценки?Команды обучения и оценки по умолчанию выполняются в режиме dry run, поэтому нужно изучить итоговую команду и добавить --run для реального выполнения, а ещё сначала нужно лицензировать и подготовить собственные локальные обучающие данные.
Что на самом деле делает подход annotation-as-rollout?Он добавляет одну сериализованную аннотацию как надёжный положительный rollout к сэмплам, сгенерированным политикой для того же промпта, сохраняя RL-базовую линию чисто on-policy, но всё же используя разрыв наград между аннотацией и политикой, чтобы направлять и отбирать обновления.
Какие видео-задачи может охватить одно обновление OraRL?Одно правило обновления покрывает семь семейств задач: temporal grounding, spatial grounding, сегментация, трекинг, пространственно-временной grounding, видео-QA и пространственный интеллект.
Насколько ускоряет эффективный режим обучения?Прореживание со знаковым балансом на модели 4B даёт ускорение обновлений в 1.48x (с 92.5 до 62.4 с/шаг) и снижает пиковую память на GPU с 62.4 GB до 50.9 GB.
Какие размеры моделей доступны?Выпущены два чекпоинта Video-ORA — 4B и 9B, оба на бэкбонах Qwen3.5 и размещены на Hugging Face.
Size
9.5 MB
Stars
166
Updated
CommitAug 28
Age
1mo
Commits · 90 Days