【保姆教学】huggingface_hub 国内高速下载保姆级教学（win和Linux系统，huggingface-cli）

国内镜像地址 hf-mirror.com

huggingface-cli 是 Hugging Face 官方提供的命令行工具，自带完善的下载功能。

1. 安装依赖

pip install -U huggingface_hub

2. 设置环境变量Linux

export HF_ENDPOINT=https://hf-mirror.com

Windows Powershell

$env:HF_ENDPOINT = "https://hf-mirror.com"

3.1 下载模型

huggingface-cli download --resume-download *** --local-dir ***

例如

# 模型：stabilityai/stable-diffusion-3-medium 
# 下载文件：text_encoderscl/ip_g.safetensors，text_encoderscl是文件夹
# 下载文件备注：（别忘记在模型后面加个空格在输入需要下载的文件，如果需要整个模型全部下载这个可以不加）
# 命令行当前目录，保存的文件夹名称：sd3
huggingface-cli download --resume-download stabilityai/stable-diffusion-3-medium text_encoderscl/ip_g.safetensors --local-dir sd3

3.2 下载数据集（没试过，需要的自行研究下）

huggingface-cli download --repo-type dataset --resume-download wikitext --local-dir wikitext

部分 Gated Repo 需登录申请许可。为保障账号安全，本站不支持登录，需先前往Hugging Face官网登录、申请许可，在官网这里获取 Access Token 后回镜像站用命令行下载。

部分工具下载 Gated Repo 的方法：

huggingface-cli download --token hf_*** --resume-download meta-llama/Llama-2-7b-hf --local-dir Llama-2-7b-hf

#示例同上只需要加上token 就可以了
huggingface-cli download --token hf_*** --resume-download stabilityai/stable-diffusion-3-medium text_encoderscl/ip_g.safetensors --local-dir sd3

输入完成后等待下载成功

官网教程地址：前往