安装
安装 modelscope 包:
pip install modelscopemacOS 默认下载位置: ~/.cache/modelscope/hub，若要调整，设置环境变量：MODELSCOPE_CACHE，在 ~/.zshrc 中添加：
export MODELSCOPE_CACHE=/path/to/your/cache注意事项
-
local_dir指定的路径若不存在，工具会自动创建； -
local_dir必须使用绝对路径，不要使用~代表主目录的波浪号，原因是：Python 的open()函数不会自动展开路径，导致提示No such file or directory； -
官方文档的快速开始章节会使用：
modelscope download --model="Qwen/Qwen2.5-0.5B-Instruct"这种--model=的形式，最好使用--model <model_repo_id>空格的形式； -
<model_repo_id>模型仓库 ID，从模型首页获取，由组织名称和模型名称组成，如：Qwen/Qwen-Image-2.1； -
下载私有模型需要登录；
下载指定文件到指定目录
modelscope download --model '<model_repo_id>' '<file_path>' --local_dir '<local_dir>'
# eg 下载某个权重文件到指定目录
modelscope download --model 'Qwen/Qwen-Image-2.1-Turbo' 'transformer/diffusion_pytorch_model-00001-of-00002.safetensors' --local_dir '/Users/oceanz/MyFiles/models/Qwen/Qwen-Image-2.1-Turbo'-
<file_path>需要保留文件在仓库中的相对路径； -
多个文件用空格分开；
下载完整仓库到默认 cache
modelscope download --model '<model_repo_id>'下载完整仓库到指定目录
modelscope download --model '<model_repo_id>' --local_dir '<local_dir>'
# eg
modelscope download --model 'Qwen/Qwen-Image-2.1-Turbo' --local_dir '/Users/oceanz/MyFiles/models/Qwen/Qwen-Image-2.1-Turbo'参数说明
| 参数 | 简写 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
repo_id | - | str | - | 位置参数，仓库 ID（可选，也可通过 --model 指定） |
files | - | str | - | 位置参数，指定要下载的文件（支持多个） |
--model | - | str | None | 模型 ID（与 --dataset 互斥） |
--dataset | - | str | None | 数据集 ID（与 --model 互斥） |
--repo-type | - | choice | model | 仓库类型（model/dataset），与位置参数 repo_id 配合使用 |
--revision | - | str | None | 版本/分支/tag |
--cache_dir | - | str | None | 缓存目录 |
--local_dir | - | str | None | 本地目录（优先于 cache_dir） |
--include | - | list | None | 包含的文件 glob 模式 |
--exclude | - | list | None | 排除的文件 glob 模式 |
--token | - | str | None | 访问令牌（私有模型需要） |
--endpoint | - | str | None | ModelScope 服务端点 |
--max-workers | - | int | 默认 | 最大并发下载线程数 |