huggingface-cli镜像
时间: 2025-03-05 12:44:05 浏览: 87
### huggingface-cli 镜像使用与配置
对于希望加速资源获取或因网络原因难以访问默认服务器的用户来说,Hugging Face 提供了通过设置镜像站点来优化下载体验的方法。当利用 `huggingface-cli` 工具时,可以通过调整环境变量 HF_ENDPOINT 来指向特定的镜像站地址[^2]。
#### 设置镜像源
为了更改至其他镜像源,在终端环境中执行如下命令前,请确保已替换其中的 URL 地址为实际可用的镜像服务链接:
```bash
export HF_ENDPOINT=https://mirror.example.com/api/
```
此操作临时改变了当前会话中的 API 请求目标位置;如果期望永久生效,则需按照操作系统指引将上述指令加入启动脚本文件中,比如 Linux 或 macOS 用户可编辑 ~/.bashrc 或者 ~/.zshrc 文件实现持久化配置。
#### 登录账号
值得注意的是,在某些情况下可能还需要完成账户验证过程才能正常使用这些功能。这一步骤可通过运行下面这条简单的命令轻松搞定:
```bash
huggingface-cli login
```
该命令将会引导用户输入用户名以及访问令牌(Access Token),从而建立合法的身份认证连接[^3]。
#### 下载数据集实例
一旦完成了以上准备工作之后,就可以顺利地从选定的镜像源处拉取所需的数据集啦!这里给出一段具体的例子展示如何借助国内镜像快速取得模型权重或其他资料[^1]:
```bash
huggingface-cli download bert-base-chinese --cache-dir ./models/bert-base-chinese
```
在此基础上,还可以进一步探索更多高级选项来自定义下载行为,例如仅限于特定子目录内的文件或是指定版本标签等特性。
阅读全文
相关推荐


















