MCPcopy Index your code
hub / github.com/agentscope-ai/Trinity-RFT

github.com/agentscope-ai/Trinity-RFT @v0.6.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.6.0 ↗ · + Follow
3,620 symbols 14,591 edges 353 files 1,285 documented · 35%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

English Homepage | 中文文档 | 常见问题

Trinity-RFT

Trinity-RFT: A General-Purpose and Unified Framework for Reinforcement Fine-Tuning of Large Language Models

paper doc pypi license

💡 什么是 Trinity-RFT ?

Trinity-RFT 是一个通用、灵活、用户友好的大语言模型(LLM)强化微调(RFT)框架。 其将 RFT 流程解耦为三个协同运行的关键模块:

  • Explorer 负责执行智能体-环境交互,并生成经验数据;

  • Trainer 在经验数据上最小化损失函数,以此更新模型参数;

  • Buffer 负责协调整个 RFT 生命周期中的数据处理流水线。

Trinity-RFT 面向不同背景和目标的用户提供相应功能:

  • 🤖 智能体应用开发者: 训练智能体应用,以增强其在特定领域中完成任务的能力 [教程]

  • 🧠 强化学习算法研究者: 通过定制化简洁、可插拔的模块,设计、实现与验证新的强化学习算法 [教程]

  • 📊 数据工程师: 设计针对任务定制的数据集,构建处理流水线以支持数据清洗、增强以及人类参与场景 [教程]

🚀 新闻

  • [2026-06] [发布说明] Trinity-RFT v0.6.0 发布:支持 SGLang,优化全异步参数同步以及调度策略以减少空泡,优化 MoE 模型训练稳定性,升级到 verl 0.8.0。
  • [2026-06] 🎉 两篇论文被 ICML 2026 接收:Learn-to-AskLLM-RL 熵动力学
  • [2026-04] [发布说明] Trinity-RFT v0.5.2 发布:支持 Qwen3.5 系列,修复 Bug 并进行多项优化。
  • [2026-03] 🤖 Trinity-RFT 助力 CoPaw-Flash 训练,打造更懂本地化场景的智能体小模型。欢迎到 CoPaw 试用 CoPaw-Flash,模型下载请见 ModelScopeHuggingFace新闻)。
  • [2026-02] [发布说明] Trinity-RFT v0.5.1 发布:增强 VLM 支持,改进日志系统,修复若干 Bug。
  • [2026-02] [发布说明] Trinity-RFT v0.5.0 发布:单 GPU 场景下的 colocate 模式,trainer 驱动的权重同步,自动并行设置建议等新功能。
  • [2026-01] 🎉 三篇论文被 ICLR 2026 接收:CHORDBOTSGroup-relative REINFORCE 系列变种。在 Trinity-RFT 中尝试这些新算法吧!
  • [2026-01] [发布说明] Trinity-RFT v0.4.1 发布:升级 verl 至 v0.7.0,Tinker 后端支持 OpenAI API,修复若干 Bug。
  • [2026-01] 推出 R3L:基于反思-重试的强化学习机制,由自然语言反馈引导高效探索,并达成稳定的 off-policy 学习(论文)。
  • [2025-12] [发布说明] Trinity-RFT v0.4.0 发布:新增Tinker 后端以支持在 无 GPU 的设备上训练,增加更多基准测试,增强在线 RL 等功能。
  • [2025-12] Trinity-RFT 助力淘宝闪购医药健康业务,让 AI 智能体能够理解模糊症状、主动询问后续问题,并提供精准推荐(新闻)。
  • [2025-11] [发布说明] Trinity-RFT v0.3.3 发布:修复若干 Bug。
  • [2025-11] 推出 Learn-to-Ask:利用离线专家数据,训练具备主动问询能力的对话智能体(论文)。

