Skip to content

Repository files navigation

Uni-Agent: Train Long-Horizon Agents at Scale

Documentation GitHub Stars Apache 2.0 License

Uni-Agent is a framework for training long-horizon agents:

  • Bring any existing agent harness into reinforcement learning.
  • Unify diverse agent tasks through one extensible interface.
  • Run agents concurrently at scale and collect traceable trajectories as training-ready data (SFT and RL).

Uni-Agent architecture overview

Highlights ✨

Plug in any agent harness

Connect harnesses such as Claude Code and Mini-SWE-Agent, or any harness that can point its OpenAI- or Anthropic-compatible model endpoint at the Uni-Agent Gateway: request string in, training tokens out.

Decouple agents, tasks, and infrastructure

Build white-box agents from reusable Agent, Tool, Task, and Sandbox abstractions. Customize agent logic, tools, task environments, sandbox backends, and rewards independently while reusing the same evaluation and training runtime.

Run thousands of sessions concurrently

Run 1,000+ long-horizon, stateful sessions with distributed workers, pooled Gateway sessions, isolated sandboxes, and asynchronous scheduling. Every trajectory, log, and reward remains associated with the correct session for reliable evaluation, RL training, and data synthesis.

Reproducible training, verifiable results

We publish runnable recipes with complete configurations, benchmark settings, result tables, and learning curves. Each recipe provides a tested starting point and makes reported improvements easier to reproduce and verify.

Quickstart 🚀

Follow the end-to-end path:

  1. Install Uni-Agent with support for the latest verl features like colocate_async.
  2. Launch a sandbox and run code locally or with cloud services.
  3. Run agent inference at scale for benchmarking and trajectory generation.
  4. Train an agent with RL with reproducible scripts and verifiable results.

For detailed guides and examples, we strongly recommend reading the Uni-Agent documentation.

Results 📊

Parallel Inference & Verification

Uni-Agent supports scalable inference and verification for multiple agent implementations and task types. It also integrates Harbor as an additional task format, allowing all Harbor tasks to run through the same inference pipeline.

The table below highlights a selection of representative results.

Benchmark Agent Model Setting Score
SWE-Bench Verified ReAct Qwen3-Coder-30B 100 turns, 128K 49.2
SWE-Bench Verified ReAct Qwen3-Coder-480B 500 turns, 256K 64.2
SWE-Bench Verified Claude Code Qwen3.5-9B 200 turns, 128K 51.0
SWE-Bench Multilingual ReAct Qwen3-Coder-30B 200 turns, 128K 35.0
Terminal-Bench v2.0 ReAct Qwen3.6-35B 256K 42.5
Terminal-Bench v2.1 Claude Code GLM5.2-733B 256K 67.4

Detailed settings and reference results are available in Inference and Verification.

Agent Reinforcement Learning

Uni-Agent supports agent RL training with the same interaction stack used at inference time. We provide fully async training recipes across multiple tasks, models and datasets, with GRPO/GSPO-style objectives and partial rollout support. Example scripts are available in examples/quickstart/training.

Model Dataset Setting Base RL
Qwen3-30B-A3B R2E-Gym Fully Async, 100 turns, 128K 22.2 36.8
Qwen3-Coder-30B-A3B R2E-Gym Fully Async, 100 turns, 128K 46.2 52.0
Qwen3.5-9B SWE-reBench Fully Async, 100 turns, 128K 53.8 59.2
Qwen3-Coder-30B-A3B SWE-reBench Colocate Async, 200 turns, 128K 47.4 54.2

Training dynamics, asynchronous rollout performance, and reproducibility details are available in RL Training.

Roadmap 🗺️

See the Uni-Agent 26Q3 Roadmap for current priorities and planned work.

Acknowledgement 🙏

Uni-Agent's large-scale parallel interaction and verification rely on remote sandbox backends. We gratefully acknowledge:

  • veFaaS: Volcengine Function-as-a-Service, used as a serverless backend for elastically launching agent sandboxes at scale.
  • Modal: serverless cloud compute used to spin up isolated, reproducible sandbox environments for agent execution and evaluation.

Citation 📚

If you find the project helpful, please cite:

@misc{uniagent_github,
  author       = {Yuyang Ding and Bo Wen and Xubo Cao and Zhiqiang Zhai and Guangming Sheng and Xibin Wu and Juntao Li and Min Zhang and Uni-Agent Contributors},
  title        = {Uni-Agent: Build, Run, and Train Agents at Scale},
  year         = {2026},
  howpublished = {\url{https://github.com/verl-project/uni-agent}},
  note         = {GitHub repository. Supervisor: Xibin Wu and Juntao Li},
  urldate      = {2026-03-27}
}

Contributing 🤝

Community contributions are welcome. See CONTRIBUTING.md for guidelines on how to get started.

About

Uni-Agent is a framework for training long-horizon agents.

Resources

Contributing

Stars

539 stars

Watchers

4 watching

Forks

Releases

Contributors

Languages