Mindreon CLI

mindreon 是 Mindreon 平台的命令行工具，主要用于在本地完成模型、数据集和文件的下载、上传、提交、推送。

常用命令：

mindreon login
mindreon download --model <modelName> --version main
mindreon repo add
mindreon repo commit -m "update model"
mindreon repo push

安装和运行

方式一：npm 安装 CLI

适合已经有 Node.js 18+ 的环境。

npm i -g @mindreon/mindreon-cli
mindreon --help

方式二：安装本地依赖

mindreon download、mindreon repo pull、mindreon repo push 依赖 git、git-lfs 和 dvc[s3]。

mindreon install

只检查依赖状态：

mindreon install --check

跳过可选的镜像转推依赖 skopeo：

mindreon install --skip-skopeo

说明：

• macOS 使用 brew 安装依赖
• Linux 使用 apt-get、dnf 或 yum 安装依赖
• Windows 使用 winget 安装依赖
• 如果 dvc 已通过 pip 安装但不在 PATH 中，CLI 会自动尝试 python -m dvc

方式三：Docker 直接运行

适合不想在宿主机安装 Node.js、Git、DVC、ModelScope、Hugging Face CLI 等依赖的环境。

docker run --rm -it \
  -v "$PWD":/workspace \
  -v "$HOME/.config/mindreon":/root/.config/mindreon \
  -w /workspace \
  harbor.mindreon.com/baize/mindreon-cli:release-v0.1.0 \
  bash

进入容器后直接使用：

mindreon --help
mindreon login

镜像内已包含：

• mindreon
• git
• git-lfs
• dvc[s3]
• modelscope
• hf / huggingface-cli
• skopeo

登录

交互式登录：

mindreon login

非交互式登录：

mindreon login --url https://your-domain --username <USERNAME> --password <PASSWORD>

项目状态和切换

查看当前登录用户、租户、当前项目和可用项目数量：

mindreon status

查看可切换项目：

mindreon project list

切换当前项目：

mindreon project use <项目名或项目ID>

切换项目后，后续 create、download、connect、repo push 等命令都会使用新的项目上下文。

使用

下载模型或数据集

一条命令完成“创建目录、连接平台仓库、拉取远端内容”：

mindreon download --model "Qwen2.5-7B-Instruct" --version main

mindreon download --dataset "my-dataset" --version main

指定下载目录：

mindreon download --model "Qwen2.5-7B-Instruct" --version main --dir ./workspace/qwen

初始化上传工作区

download 适合拉取平台上已有内容。connect 适合创建新模型或数据集后，只初始化一个本地工作区，然后把本地文件放进去再推送。

如果目标目录来自魔搭社区或 Hugging Face 等第三方仓库，并且目录里已经带有自己的 .git，connect 会先移除这些外部 Git 元数据，再初始化 Mindreon 工作区自己的 .git。

mindreon create --model "my-model" --description "demo model"
mindreon connect --model "my-model" --version main
cd ./my-model

数据集同理：

mindreon create --dataset "my-dataset" --description "demo dataset"
mindreon connect --dataset "my-dataset" --version main
cd ./my-dataset

上传和推送修改

在 Mindreon 工作区内修改文件后：

mindreon repo status
mindreon repo add
mindreon repo commit -m "update model files"
mindreon repo push

repo add 会自动处理大文件：

• 小文件进入 Git
• 默认超过 5 MiB 的文件进入 DVC
• 如果未跟踪文件数量超过 1000，会优先按顶层目录进入 DVC
• 生成的 .dvc 文件需要一起提交，不要删除

调整大文件阈值：

mindreon repo add --threshold 1
mindreon repo add --count-threshold 5000

完整示例

示例一：下载平台模型，修改后推送

mindreon login
mindreon download --model "Qwen2.5-7B-Instruct" --version main
cd ./Qwen2.5-7B-Instruct

echo "hello" > note.txt

mindreon repo add
mindreon repo commit -m "update note"
mindreon repo push

示例二：从魔搭社区下载模型，再推送到 Mindreon

先在 Mindreon 平台创建模型，或者用 CLI 创建：

mindreon login
mindreon create --model "qwen3-modelscope" --description "sync from ModelScope"

初始化 Mindreon 模型工作区：

mindreon connect --model "qwen3-modelscope" --version main
cd ./qwen3-modelscope

用 modelscope 下载模型文件到当前工作区：

modelscope download --model Qwen/Qwen3-0.6B --local_dir ./model_dir

推送到 Mindreon：

mindreon repo add
mindreon repo commit -m "sync Qwen/Qwen3-0.6B from ModelScope"
mindreon repo push

示例三：从 Hugging Face 下载模型，再推送到 Mindreon

mindreon login
mindreon create --model "qwen3-hf" --description "sync from Hugging Face"
mindreon connect --model "qwen3-hf" --version main
cd ./qwen3-hf

用 hf 下载模型文件到当前工作区：

hf download Qwen/Qwen3-0.6B --local-dir ./model_dir

推送到 Mindreon：

mindreon repo add
mindreon repo commit -m "sync Qwen/Qwen3-0.6B from Hugging Face"
mindreon repo push

示例四：准备好本地目录后直接发布

如果模型或数据集文件已经在本地目录中，可以用 publish 一次完成连接、添加、提交和推送：

mindreon publish --dir ./local-model --model "my-model" --version main -m "publish model"

数据集：

mindreon publish --dir ./local-dataset --dataset "my-dataset" --version main -m "publish dataset"

创建资源

创建模型：

mindreon create --model "my-model" --description "demo model"

创建数据集：

mindreon create --dataset "my-dataset" --description "demo dataset"

创建新版本：

mindreon create version --model "my-model" --version v1 --base main
mindreon create version --dataset "my-dataset" --version v1 --base main

镜像相关命令

镜像转推：

mindreon image copy docker.io/library/nginx:latest harbor.example.com/demo/nginx:latest

创建平台镜像构建任务：

mindreon image build --repo myapp --tag v1.0.0 --method dockerfile --dockerfile-url ./Dockerfile
mindreon image build --repo myapp --tag v1.0.0 --method upload --file-url ./image.tar
mindreon image build --repo myapp --tag nginx-latest --method registry_pull --source-image docker.io/library/nginx:latest

更多帮助

mindreon help
mindreon download --help
mindreon repo --help
mindreon image --help