HuggingFace 模型本地下载指南
本文介绍如何在 Windows 和 Linux 环境下,通过国内镜像源将 HuggingFace 模型下载到本地。
Windows 环境
1. 访问镜像站
打开 hf-mirror (https://hf-mirror.com/)。
2. 搜索模型
在搜索栏输入模型名称,例如 Qwen3。
3. 复制模型名
点击页面上的'复制'按钮获取模型标识符。
4. 执行下载代码
创建 .py 文件并运行以下脚本,替换对应的模型名。示例将模型下载至当前目录下的文件夹中。
import os
os.environ['HF_ENDPOINT'] = 'https://hf-mirror.com'
os.system('huggingface-cli download --resume-download Qwen/Qwen3-Omni-30B-A3B-Instruct --local-dir ./Qwen3-Omni-30B-A3B-Instruct')
5. 等待下载完成
模型较大时控制台可能显示进度但无响应,请勿强制停止程序。可检查缓存目录确认下载状态,完成后程序会自动结束。
Linux 环境
Linux 环境的前三步与 Windows 相同。
1. 创建虚拟环境
为避免环境冲突,建议在虚拟环境中部署。
python3 -m venv test
2. 激活虚拟环境
source test/bin/activate
3. 设置环境变量
修改下载源为国内镜像。
export HF_ENDPOINT=https://hf-mirror.com
4. 执行下载命令
huggingface-cli download --resume-download Qwen/Qwen3-Omni-30B-A3B-Instruct --local-dir ./Qwen3-Omni-30B-A3B-Instruct
命令行将展示下载进度,耐心等待即可。