More...

  • [2025-11] 推出 [BOTS](https://github.com/agentscope-ai/Trinity-RFT/tree/main/examples/bots):在线 RL 任务选择,实现高效 LLM 微调([论文](https://arxiv.org/pdf/2510.26374))。
  • [2025-09] 我们的 [论文](https://arxiv.org/pdf/2509.24203) 揭示了 group-relative REINFORCE 及其变种(如 GRPO 和 AsymRE)的 off-policy 解释([代码](https://github.com/agentscope-ai/Trinity-RFT/tree/main/examples/rec_gsm8k))。
  • [2025-08] 推出 [CHORD](https://github.com/agentscope-ai/Trinity-RFT/tree/main/examples/mix_chord):动态 SFT + RL 集成,实现进阶 LLM 微调([论文](https://arxiv.org/pdf/2508.11408))。
  • [2025-11] Trinity-RFT v0.3.2 发布:修复若干 Bug 并支持进阶的任务选择和调度。
  • [2025-10] Trinity-RFT v0.3.1 发布:多阶段训练支持、改进的智能体 RL 示例、LoRA 支持、调试模式和全新 RL 算法。
  • [2025-09] Trinity-RFT v0.3.0 发布:增强的 Buffer、FSDP2 & Megatron 支持,多模态模型,以及全新 RL 算法/示例。
  • [2025-08] Trinity-RFT v0.2.1 发布。
  • [2025-07] Trinity-RFT v0.2.0 发布。
  • [2025-07] 技术报告(arXiv v2)更新,包含新功能、示例和实验:[链接](https://arxiv.org/abs/2505.17826)。
  • [2025-06] Trinity-RFT v0.1.1 发布。
  • [2025-05] Trinity-RFT v0.1.0 发布,同时发布 [技术报告](https://arxiv.org/abs/2505.17826)。
  • [2025-04] Trinity-RFT 开源。

🔨 教程与指南

类别 教程 / 指南
运行各种 RFT 模式 + 快速开始:在 GSM8k 上运行 GRPO

[!TIP] 推荐阅读顺序

🆕 新手入门: 安装快速开始 (GSM8K)参数配置指南GPU 资源配置指南

🔬 算法研究者: 开发者指南算法开发指南CHORD 算法示例

🤖 Agent 开发者: 开发者指南Workflow 开发通用多轮 Workflow 示例

[!NOTE] 更多教程请参考 Trinity-RFT 文档

🌟 核心特性

  • 灵活的 RFT 模式:
  • 支持同步/异步、on-policy/off-policy 以及在线/离线强化学习
  • 采样与训练可分离运行,并可在多设备上独立扩展
  • 支持经验回放,进一步提升样本与时间效率

Trinity-RFT 支持的 RFT 模式

  • Agentic RL 支持:
  • 支持拼接式多轮和通用多轮交互
  • 能够直接训练使用 AgentScope 等智能体框架开发的 Agent 应用

智能体工作流

  • 全生命周期的数据流水线:
  • 支持 rollout 任务和经验数据的流水线处理
  • 贯穿 RFT 生命周期的主动数据管理(优先级排序、清洗、增强等)
  • 原生支持多任务联合训练与课程学习

数据流水线设计

  • 用户友好的框架设计:
  • 即插即用模块与解耦式架构,便于快速上手和二次开发
  • 丰富的图形界面,支持低代码使用

系统架构

🔨 算法支持

下表列出了 Trinity-RFT 支持的算法,更多算法请参考 算法模块。您也可以通过自定义不同的模块来构建新算法,参见 教程

算法 文档/示例 核心代码 关键配置
PPO [论文] [文档] [Countdown 示例] [代码] algorithm_type: ppo
GRPO [论文] [文档] [GSM8K 示例] [代码] algorithm_type: grpo
SFT [Mixture-of-Thoughts 示例] [代码] algorithm_type: sft
DPO [论文] [HumanLike 示例] [代码] algorithm_type: dpo
CHORD 💡 [论文] [文档] [ToolACE 示例] [代码] algorithm_type: mix_chord
REC Series 💡 [论文] [GSM8K 示例] [代码] algorithm_type: rec
RLOO [论文] - [代码] algorithm_type: rloo
REINFORCE++ [论文] - [代码] algorithm_type: reinforceplusplus
GSPO [论文] - [代码] algorithm_type: gspo
TOPR [论文] [GSM8K 示例] [[代码

Core symbols most depended-on inside this repo

get
called by 863
trinity/utils/registry.py
update
called by 122
trinity/buffer/reader/file_reader.py
check_and_update
called by 106
trinity/common/config.py
sleep
called by 85
trinity/common/models/vllm_model.py
get_logger
called by 83
trinity/utils/log.py
get_configs
called by 79
trinity/manager/config_manager.py
debug
called by 74
trinity/explorer/workflow_runner.py
metric_list
called by 74
tests/tools.py

Shape

Method 2,177
Function 762
Class 586
Route 95

Languages

Python100%

Modules by API surface

tests/explorer/scheduler_test.py84 symbols
tests/trainer/trainer_test.py80 symbols
tests/explorer/workflow_test.py78 symbols
trinity/common/models/model.py70 symbols
tests/common/vllm_test.py69 symbols
trinity/manager/config_registry/trainer_config_manager.py66 symbols
trinity/trainer/verl_legacy/megatron_workers.py58 symbols
trinity/algorithm/algorithm.py55 symbols
trinity/trainer/verl_legacy/fsdp_workers.py54 symbols
trinity/common/config_validator.py50 symbols
trinity/explorer/scheduler.py49 symbols
trinity/common/config.py45 symbols

Datastores touched

(mysql)Database · 1 repos
dbDatabase · 1 repos
dbDatabase · 1 repos

For agents

$ claude mcp add Trinity-RFT \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact