A Ray- and vLLM-based framework for reinforcement learning from human feedback and agentic RL training of large language and vision-language models.
verl-project/verl
verl is an open-source reinforcement learning training library for post-training large language models, built on the HybridFlow paper.
- Stars
- 23,942
- Forks
- 4,779
- Open issues
- 1,366
- Last commit
- yesterday
What is it?
verl is an RL training library for large language models, originally released by the ByteDance Seed team and now maintained by a community. It targets post-training workflows such as PPO and GRPO, and is designed to plug into existing training and inference engines rather than replace them.
The framework separates computation from data dependencies through a hybrid-controller programming model, which lets users express RL dataflows in a few lines of code. It supports FSDP, FSDP2 and Megatron-LM for training, and vLLM, SGLang and HF Transformers for rollout generation. Models can be placed flexibly across different sets of GPUs, and a 3D-HybridEngine reshards actor models between training and generation phases.
Beyond core RL algorithms, verl includes supervised fine-tuning, LoRA, multi-turn tool calling, multi-modal RL for vision-language models, and experiment tracking with wandb, swanlab, mlflow and tensorboard. It runs on NVIDIA, AMD ROCm and Ascend hardware.
Key features
- 01Supports PPO, GRPO, GSPO, REINFORCE++, RLOO, DAPO and other RL algorithms.
- 02Integrates FSDP, Megatron-LM for training and vLLM, SGLang for rollout.
- 03Works with Hugging Face models such as Qwen, Llama and Gemma.
- 04Supports LoRA, sequence packing and expert parallelism for large MoE models.
- 05Includes multi-turn tool calling and multi-modal RL for vision-language models.
- 06Runs on NVIDIA, AMD ROCm and Ascend hardware.
Use cases
- Post-training LLMs for math or coding reasoning with verifiable rewards.
- Running GRPO or PPO at scale across multi-GPU clusters.
- Training LLM agents that call tools over multiple turns.
- Applying RL to vision-language models with multi-modal inputs.
Things to know
- Training large models requires GPU hardware, and the headline features target multi-GPU clusters.
- The README excerpt provided does not include an install or run command, so setup steps must be taken from the full documentation.
Topics
FAQ
- What is verl?
- verl is an open-source reinforcement learning training library for post-training large language models, built on the HybridFlow paper. verl is an RL training library for large language models, originally released by the ByteDance Seed team and now maintained by a community. It targets post-training workflows such as PPO and GRPO, and is designed to plug into existing training and inference engines rather than replace them.
- Is verl free to use? What license does it have?
- verl is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is verl still maintained?
- Actively maintained. The last commit to verl was on Oct 20, 2026.
- What can I use verl for?
- Post-training LLMs for math or coding reasoning with verifiable rewards. Running GRPO or PPO at scale across multi-GPU clusters. Training LLM agents that call tools over multiple turns. Applying RL to vision-language models with multi-modal inputs.
- Where can I get verl?
- The source code and installation instructions are on GitHub: https://github.com/verl-project/verl
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A large-scale asynchronous reinforcement learning system for training LLM reasoning and agentic models, with RL training for black-box agents via a base_url swap.
Python RL framework that trains multi-step LLM agents on their own experience using GRPO, with a client-server design that plugs into existing apps.
A Hugging Face library for post-training transformer language models with SFT, GRPO, DPO, KTO and reward modeling.
A fine-tuning, training, inference and deployment framework for 600+ large language models and 400+ multimodal models, covering SFT, DPO and GRPO.
An open-source framework for training LLM agents with reinforcement learning, supporting any agent harness, sandbox, and training backend.