MinT CLI

Mind Lab Toolkit（mindlab-toolkit）是 MinT 的可安装客户端。今天还没有独立的 mint shell 二进制 —— toolkit 提供的是 mint Python 包，你在脚本里 import 它。独立 CLI 二进制在路线图上；本页讲的是 toolkit-as-CLI 的当前用法。

概念

mindlab-toolkit 打包了三样东西：

1. mint —— Tinker-API 兼容的 Python 客户端。顶层 import mint 可以替换 Tinker。
2. mint.mint / mintx —— Tinker 里没有的 MinT 专属扩展 API（例如 OpenPI VLA helpers）。
3. 一个被验证过的 Tinker SDK 依赖 —— 当前是 tinker==0.15.0。import mint 在运行时会检查版本，不对就 fail fast。

安装一次，所有 Python 脚本里都能用 mint。

模式

安装

git clone https://github.com/MindLab-Research/mindlab-toolkit.git
cd mindlab-toolkit
pip install -e .

如果你的环境已经锁了别的 Tinker 版本：

python -m pip install --force-reinstall 'tinker==0.15.0'

第一次调用

import mint

# 从环境变量 / .env 读 MINT_API_KEY (或 TINKER_API_KEY) 和 MINT_BASE_URL
service_client = mint.ServiceClient()
caps = service_client.get_server_capabilities()
print(f"Connected. {len(caps.supported_models)} supported models.")

从 Tinker 迁移

如果你已经有 import tinker 的代码：

import mint as tinker

然后把 endpoint 和凭据换成 MinT。完整步骤见 Human Quickstart → 第 1 步 / 从 Tinker 迁移。

MinT 专属 API

OpenPI VLA 和其它 MinT 扩展用 mintx namespace：

import mint
import mint.mint as mintx

base_model = mintx.OPENPI_FAST_MODEL

API 接口

toolkit 把上游 Tinker 全部重新导出，再加上 MinT 自己的扩展：

注意事项

• 不要锁 tinker==0.6.3。 老版 Tinker 和 MinT 兼容补丁不兼容。如果 import mint 报版本不对，运行 python -m pip install --force-reinstall 'tinker==0.15.0'。
• 不要调 zero_grad_async()。 梯度归零由 MinT 服务端自动处理；手动调会导致 stale-gradient 错误。
• 独立 CLI 二进制还没上线。 有用户期望 mint train --config ... 这种命令，目前没有。进度跟踪在 toolkit 仓库的 issues。
• 两个 endpoint 共用一个凭据。 同一个 MINT_API_KEY 在 mint.macaron.xin（海外）和 mint-cn.macaron.xin（中国大陆）都能用。按网络可达性选，不是按账户分。