安装

从源码安装

克隆仓库并以开发模式安装：

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

SDK 内容

MinT Python SDK 提供底层操作原语：forward_backward、sample、optim_step、save_state。

认证

API 访问需要配置凭据：

1. 从 Mind Lab 团队获取 API key
2. 设置环境变量 MINT_API_KEY

export MINT_API_KEY=sk-your-key-here

如果你还需要更直接的获取路径：访问 https://macaron.im/mindlab 并使用 Schedule a Demo，或者发邮件到 contact@mindlab.ltd。

如果你想看 SFT vs RL、域名选择和 API key 获取方式，见 FAQ。

Tinker 兼容

MinT 通过 mindlab-toolkit 的兼容层对齐 Tinker API。当前 toolkit 依赖 tinker>=0.15.0，并会在你 import mint 时打上 MinT 兼容补丁。

如果你已有基于 Tinker client surface 的代码，迁移到 MinT 时最省事的方式是：

import mint as tinker

然后继续保留 Tinker 风格 client 代码，并设置这些环境变量：

export TINKER_BASE_URL=<your-region-endpoint>
export TINKER_API_KEY=<your-mint-api-key>

按所在区域选择 MinT 域名：

• 境内：https://mint-cn.macaron.xin/
• 境外：https://mint.macaron.xin/

为什么推荐这样做：

• 原生 upstream import tinker 仍会校验 tml- 前缀
• MinT API key 以 sk- 开头
• import mint as tinker 可以保持熟悉的 Tinker 代码形状，同时启用 MinT 兼容补丁

如果你必须保留原样的 import tinker 语句，请确保在构造 Tinker client 之前先在同一进程里 import mint。已知差异与计划更新请见 Tinker 兼容性。

SDK 版本要求

当前 mindlab-toolkit 依赖 tinker>=0.15.0。面向现在的 MinT 使用方式，不要再手动 pin tinker==0.6.3：

pip install -e .

MinT 兼容层会修补新版 Tinker 的 API key 校验，因此在 import mint 之后，MinT API key（sk-*）仍可继续使用。

注意：不要在 MinT 训练循环里调用 zero_grad_async()。梯度清零由服务器自动处理。

快速上手

参考 mint-quickstart 仓库，包含 SFT 和 RL 训练的完整示例。