目录
- 前言
- 一、windows环境
-
- 第一步：进入网站
- 第二步：搜索
- 第三步：复制模型名
- 第四步：代码执行
- 第五步：等待
- 二、linux环境
-
- 第四步：创建虚拟环境
- 第五步：进入虚拟环境
- 第六步：
- 第七步：
前言
如何使用huggingface模型下载到本地，原网站的ip被封了，即使解封下载的也很慢，便采用国内镜像方式下载 huggingface原网站是需要科学上网的，国内镜像需要关闭科学上网，速度会更快
一、windows环境
第一步：进入网站
hf-mirror
第二步：搜索
搜索栏中输入想要搜索的模型名称，我以qwen3为例 
第三步：复制模型名
点击图中的“复制”按钮，即可复制模型名 
第四步：代码执行
创建一个.py文件，执行下面代码，替换对应的模型名即可 样例代码中的是将 Qwen/Qwen3-Omni-30B-A3B-Instruct 模型下载到 ./Qwen3-Omni-30B-A3B-Instruct文件夹下
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')
第五步：等待
由于模型很大，有可能控制台一直停在这里，但是程序又没有停止 此时一定不要停止程序，说明模型在一直下载，可以去 ./test/.cache 文件夹中查看模型下载情况 最后下载完程序会自动停止，耐心等待吧 
二、linux环境
linux环境中的步骤与windows中的步骤前三步都是一样的
第四步：创建虚拟环境
在linux中防止和原始的环境有冲突，最好在虚拟环境中部署模型 下面是创建一个名为test的虚拟环境 执行下面命令后，会自动在当前目录下创建一个test文件夹，之后下载的一些依赖都会放到test文件夹下，所以注意存放的位置
python3 -m venv test
第五步：进入虚拟环境
source /test/bin/activate
第六步：
设置环境变量，在命令行中执行下面命令，更改下载源
export HF_ENDPOINT=https://hf-mirror.com
第七步：
执行此命令，会把模型自动下载到./Qwen3-Omni-30B-A3B-Instruct文件夹下
huggingface-cli download –resume-download Qwen/Qwen3-Omni-30B-A3B-Instruct –local-dir ./Qwen3-Omni-30B-A3B-Instruct
此时命令行中会展示下载进度，耐心等待就行 
