Open-AgentRL

RL training framework for reasoning, tool use, and interactive agent environments.

Stars
★ 661
Last updated
4mo ago
License
Apache-2.0
Primary language
Python

At a glance

How it runs
CLIFramework
Works with
Portable with changes
Cost
Free software; you pay for model usage
Setup effort
High · needs real infrastructure
You'll need
CondaPython 3.10 or 3.11vLLMSGLangMegatron CoreSandboxFusion for code executionAlfWorld for text-game trainingVolcengine Cloud VMs for the documented OSWorld setupShell / CLINetwork accessLocal filesystem
Typical use
A research team reproducing agentic-reasoning experiments from 3K SFT and 30K RL datasets, then evaluating on AIME, GPQA-Diamond, or LiveCodeBench-v6.
Not a fit if
  • Teams wanting a plug-and-play inference service
  • Individuals without GPU clusters or cloud VM pools
  • Teams avoiding vendor-specific cloud dependencies

What does this agent do, and when should you use it?

Open-AgentRL brings together three agentic-RL research implementations: DemyAgent, RLAnything, and AutoTool. DemyAgent covers cold-start SFT and GRPO-TCR-based agentic RL, with evaluation workflows for math, science, and coding reasoning. RLAnything performs closed-loop optimization of policy, reward model, and environment for OSWorld computer control, AlfWorld text games, and coding tasks. AutoTool supplies a two-phase dynamic tool-selection framework that first stabilizes tool-integrated trajectories and then refines multi-step selection with KL-regularized Plackett–Luce ranking. It is a research training repository that requires users to supply models, data, configuration, and, for some scenarios, external execution infrastructure rather than a ready-to-deploy chat service.

For DemyAgent, the repository reads SFT, RL, and evaluation data in .parquet format, fine-tunes Qwen models through recipe/demystify/qwen3_4b_sft.sh or qwen2_7b_sft.sh, then runs GRPO-TCR with grpo_tcr_qwen2_7b.sh or grpo_tcr_qwen3_4b.sh. Code-execution tasks use a SandboxFusion /run_code endpoint, configured in sandbox_fusion_tool_config.yaml and verl/utils/reward_score/livecodebench/code_math.py. RLAnything launches training from scenario-specific YAML files through osworld_rl.py, alfworld_rl.py, and coding_rl.py, with matching *_eval.py evaluation programs. The AutoTool framework covers Phase I SFT-plus-RL trajectory stabilization and Phase II ranking-based tool-selection refinement; the repository says its full training data and toolset are still forthcoming.

  1. A research team reproducing agentic-reasoning experiments from 3K SFT and 30K RL datasets, then evaluating on AIME, GPQA-Diamond, or LiveCodeBench-v6.
  2. A team with a local or cloud SandboxFusion endpoint training Qwen-family models that execute code during reasoning.
  3. A team that has configured Volcengine cloud VMs, security groups, and an OSWorld image for RL training or evaluation of GUI computer-control policies.
  4. A researcher who has downloaded AlfWorld data and needs to train or evaluate RL policies in a text-based interactive game.
  5. A group investigating dynamic selection over a large, evolving tool library and willing to work before AutoTool’s full data and toolset are released.

How do you install or deploy this agent?

For DemyAgent:

git clone https://github.com/Gen-Verse/Open-AgentRL.git
conda create -n OpenAgentRL python=3.11
conda activate OpenAgentRL
cd Open-AgentRL
bash scripts/install_vllm_sglang_mcore.sh
pip install -e .[vllm]

For RLAnything:

conda create --name rlanything python=3.10
source activate rlanything
pip install -r requirements_rlanything.txt

The supplied material does not state an API-key requirement. Code-execution RL additionally needs a SandboxFusion deployment or a Volcano Engine Cloud FaaS /run_code endpoint; the documented OSWorld setup uses Volcengine cloud VMs.

How do you use this agent?

Before DemyAgent cold-start SFT, set absolute TRAIN_DATA, EVAL_DATA, MODEL_PATH, and SAVE_PATH values in recipe/demystify/qwen3_4b_sft.sh or qwen2_7b_sft.sh, then run:

bash recipe/demystify/qwen3_4b_sft.sh

After configuring the SandboxFusion endpoint, RL data, model, benchmark paths, and default_local_dir, run:

bash recipe/demystify/grpo_tcr_qwen3_4b.sh

For RLAnything, the first training invocation depends on the scenario; for example:

python osworld_rl.py config=configs/osworld_rl.yaml

For a single-node run, set num_node to 1 in the corresponding YAML configuration.

What are this agent's strengths and limitations?

Pros
  • Covers agentic reasoning, GUI computer control, text-game environments, coding, and dynamic tool selection in one repository rather than a single benchmark recipe.
  • DemyAgent documents an end-to-end path from cold-start SFT through GRPO-TCR, including named datasets, model checkpoints, scripts, and configuration fields.
  • RLAnything explicitly combines policy, reward-model, and environment adaptation in a closed loop, with separate training and evaluation entry points for OSWorld, AlfWorld, and coding.
  • AutoTool specifies a two-phase approach with KL-regularized Plackett–Luce ranking for multi-step dynamic tool selection.
