osmosis CLI 位于同一个 osmosis-ai Python package 中。SDK 需要 Python 3.12 或更高版本。
安装 v0.3 Release Candidate
固定当前 v0.3 release-candidate 版本线,使环境可以安装 RC builds,同时不会跨越下一个 minor-version 边界:下限必须包含
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:
_OSMOSIS_ROLLOUT_PORT,此时 server 会在托管容器中绑定所有网络接口;本地运行默认使用 127.0.0.1:8000。
此示例用于展示 wiring,不包含可训练的 policy call。进行训练时,请使用 Strands integration 或 OpenAI 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。