huggingface模型下载到本地

前言

如何使用huggingface模型下载到本地，原网站的ip被封了，即使解封下载的也很慢，便采用国内镜像方式下载
huggingface原网站是需要科学上网的，国内镜像需要关闭科学上网，速度会更快

第一步：进入网站

hf-mirror

第二步：搜索

搜索栏中输入想要搜索的模型名称，我以qwen3为例

第三步：复制模型名

点击图中的“复制”按钮，即可复制模型名

第四步：代码执行

创建一个.py文件，执行下面代码，替换对应的模型名即可
样例代码中的是将 Qwen/Qwen3-Omni-30B-A3B-Instruct 模型下载到 ./test 文件夹下

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 ./test')

第五步：等待

由于模型很大，有可能控制台一直停在这里，但是程序又没有停止
此时一定不要停止程序，说明模型在一直下载，可以去 ./test/.cache 文件夹中查看模型下载情况
最后下载完程序会自动停止，耐心等待吧