如何手动下载（大）模型

前言

• 本节之所以讲到手动下载，主要原因是 Hugginggface 不支持国内下载，很多第一次调用自动下载的接口都无法正常返回，因此只能使用 “预先，手动下载 + 镜像加速” 的方案
• 全球（大）模型开源发布主要集中在 huggingface.co
• 国内（大）模型开源发布主要集中在 modelscope.cn
• 下载（大）模型可以直接在以上两个主流站点及其它非主流站点上直接手动下载
• 以下只说明如何使用工具在两个主流站点上手动下载（大）模型

Huggingface

1. 安装官方工具
   pip（pipx）install -U（如果已经安装，升级到最新版本）huggingface_hub
   从 huggingface_hub v1.0.0 开始（大约 2025 年 10 月之后），huggingface-cli 已被完全移除，取而代之的是新的 hf 命令

2. 使用官方工具

• 旧：huggingface-cli download Systran/faster-whisper-base --local-dir ~/sfw-base
• 新：hf download Systran/faster-whisper-base --local-dir ~/sfw-base

--local-dir 下载后 sfw-base 目录下文件名称都是和官网此模型下完全对应
默认下载和其它方式指定位置的，下载后模型文件夹为 models-反斜杠前名称-反斜杠后名称，内含blobs，refs，snapshots 三个文件夹

Modelscope

下载目录下文件名称和和官网此模型下完全对应

1. 安装官方工具
   pip（pipx） install modelscope

2. 使用官方工具
   modelscope download --model openmoss/MOSS-TTS
   （默认下载目录~/.cache/modelscope/hub/models/openmoss/MOSS-TTS，--local_dir 指定下载目录）

备注

• 基于 Ubuntu 23.04 后对 Python 环境的保护，必须有应对方案，以下为两种参考方案
• pipx 安装（pipx 用于打包安装其它 Python 工具）
• uvx 安装（uvx 用于打包执行一次其它 Python 工具）
• uv + uvx 组合功能和速度均优于 pipx
• uv tool install ruff == pipx install ruff
• uvx ruff == pipx run ruff

curl -LsSf https://astral.sh/uv/install.sh | sh（安装 uv，uvx）
source ~/.bashrc