verl README

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

👋 Hi, everyone! verl is a RL training library initiated by ByteDance Seed team and maintained by the verl community.

Ask DeepWiki.com GitHub Repo stars Twitter Documentation

seed logo

verl: Volcano Engine Reinforcement Learning for LLMs

verl is a flexible, efficient and production-ready RL training library for large language models (LLMs).

verl is the open-source version of HybridFlow: A Flexible and Efficient RLHF Framework paper.

verl is flexible and easy to use with:

verl is fast with:

verl-arch.png

News

more...
  • [2025/04] [Seed-Thinking-v1.5](https://github.com/ByteDance-Seed/Seed-Thinking-v1.5/blob/main/seed-thinking-v1.5.pdf) tech report is released! Trained with verl, Seed-Thinking-v1.5 achieves 86.7 on AIME 2024, 55.0 on Codeforces and 77.3 on GPQA, demonstrating excellent reasoning abilities in STEM and coding. Beyond reasoning tasks, the method demonstrates notable generalization across diverse domains.
  • [2025/07] verl keynote at [AWS AI Hours Singapore](https://pages.awscloud.com/aws-ai-hours-sg.html#agenda) on 7/8, verl & verl-agent project updates at [Agent for SWE meetup](https://lu.ma/e498qhsi) by LF AI & Data Singapore on 7/11.
  • [2025/06] verl team will provide latest project updates at [PyTorch Day China](https://www.lfasiallc.com/pytorch-day-china/) on June 7th. Meet our dev team in Beijing!
  • [2025/04] [VAPO](https://arxiv.org/pdf/2504.05118) (value-based augmented PPO) paper covers our latest RL method for reasoning models. Trained from Qwen-32B-base model, VAPO achieves 60.4 on AIME 2024, outperforming DAPO-32B.
  • [2025/05] [PF-PPO](https://arxiv.org/abs/2409.06957), accepted to ICML 2025, is now supported in verl! PF-PPO enhances policy learning efficiency and robustness by filtering potentially noisy reward signals and reusing high-quality experiences via a replay buffer.
  • [2025/04] We will give a tutorial about latest post-training techniques and programming guide for verl at [ICLR 2025 Expo](https://iclr.cc/virtual/2025/calendar?filter_events=Expo+Talk+Panel&filter_rooms=), [SCI-FM workshop](https://open-foundation-model.github.io/) and [LMSys afterparty](https://lu.ma/d23nyynm). Talk materials available [here](https://github.com/eric-haibin-lin/verl-community/tree/main/iclr25).
  • [2025/03] verl v0.3.0.post1 is released! See [release note](https://github.com/verl-project/verl/releases/) for details. It achieves [~1.4x speedup](https://tongyx361.github.io/blogs/posts/verl-intro/#/verl-flexible-and-efficient-rl-for-llms) compared to prev versions.
  • [2025/05] verl will be presented at [A2M Shanghai](https://a2m.msup.com.cn/home/?aid=4488&city=shanghai) on 5/16 - 5/17.
  • [2025/05] verl will be presented at [GOSIM x PyTorch Day 2025](https://paris2025.gosim.org/). See you in Paris!
  • [2025/03] We introduced the programming model of verl at the [vLLM Beijing Meetup](https://mp.weixin.qq.com/s/n77GibL2corAtQHtVEAzfg) and [verl intro and updates](https://github.com/eric-haibin-lin/verl-community/blob/main/slides/verl-lmsys-meetup.pdf) at the [SGLang-LMSYS Org Meetup](https://lu.ma/ntjrr7ig) in Sunnyvale mid-March.
  • [2025/03] We will present verl(HybridFlow) at EuroSys 2025. See you in Rotterdam!
  • [2025/02] verl v0.2.0.post2 is released!
  • [2025/02] We presented verl in the Bytedance/NVIDIA/Anyscale Ray Meetup. See you in San Jose!
  • [2025/01] [Doubao-1.5-pro](https://team.doubao.com/zh/special/doubao_1_5_pro) is released with SOTA-level performance on LLM & VLM. The RL scaling preview model is trained using verl, reaching OpenAI O1-level performance on math benchmarks (70.0 pass@1 on AIME).
  • [2024/12] verl is presented at Ray Forward 2024. Slides available here
  • [2024/12] The team presented Post-training LLMs: From Algorithms to Infrastructure at NeurIPS 2024. Slides and video available.
  • [2024/10] verl is presented at Ray Summit. Youtube video available.
  • [2024/08] HybridFlow (verl) is accepted to EuroSys 2025.

Key Features

Getting Started

Documentation

Quickstart:

Running a PPO example step-by-step:

Reproducible algorithm baselines:

Algorithm recipes (recipe/):

For code explanation and advance usage (extension):

Blogs from the community

Performance Tuning Guide

The performance is essential for on-policy RL algorithm. We have written a detailed performance tuning guide to help you optimize performance.

Upgrade to vLLM >= v0.8.2

verl now supports vLLM>=0.8.2 when using FSDP as the training backend. Please refer to this document for the installation guide and more information. Please avoid vllm 0.7.x, which contains bugs that may lead to OOMs and unexpected errors.

Use Latest SGLang

SGLang is fully supported with verl, and SGLang RL Group is working extensively on building unique features, including multi-turn agentic RL, VLM RLHF, server-based RL, and partial rollout. Please refer to this document for the installation guide and more information.

Upgrade to FSDP2

verl is fully embracing FSDP2! FSDP2 is recommended by torch distributed team, providing better throughput and memory usage, and is composible with other features (e.g. torch.compile). To enable FSDP2, simply use verl main and set the following options:

actor_rollout_ref.ref.strategy=fsdp2
actor_rollout_ref.actor.strategy=fsdp2
critic.strategy=fsdp2

verl (verl-project/verl)

Searching Database…

23.9K ·GitHub
Что это такое?verl — это гибкая, эффективная и готовая к продакшену библиотека для обучения с подкреплением (RL) больших языковых моделей. Её начала команда Seed из ByteDance, а развивает сообщество. Это открытая реализация статьи HybridFlow (EuroSys 2025).
Это Python-библиотека, под которую я пишу скрипты, или облачный сервис?Это Python-фреймворк, который вы запускаете на собственных GPU-кластерах: гибридно-контроллерная модель программирования позволяет описать RL-процессы вроде GRPO или PPO парой строк кода, а выполнение берут на себя тренеры на базе Ray.
С чего начать, чтобы запустить первое обучение?Следуйте разделу Getting Started в README, затем подтяните сабмодуль с рецептами командой git submodule update --init --recursive recipe — там лежат готовые примеры. recipe/README.md служит их оглавлением, а документация описывает PPO-тренер, воркеров и продвинутые способы расширения.
С какими движками для обучения и инференса он работает?Для обучения поддерживаются FSDP, FSDP2 и Megatron-LM; для генерации роллаутов используются vLLM, SGLang или HF Transformers. Работает с моделями из Hugging Face и ModelScope, например Qwen3.5, Qwen3, Llama3.1, Gemma2 и DeepSeek-LLM.
Есть ли подводные камни с версиями, о которых стоит знать до установки?Избегайте vLLM 0.7.x: там есть баги, которые приводят к нехватке памяти (OOM) и неожиданным ошибкам — с бэкендом FSDP берите vLLM 0.8.2 или новее. Команда также советует переходить на FSDP2 через флаги стратегии в verl на ветке main.
Нужен ли какой-то конкретный производитель GPU или огромный кластер?Поддерживается железо NVIDIA, AMD и Ascend, а с экспертным параллелизмом всё масштабируется до моделей на 671 млрд параметров на сотнях GPU. Multi-GPU LoRA RL помогает экономить память на скромных конфигурациях.
Что за 3D-HybridEngine, о котором упоминается в README?Это движок verl для эффективного перераспределения (решардинга) модели-актора: он убирает лишнее дублирование в памяти и заметно снижает накладные расходы на коммуникацию при переходах между фазами обучения и генерации в RL.
С какими трекерами экспериментов он умеет работать?Из коробки интегрируются wandb, swanlab, mlflow и tensorboard для отслеживания экспериментов, а проект RL-Insight добавляет онлайн-наблюдаемость для RL-запусков обучения.
А какие-нибудь известные модели реально обучали с его помощью?Да — DAPO, обученная на verl, набрала 50 баллов на AIME 2024 от базы Qwen2.5-32B, Seed-Thinking-v1.5 от ByteDance достигла 86.7 на AIME 2024, а превью-модель Doubao-1.5-pro с RL показала 70.0 pass@1 на AIME.
Есть ли проекты-ответвления, построенные на базе verl?Несколько: verl-vla для пост-обучения роботизированных VLA-моделей, VeRL-Tinker для SFT/RL/дистилляции на собственных GPU-воркерах под управлением verl, VeRL-Omni для омни-модального пост-обучения, verl-SpeCo для спекулятивного декодирования и фреймворк uni-agent.
What are similar projects?verl, ms-swift, halo, LoongForge, unsloth, minimind, open-r1, Meshy
Size
30.9 MB
Stars
23.9K
Age
1y
Commits · 90 Days