README.md

August 9, 2026 Β· View on GitHub

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

We compare Uni-Agent with existing agent systems on parallel inference and verification workloads.

ModelBenchmarkResolvedSetting
Qwen3-Coder-30BSWE-Bench Verified49.2Avg@4, 100 turns, 128K
Qwen3-Coder-480BSWE-Bench Verified64.2Avg@4, 500 turns, 256K
Qwen3-Coder-NextSWE-Bench Verified67.6Avg@4, 300 turns, 128K
Qwen3-Coder-30BSWE-Bench Multiligual35.0Avg@1, 200 turns, 128K
Qwen3.5-9BSWE-Bench Verified58.2Avg@1, 200 turns, 128K
Qwen3.5-35B-A3BSWE-Bench Verified68.4Avg@1, 200 turns, 128K
Qwen3.6-35B-A3BTerminal-Bench v242.5Avg@1, 200K

Detailed settings and additional 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.

ModelDatasetSettingBaseRL
Qwen3-30B-A3B-InstructR2E-GymFully Async, 100 turns, 128K22.236.8
Qwen3-Coder-30B-A3B-InstructR2E-GymFully Async, 100 turns, 128K46.252.0
Qwen3.5-9BSWE-reBenchFully Async, 100 turns, 128K53.859.2
Qwen3-Coder-30B-A3B-InstructSWE-reBenchColocate Async, 200 turns, 128K47.454.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.