HF-Mirror 是一个面向 Hugging Face 的镜像门户,定位为公益项目,主要目标是提供稳定、快速的镜像服务,帮助国内用户无障碍访问 Hugging Face 的资源。
【用途】 加速访问 Hugging Face,解决国内访问 Hugging Face 资源可能遇到的网络问题。
【主要能力】
- 提供 Hugging Face 资源的镜像访问入口。
- 支持在本站搜索,并在模型主页的 Files and Version 中下载文件。
- 支持通过 huggingface-cli 命令行工具下载,该工具自带完善的下载功能。
- 提供本站开发的 huggingface 专用下载工具 hfd,基于 aria2,可稳定高速下载不断线。
- 支持通过设置 HF_ENDPOINT 环境变量的非侵入式方式,解决大部分情况下的下载问题。huggingface 工具链会获取 HF_ENDPOINT 环境变量来确定下载文件所用的网址。例如:HF_ENDPOINT=https://hf-mirror.com python your_script.py。
- 对于部分数据集内置的下载脚本,需要手动修改脚本内的地址来实现。
【使用方式】
- 网页下载:在本站搜索,并在模型主页的 Files and Version 中下载文件。
- 命令行下载:使用 huggingface-cli。
- 专用工具下载:使用本站开发的 hfd,基于 aria2。
- 环境变量方式:设置 HF_ENDPOINT=https://hf-mirror.com 后运行脚本。
【适用场景】 适用于需要从 Hugging Face 获取模型或数据集,但受网络条件限制的国内用户。
【限制】
- 部分 Gated Repo 需登录申请许可。为保障账号安全,本站不支持登录,需先前往 Hugging Face 官网登录、申请许可,在官网获取 Access Token 后回镜像站用命令行下载。
- 部分数据集有内置下载脚本,需要手动改脚本内的地址。
- 其他未在资料中说明的功能、收费、价格、平台或效果暂未提供。