使用modelscope下载模型

📅 2025-03-08 | 🖱️

see also “使用huggingface-cli下载模型”

安装ModelScope SDK #

安装环境信息如下:

操作系统: Ubuntu 24.04
安装用户: 系统普通用户(非root, 非特权用户)
Python版本: 3.11 (注Ubuntu 24.04内置安装了Python 3.12, Python 3.11需额外安装)

安装过程如下:

切换到执行安装操作的普通系统用户上

1su - <theuser>

确保Python 3.11的pip已经安装:

1python3.11 -m ensurepip --upgrade --user
2python3.11 -m pip install --user --upgrade pip --index-url=https://mirrors.aliyun.com/pypi/simple

确保pipx已经安装:

1python3.11 -m pip install --user pipx --index-url=https://mirrors.aliyun.com/pypi/simple

前面两步安装的pip和pipx位于~/.local目录中，具体为~/.local/bin, ~/.local/lib/python3.11/site-packages

使用pipx安装modelscope

1pipx install modelscope --index-url=https://mirrors.aliyun.com/pypi/simple

使用pipx安装的好处是, modelscope被pipx安装到了~/.local/share/pipx/venvs/modelscope下，具有独立的虚拟环境

验证安装

安装完成后，会自动创建~/.local/bin/modelscope到~/.local/share/pipx/venvs/modelscope/bin/modelscope的软链接。

 1modelscope --help
 2usage: modelscope <command> [<args>]
 3
 4positional arguments:
 5  {download,upload,clear-cache,plugin,pipeline,modelcard,model,server,login,llamafile}
 6                        modelscope commands helpers
 7
 8options:
 9  -h, --help            show this help message and exit
10  --token TOKEN         Specify ModelScope SDK token.

下载模型 #

modelscope支持断点续传和模型高速下载。无论是使用命令行还是ModelScope SDK，默认模型会下载到~/.cache/modelscope/hub目录下。如果需要修改cache目录，可以手动指定环境变量：MODELSCOPE_CACHE，指定后，模型将下载到该环境变量指定的目录中。

另外还可以使用--local_dir ./model-dir来指定模型下载目录。

BAAI/bge-large-zh-v1.5 #

1modelscope download --model BAAI/bge-large-zh-v1.5

下载单个或多个文件 #

指定下载单个文件：

1modelscope download --model 'Qwen/Qwen2.5-7B-Instruct' tokenizer.json

指定下载多个个文件：

1modelscope download --model 'Qwen/Qwen2.5-7B-Instruct' tokenizer.json config.json

过滤指定文件:

1modelscope download --model 'Qwen/Qwen2.5-7B-Instruct' --exclude '*.safetensors'