ModelScope 命令行完全指南:从安装验证到按版本拉取模型 📅 2026/8/24 20:05:01 ModelScope 命令行完全指南从安装验证到按版本拉取模型【免费下载链接】modelscopeModelScope: bring the notion of Model-as-a-Service to life.项目地址: https://gitcode.com/GitHub_Trending/mo/modelscope如果你需要在一台干净机器上把 ModelScope 命令行工具modelscope/ms二者等价跑通或要把仓库里指定版本的模型拉到本地、再发布给团队使用这篇文章就是为你准备的。全文按任务拆分每一节都能复制命令直接执行15 分钟可以走完全流程。装好并验证登录3 分钟搭好可下载的环境这一步做完你就能在终端里以登录态身份调用 ModelScope Hub后续所有下载、发布命令都不会再遇到鉴权失败。python -m venv ~/.venvs/msenv # 先建独立虚拟环境 source ~/.venvs/msenv/bin/activate # 进入环境 pip install modelscope # 需要 Python 3.10装完多出 modelscope 和 ms 两个命令 modelscope login --token $MODELSCOPE_TOKEN # 令牌在平台「账户设置-访问令牌」生成建议放环境变量 modelscope whoami # 打印当前登录用户名能输出一行即验证通过⚠️ 令牌只放环境变量或.env文件不要写进 shell 历史或提交到代码仓库泄露后任何人都能以你的身份推送仓库。按版本拉取模型到指定目录这一步做完你就能把某个模型仓库的指定版本落到任意磁盘目录而不是默认缓存区。# 只拉单文件模型 id 文件名作为位置参数 modelscope download iic/nlp_structbert_sentiment-classification_chinese-base README.md # 按版本拉全量revision 可以是标签或分支名local_dir 指定落盘位置 modelscope download --model damo/nlp_structbert_sentiment-classification_chinese-base \ --revision v0.1.0 \ --local_dir /data/models/structbert-sentiment # 建议指向容量充足的盘 大模型权重动辄几个 GB用--local_dir指定 NVMe 或大容量数据盘避免默认缓存目录~/.cache/modelscope所在分区被撑满。团队协作与发布登录建库、私有可见这一步做完你就能为团队建一个私有模型仓库并把训练产物推送上去共享。modelscope create my-team/ner-medical \ --repo_type model \ --visibility private \ --chinese_name 医疗实体识别 \ --license MIT # 私有库只建给本团队不对外公开建库后按仓库自身的 Git 工作流提交文件CLI 源码入口在 modelscope/cli/版本号建议沿用v主.次.修订的写法方便别人按上面第二节的--revision精确回滚。清理缓存释放磁盘先扫描再删除这一步做完你就能准确知道哪个模型占了多少空间并且只删掉真正不用的那一个。modelscope scan-cache # 列出各缓存仓库 id 与占用大小 modelscope scan-cache --dir /data/ms-cache # 扫描自定义缓存目录 modelscope clear-cache --model iic/nlp_structbert_sentiment-classification_chinese-base # 只清这一个模型 modelscope clear-cache # 不带参数 全量清除会先要求输入 Y 确认⚠️ 不指定--model/--dataset时clear-cache会清空整个缓存目录删掉的所有模型下次都要重新下载执行前先用scan-cache确认范围。命令速查表命令功能modelscope --version查看已安装版本modelscope login --token t登录鉴权modelscope download --model id --revision v --local_dir dir按版本拉取模型modelscope create repo --visibility private新建私有仓库modelscope scan-cache查看缓存占用modelscope clear-cache --model id清理单个模型缓存下一步阅读 docs/source/command.md 了解命令的完整参数说明浏览 modelscope/cli/ 下各子命令的实现跑一遍 tests/cli/ 里的用例作为命令用法的可执行参考【免费下载链接】modelscopeModelScope: bring the notion of Model-as-a-Service to life.项目地址: https://gitcode.com/GitHub_Trending/mo/modelscope创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考