跳转到主要内容
通过 Local Rollout，训练组件可以和应用代码一起保存在 Git 中。按照标准文件夹结构组织 MCP 工具、reward 函数和 rubric，推送到 GitHub（公开或私有）后 Osmosis 会自动拉取 —— 无需手动上传或在平台端额外配置。
要连接你的仓库，请从平台安装 Osmosis GitHub App。请参阅 GitHub 集成 了解设置说明。

​
为什么使用 Local Rollout？

通过将你的 GitHub 仓库连接到 Osmosis，你可以：
  • 版本控制 你的评估逻辑，与应用代码一起管理
  • 协作 使用熟悉的 Git 工作流与团队协作
  • 自动化 通过 CI/CD 流水线自动部署
  • 保持仓库私有 同时仍然与 Osmosis 同步
  • 管理 在一个地方集中管理多个 rubrics 和函数
如需快速本地测试和开发，请直接使用 Python SDK。

​
可以同步哪些内容？

Osmosis 自动从你的仓库中发现并同步三种类型的组件：
  1. MCP 工具 - 通过自定义函数扩展 AI 智能体的能力
  2. 奖励函数 - 为 LLM 输出提供确定性的数值评分
  3. Reward Rubrics - 使用 LLM 通过自然语言标准评估输出

​
示例仓库

查看我们的参考实现：osmosis-git-sync-example 此示例演示了 Osmosis GitHub 集成发现并同步的完整文件夹结构和代码工件。

​
快速开始

有关完整的工作示例，请参阅 官方示例仓库。
1

设置仓库

创建所需的目录结构和 pyproject.toml。请参阅 文件夹结构 了解完整布局和依赖配置。
mkdir -p my-osmosis-repo/{mcp/{server,tools,test},reward_fn,reward_rubric}
cd my-osmosis-repo
2

添加组件

将你的 MCP 工具、奖励函数和 Reward Rubrics 添加到对应的目录中：
3

本地测试

pip install -e .

# Test MCP server
python mcp/main.py

# Test reward function
python -c "from reward_fn.compute_reward import numbers_match_reward; print(numbers_match_reward('#### 42', '42'))"
4

推送到 GitHub

git init
git add .
git commit -m "Initial Osmosis sync setup"
git remote add origin https://github.com/your-username/my-osmosis-repo.git
git push -u origin main
5

连接到平台

按照 GitHub 集成 指南安装 Osmosis GitHub App 并连接你的仓库。连接后，Osmosis 会在每次推送时自动同步。

​
下一步

文件夹结构

仓库所需的目录布局

GitHub 集成

连接你的仓库

最佳实践

生产环境指南