verl-project/verl-omni
Multimodal RL training framework for diffusion & omni models
VeRL‑Omni
VeRL‑Omni is an open‑source reinforcement‑learning (RL) training framework that focuses on multimodal generative models such as diffusion image/video/audio generators and omni‑modality text‑image‑audio‑video models. It sits on top of the verl library and integrates tightly with the vLLM‑Omni inference backend to provide fast, stable, and scalable RL post‑training for these large models.
What it does
- RL‑based fine‑tuning of diffusion and omni‑modality generators (e.g., Qwen‑Image, SD3.5, Qwen‑3‑Omni, BAGEL, Wan2.2, etc.).
- Supports a variety of RL algorithms tailored for generative models: FlowGRPO, Flow‑DPPO, MixGRPO, Diffusion‑OPD, DiffusionNFT, DPO, GSPO, DAPO, and more.
- Provides high‑throughput rollout via the vLLM‑Omni backend, with batching, embed‑caching, and routing optimisations.
- Offers asynchronous, multi‑reward serving (HTTP scorer, HPSv3, GenRM‑OCR, UnifiedReward, etc.) to overlap rollout and reward computation.
- Works with distributed training back‑ends (VeOmni, FSDP2) and multiple parallelism strategies (USP/TP/DP).
- Includes stability tricks such as rollout‑correction to skip costly log‑prob recomputation and deterministic RL pipelines.
- Ascend NPU support (A2, A3, A5) for hardware‑accelerated training.
Who might use it
- Researchers fine‑tuning diffusion models for higher image/video/audio quality using RL.
- Engineers building commercial multimodal generation services that need fast, stable RL pipelines.
- Teams that want to experiment with on‑policy distillation (DiffusionOPD), multi‑teacher RL, or reward‑model alignment for omni‑modality models.
Quick start (high‑level)
- Install – follow the docs (
pip install verl-omnior build from source). - Pick a recipe – e.g., the FlowGRPO recipe for Qwen‑Image is in
examples/flowgrpo_trainer/. - Configure – edit the provided Hydra YAML files to set model, dataset, reward endpoints, and parallelism.
- Run – launch the trainer (
python -m verl_omni.train ...). - Monitor – logs are compatible with Weights & Biases, TensorBoard, etc.
Documentation & Resources
- Full docs: https://verl‑omni.readthedocs.io/en/latest/
- Installation guide: https://verl‑omni.readthedocs.io/en/latest/start/install.html
- Quick‑start tutorials: https://verl‑omni.readthedocs.io/en/latest/start/flowgrpo_quickstart.html
- Algorithm details: FlowGRPO, DiffusionOPD, DAPO, etc. (see the
docs/algo/section). - Example recipes: under
examples/(FlowGRPO, DiffusionNFT, GSPO, DAPO, etc.). - Community: Slack invite, WeChat group, and issue tracker for support.
License
Apache 2.0 – permissive open‑source license.
Citation
If you use VeRL‑Omni in research, cite the provided BibTeX entry.
Bottom line: VeRL‑Omni is a production‑grade, extensible RL training stack for the newest generation of multimodal and omni‑modality generative models, offering speed, stability, and hardware flexibility out of the box.
Related
- Dispatch
- Dispatch
- Project
- Project
- Project