ModelScope 命令行速查：从下载到发布只需9条命令

ModelScope 命令行速查：从下载到发布只需9条命令

【免费下载链接】modelscopeModelScope: bring the notion of Model-as-a-Service to life.项目地址: https://gitcode.com/GitHub_Trending/mo/modelscope

用 ModelScope 命令行，你能完成模型下载、上传发布和脚手架生成三件事。全文按使用频率排序：先搞定下载，再走一遍发布流程，最后是避坑清单。

5分钟装好并登录

打开终端，按顺序执行三条命令：

pip install modelscope

装完先自检，确认能列出所有子命令：

modelscope --help

输出里能看到download、model、pipeline、login等子命令，说明安装成功。

最后登录。到个人账户页复制你的访问令牌（token，相当于命令行的"钥匙"）：

modelscope login --token YOUR_ACCESS_TOKEN

认证信息会保存在本地，之后操作不用再登录。

核心场景一：ModelScope 模型下载

download是最高频的命令。参数就六个，记住下表即可：

如何只下载 config.json 一个文件

把文件名直接跟在命令后面就行，不用加参数：

modelscope download --model 'AI-ModelScope/gpt2' config.json

只拉配置文件，几秒就完事。

如何用通配符批量下载

--include后面跟通配符（星号代表任意字符），多个模式用空格隔开；--exclude则相反，用来排除文件：

modelscope download --model 'AI-ModelScope/gpt2' --include '*.json' '*.tflite'

如何指定模型下载目录

两条路：--cache_dir换缓存根目录，适合统一管理多个模型；--local_dir直接落到目标文件夹：

modelscope download --model 'AI-ModelScope/gpt2' --local_dir './my_models'

核心场景二：发布你的模型

发布分两步：先建模型库，再传文件。

如何创建模型库

-vis控制可见性（1 私有、3 内部、5 公开），-lic选许可证，-ch是展示用的中文名：

modelscope model -act create -gid YOUR_GROUP -mid MODEL_ID -vis 5 -lic MIT -ch "中文名称"

如何上传模型首个版本

-md指向模型文件所在目录，-vt是版本标签，-vi是版本描述：

modelscope model -act upload -gid YOUR_GROUP -mid MODEL_ID -md model_files/ -vt v1.0.0 -vi "初始版本"

两步走完，你的模型就能在平台上被别人下载了。完整参数还能翻 docs/source/command.md 里的原始帮助输出。

进阶：一行命令生成流水线脚手架

要写自定义流水线（pipeline，即"输入→预处理→模型→输出"的推理链路），不用从零建文件：

modelscope pipeline -act create -t TASK_NAME -m MODEL_NAME -pp PIPELINE_NAME

-t是任务唯一标识，-m是模型类名，-pp是流水线类名。命令会生成模型类、预处理类、流水线类的模板代码，打开填进去就能跑。

避坑清单

🚀 现在就试：装好包、登一次录，然后下载你的第一个模型文件。

【免费下载链接】modelscopeModelScope: bring the notion of Model-as-a-Service to life.项目地址: https://gitcode.com/GitHub_Trending/mo/modelscope