跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.osmosis.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
安装

从 PyPI 安装 Osmosis CLI： 
pip install osmosis-ai
需要 Python 3.12 或更高版本。安装包注册了三个等效的 CLI 别名：osmosis、osmosis-ai 和 osmosis_ai。
验证安装： 
osmosis --version

​
升级

CLI 可以就地自升级。它会自动检测您的安装方式（pip、pipx 或 uv tool）并运行相应的升级命令： 
osmosis upgrade
您也可以使用自己喜欢的包管理器手动升级：
pip install --upgrade osmosis-ai
# 或
pipx upgrade osmosis-ai
# 或
uv tool upgrade osmosis-ai

​
身份验证

​
登录

osmosis auth login
打开基于浏览器的 OAuth 流程来验证您的 CLI 会话。凭据将存储在本地，供后续命令复用。
选项说明
-f, --force强制重新登录，清除现有凭据
--token <TOKEN>使用个人访问令牌进行身份验证，而非浏览器流程（适用于 CI/CD）
对于 CI/CD 流水线，请设置 OSMOSIS_TOKEN 环境变量，而不是运行 osmosis auth login。设置该变量后，CLI 会自动使用它，同时 login 命令将被禁用。

​
登出

osmosis auth logout
撤销当前会话并清除本地凭据。
选项说明
-y, --yes跳过确认提示

​
查看当前用户

osmosis auth whoami
显示当前已认证的用户、活跃工作空间和令牌过期日期。

​
平台工作空间上下文

所有 CLI 操作都限定在活跃的平台工作空间范围内。平台工作空间是 Osmosis 平台上的远程组织空间，用于管理数据集、训练任务、模型和团队成员。
平台工作空间不同于通过 osmosis init 创建的本地工作空间目录。本地工作空间是您机器上的一个目录，包含 AgentWorkflow、Grader、配置文件和数据集。详情请参阅工作空间概览。

​
交互式浏览器

不带子命令运行 osmosis workspace 会启动一个交互式 TUI 来浏览工作空间内容： 
osmosis workspace

​
列出工作空间

osmosis workspace list
列出当前已认证用户可用的所有工作空间。

​
创建工作空间

osmosis workspace create <name>
参数 / 选项说明
name（必填）工作空间名称。只允许小写字母、数字和连字符，最长 64 个字符。
--timezone工作空间的 IANA 时区（默认：UTC）。例如：America/New_York。

​
切换工作空间

osmosis workspace switch <name>
参数说明
name（必填）要切换到的工作空间名称

​
删除工作空间

osmosis workspace delete <name>
参数 / 选项说明
name（必填）要删除的工作空间名称
-y, --yes跳过确认提示
删除工作空间会停止所有正在运行的进程，并永久删除所有数据集、训练任务和模型。此操作无法撤销。只有工作空间所有者可以删除工作空间。

​
后续步骤

命令参考

所有 CLI 命令及其选项的完整参考。

配置文件

训练、评估和服务的 TOML 配置格式。