verl-agent
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.
Features
Why choose it
Trade-offs
Maintenance check
- 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
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.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!