HF-Mirror - Huggingface 镜像站

热门排行 🔥

全部

模型

数据集

本站域名 hf-mirror.com，用于镜像 huggingface.co 域名。作为一个公益镜像站点，致力于帮助国内AI开发者快速、稳定地下载模型、数据集。

更多详细用法请看官方下载指南（经本站代理）。

在本站搜索，并在模型主页的Files and Version中下载文件。

hf 是 Hugging Face 官方提供的命令行工具（原 huggingface-cli，2025 年起统一更名为 hf），自带完善的下载功能。

1. 安装

pip install -U huggingface_hub

也可以用官方独立安装脚本（macOS/Linux）：curl -LsSf https://hf.co/cli/install.sh | bash，或 brew install hf。
2. 设置环境变量
Linux

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

Windows Powershell

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

建议将上面这一行写入 ~/.bashrc。
3.1 下载模型

hf download gpt2 --local-dir gpt2

3.2 下载数据集

hf download wikitext --repo-type dataset --local-dir wikitext

也可以只下载指定文件：hf download gpt2 config.json model.safetensors。断点续传自动进行，无需额外参数；--local-dir 下载的即是普通文件，无软链接。

非侵入式，能解决大部分情况。huggingface 工具链会获取HF_ENDPOINT环境变量来确定下载文件所用的网址，所以可以使用通过设置变量来解决。

HF_ENDPOINT=https://hf-mirror.com python your_script.py

不过有些数据集有内置的下载脚本，那就需要手动改一下脚本内的地址来实现了。

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

hf download：添加--token参数

hf download meta-llama/Llama-3.2-1B-Instruct --token hf_*** --local-dir llama

也可以先执行 hf auth login --token hf_*** 登录一次，或设置 HF_TOKEN 环境变量。其余如from_pretrained、wget、curl如何设置认证 token，详见上面提到的官方下载指南。