AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
LLM Infra/
verl-agent
verl-agent logo

verl-agent

Active·★ 2.4k·Apache-2.0·Updated 2026-06-09

verl-agent extends veRL for training LLM agents with reinforcement learning. The README contrasts it with approaches that concatenate full interaction histories: it uses a step-independent multi-turn rollout, so each step's input structure, history management and memory module can be customised, which it says helps long-horizon tasks. It accompanies the GiGPO (Group-in-Group Policy Optimization) paper, accepted at NeurIPS 2025.

The feature table lists multi-turn and step-wise agent-environment interaction, a customisable memory module, parallelised Gym environments, text-only and text-plus-image modalities, and LoRA training. Models include Qwen3, Qwen3-VL, Qwen2.5, Qwen2.5-VL and LLaMA3.2. Algorithms include GiGPO, GRPO, PPO, DAPO, GSPO, RLOO and REINFORCE++. Environments include ALFWorld, WebShop, Search (tool calling), Sokoban, Gym Cards and AppWorld, and there is a GPT-4o prompt-based agent.

Installation is research-grade: create a Python 3.12 conda env, install `vllm==0.11.0` and `flash-attn==2.7.4.post1`, run `pip install -e .`, then install each environment separately, ideally in its own environment. The README news mentions support by the ROLL and OpenManus-RL projects. Licence is Apache 2.0 and the last push was 2026-06-09, with README news running to 2025-12. This review is based on the README and repository data; we have not run it ourselves.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-22.

License
Apache-2.0
Latest release
v0.1.0 · 2025-12-11
Last commit
2026-06-09
Contributors
108
Forks
237
Open issues and PRs
70
First published
2025-03-23

Source: GitHub, npm and PyPI public APIs.

#LLM Agents#Reinforcement Learning#Deep Learning#Multi-turn Interaction#Scalability#Coding
$ Install
$ pip install -e .
↗ Visit site★ GitHub
01

Features

01Multi-Turn Agent-Environment Interaction
02Fully Customizable Memory Module & Per-Step Input Structure
03Scalable for Very Long-Horizon Optimization
04Parallelized Gym-Style Environments and Group Environments
05Diverse Reinforcement Learning Algorithms
02

Why choose it

+Built for RL training of LLM agents, with customisable per-step input and memory
+Many algorithms in one place: GiGPO, GRPO, PPO, DAPO, GSPO, RLOO, REINFORCE++
+Ready environments such as ALFWorld, WebShop, Search, Sokoban and AppWorld
+Supports Qwen3, Qwen3-VL, LLaMA3.2 and LoRA; Apache 2.0
03

Trade-offs

!It is a research framework for people training models, not a tool for using an agent
!Needs GPUs, pinned versions of vllm and flash-attn, and a separate install per environment
!Built on veRL, so you need to follow veRL's changes as well
!README news ends in December 2025; check recent commits for current activity
04

Maintenance check

SlowingChecked: 2026-10-26
Last commit
2026-06-09
Commits, last 90 days
0
Releases, last 90 days
0
Latest release
v0.1.0 (2025-12-11)
Open issues
70
Recent issues with at least one comment
17/30
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #113 Fatal Python error: none_dealloc: deallocating None9 comments · 2025-07-18
  • #200 GRPO alfworld Training8 comments · 2025-11-20
  • #52 The actor is dead because its worker process has died.8 comments · 2025-06-02
  • #175 questions with training 7B models7 comments · 2025-10-05
  • #109 Worker Registration Timeouts and Resource Allocation Warnings in Ray Cluster7 comments · 2025-07-15

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

veRL
Native Integration
Verified via docs
ROLL
Supported
Verified via docs
OpenManus-RL
Supported
Verified via docs
06

Quick start

1
$ pip install -e .
07

Use cases

↳Training large language model agents for complex multi-turn, long-horizon tasks.
↳Developing reasoning agents for both visual and text-based environments.
↳Solving digital interface control, embodied AI, and search-related challenges.
08

Alternatives

⚡Top VS:
VSrlcard★3.6k→VSir-sim★1.2k→VScode-act★1.7k→VSskrl★1.1k→
rlcard logo
rlcard★ 3.6k
Reinforcement Learning / AI Bots in Card (Poker) Games - Blackjack, Leduc, Texas, DouDizhu, Mahjong, UNO.
VSCompare→
ir-sim logo
ir-sim★ 1.2k
A Python-based lightweight robot simulator designed for navigation, control, and reinforcement learning
VSCompare→
code-act logo
code-act★ 1.7k
Official Repo for ICML 2024 paper "Executable Code Actions Elicit Better LLM Agents" by Xingyao Wang, Yangyi Chen, Lifan Yuan, Yizhe Zhang, Yunzhu Li, Hao Peng, Heng Ji.
VSCompare→
skrl logo
skrl★ 1.1k
Modular Reinforcement Learning (RL) library (implemented in PyTorch, JAX, and NVIDIA Warp) with support for Gymnasium/Gym, NVIDIA Isaac Lab, MuJoCo Playground and other environments
VSCompare→
AgileRL logo
AgileRL★ 960
Streamlining reinforcement learning with RLOps. State-of-the-art RL algorithms and tools, with 10x faster training through evolutionary hyperparameter optimization.
VSCompare→
MAgent logo
MAgent★ 1.8k
MAgent is a research platform for many-agent reinforcement learning (AAAI 2018 demo). No longer maintained; the maintained fork is Farama Foundation's MAgent2.
VSCompare→
cua logo
cua★ 31.1k
Open-source infrastructure that gives AI agents computers they can use: sandboxed desktops and VMs, drivers for operating native apps, SDKs and benchmarks for computer-use agents.
VSCompare→
E2B logo
E2B★ 14.6k
Open-source infrastructure for running AI-generated code in secure, isolated cloud sandboxes, with SDKs for code execution and desktop computer use.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
langfengQ /
verl-agent
↗

Apache-2.0 veRL extension for training LLM agents with RL, with step-wise rollout, the GiGPO algorithm and environments like ALFWorld and WebShop

2.4k237Apache-2.0
Last commit4mo ago
StatusActive
CategoryLLM Infra
Contributors108
Latest releasev0.1.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.