Skip to main content
开源 SDK 与 osmosis CLI 位于同一个 osmosis-ai Python package 中。SDK 需要 Python 3.12 或更高版本。

安装 v0.3 Release Candidate

固定当前 v0.3 release-candidate 版本线,使环境可以安装 RC builds,同时不会跨越下一个 minor-version 边界:
验证 package 和内置 CLI:
下限必须包含 0.3.0rc1;在干净环境中,>=0.3 这样的 final-release 下限不会选择 pre-release。

可选 Extras

只安装项目实际 import 的功能: Extras 可以组合安装。例如,通过 HTTP 提供服务的 Strands rollout 使用:

最小 SDK 示例

此 entrypoint 将 workflow 和 grader 显式连接到 LocalBackend,然后把该 backend 作为 rollout server 暴露:
安装 server extra,将示例保存为 main.py,然后运行该 entrypoint:
Platform 会设置 _OSMOSIS_ROLLOUT_PORT,此时 server 会在托管容器中绑定所有网络接口;本地运行默认使用 127.0.0.1:8000
Rollout server 不会对入站调用方做身份验证。本地请将其保留在 loopback 上,仅通过 Platform 的托管环境对外暴露。
此示例用于展示 wiring,不包含可训练的 policy call。进行训练时,请使用 Strands integrationOpenAI Agents integration,使模型请求通过活跃的 rollout context 路由。

Platform 认证与升级

仅运行本地 SDK 代码不需要登录 Platform。提交 evaluation 或 training run 的命令需要登录;请按照 CLI 安装与认证 运行 osmosis auth login 或配置 OSMOSIS_TOKEN 如果您正在升级已有 v0.2 harness,请先阅读 SDK v0.2 → v0.3 迁移指南,然后再修改 dependency,尤其是 harness 会构造 HarborBackend 时。

下一步

AgentWorkflow

实现产生一个 rollout sample 的行为。

执行后端

将 workflow 和 grader 连接到 Local 或 Harbor execution。
最后修改于 2026年8月10日