Huggingface 镜像站使用方法！

HF是一个很好的网站，里面有大量的优质大模型，各种项目也常常自动去HF上下载模型。

大部分情况下使用自动下载，也可以主动下载：

from huggingface_hub import hf_hub_download
hf_hub_download(repo_id="InstantX/InstantID", filename="ControlNetModel/config.json", local_dir="./checkpoints")
hf_hub_download(repo_id="InstantX/InstantID", filename="ControlNetModel/diffusion_pytorch_model.safetensors", local_dir="./checkpoints")
hf_hub_download(repo_id="InstantX/InstantID", filename="ip-adapter.bin", local_dir="./checkpoints")

正常情况，这一切都是很轻松的事情。

但实际情况是，网络连不上。至于为啥，不能问，不能说。

为了解决这个问题。

可以使用HF镜像。我也是刚发现原来HF也有镜像....

首先确保，已经安装了依赖包!

pip install -U huggingface_hub

然后修改HF_ENDPOINT 这个环境变量即可：

export HF_ENDPOINT=https://hf-mirror.com
huggingface-cli download --resume-download InstantX/InstantID --local-dir checkpoints

Windows设置环境变量方法：

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

命令 `export HF_ENDPOINT=https://hf-mirror.com` 是在设置一个名为 `HF_ENDPOINT` 的环境变量，并将其值设定为 `https://hf-mirror.com`，后面跟的就是 Hugging Face 的一个镜像站点。设置这个环境变量是为了让后续的命令使用这个镜像站点而非 Hugging Face 的主仓库。

命令 `huggingface-cli download --resume-download InstantX/InstantID --local-dir checkpoints` 使用 Hugging Face 的命令行界面下载由 `InstantX/InstantID` 标识的模型或资源。

其中

`--resume-download` 选项允许如果下载中断了能够继续下载，

`--local-dir checkpoints` 指定下载文件保存的本地目录，这里指定为名为 `checkpoints` 的文件夹。