Limitations
  • It is not a plug-and-play inference product: adopters must provide models, .parquet data, absolute paths, and scenario configuration.
  • Code-execution training depends on SandboxFusion or a Volcano Engine Cloud FaaS endpoint, with endpoint changes required in both tool configuration and reward-scoring code.
  • The documented OSWorld experiment depends on Volcengine security groups, VM images, and a parallel cloud VM pool; infrastructure costs are not stated.
  • AutoTool provides only an example format for its 200K tool-use trajectories; the full training data and toolset are described as coming soon.

How does this agent compare with similar options?

The repository states that its implementation builds on VeRL and ReTool. The supplied material does not provide a feature-by-feature comparison with either project.

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
Open-AgentRL This agent 43 · Major gaps CLIFree + model costs ★ 661 4mo ago Python —
Relax Omni-Modal RL Engine 59 · Major gaps CLIFree ★ 673 1d ago Python —
AReaL Async RL Platform 56 · Major gaps CLIFree ★ 5.9k 2d ago Python —
ART Agent Reinforcement Trainer 53 · Major gaps Library / SDKFreemium ★ 11k today Python —

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
43/ 100 5-point scale 2.2 / 5
Trust 10/29
Reliability 5/14
Adaptability 9/18
Convention 10/18
Effectiveness 6/13
Verifiability 3/8
Why each dimension lost points
Trust10 / 29 · 1.7/5

The code shows permission and data-flow touchpoints including Ray workers, model and reward-model initialization, external sandbox endpoints, cloud VMs, and wandb. The README asks users to configure paths and endpoints but does not show per-action confirmation, sensitive-data protections, or a complete data-flow account, so those areas score 1. No rollback mechanism is shown, scoring 0. The README links papers, datasets, and models, and source files carry Apache copyright notices, supporting source attribution at 2. Publisher identity is unverified and does not add or subtract points.

Reliability5 / 14 · 1.8/5

The README covers several training and evaluation flows, and code includes configuration checks and an exception for an unknown backend. However, the README spans multiple projects, version and release information is limited, and error handling or recovery guidance is sparse, so self-consistency, dependency availability, and failure messages each score 1. The lack of executed tests was not used as a deduction.

Adaptability9 / 18 · 2.5/5

The documentation names math, science, search, code, multimodal, GUI, and text-game scenarios, and provides GPU scale, model paths, data, and cloud-environment setup, supporting a score of 2 for scenarios and environment fit. Capability boundaries are only partly described through project claims and prerequisites; intended audience and selection guidance are general, so those criteria score 1.

Convention10 / 18 · 2.8/5

The README has navigation and project-specific getting-started, training, evaluation, and results sections, with commands and examples, supporting scores of 2 for information architecture and examples. The Apache-2.0 license text agrees with project metadata, scoring 3. Multiple project names and limited version/update history, plus sparse limitations, maintenance ownership, and update-path information, leave the related criteria at 1.

Effectiveness6 / 13 · 2.3/5

The framework offers reusable training, evaluation, and model-merging workflows, and the paper and benchmark table claim capability gains, giving marginal value partial documentary support at 2. The primary outputs are trained models and evaluation results; the packet lacks a clear invocation interface and output contract for a general-purpose end-user Agent, as well as a resource-cost tradeoff, so output usability and cost-benefit score 1.

Verifiability3 / 8 · 1.9/5

The README connects methods, models, datasets, scripts, and benchmark results, but the results are primarily project claims, and the sampled code does not independently corroborate performance or safety behavior. Facts and inferences are not consistently separated. Each verifiability criterion therefore scores 1.

Risks and how to mitigate them
  • Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
  • This repository is primarily for model-training and research workflows. Its documentation calls for configuring code-execution sandboxes, cloud VMs, or external service endpoints and using distributed GPU resources. Review those execution and data-processing boundaries before deployment.
  • Benchmark results and performance gains in the README are project claims; this static review did not run the code or independently reproduce results.
  • The README says AutoTool's full training data and toolset are forthcoming, so the supplied material does not establish their availability.
Evidence confidence: Low Reviewed Nov 08, 2026 Reviewed revision 506ec70ffb47
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/open-agentrl.svg)](https://followagents.com/en/agents/open-agentrl)
<a href="https://followagents.com/en/agents/open-agentrl"><img src="https://followagents.com/badge/open-agentrl.svg" alt="FARS review"></a>

FAQ

Can I deploy this directly as an online agent service?
The supplied material documents training and evaluation workflows, not an online service, unified API, or chat-product deployment.
What external access is needed for code-execution training?
You need either a local SandboxFusion deployment or a Volcano Engine Cloud FaaS /run_code API endpoint, configured in the specified files.
Can OSWorld run on one node?
Yes. The documentation says to set num_node to 1 in configs/osworld_rl.yaml; its reported experiments use parallel cloud VMs.
Is the full AutoTool dataset available now?
The repository includes an example format for the 200K trajectory dataset, but says the full training data and toolset are still to be released.
Was this page helpful?
View on GitHub ↗ Install ↓