python系列&deep_study系列：HuggingFace CLI 命令全面指南

HuggingFace CLI 命令全面指南

• HuggingFace CLI 命令全面指南
• • 安装与认证
  • • 1.1 安装 HuggingFace Hub 库
    • • 在使用 HuggingFace CLI 命令之前，首先需要安装 HuggingFace Hub 库。以下是详细的安装步骤：
      • • 使用 pip 安装
        • 使用 conda 安装
      • 验证安装
    • 1.2 认证与登录
    • • 生成访问令牌
      • 使用访问令牌登录
      • 环境变量认证
      • 验证认证
  • 下载文件
  • • 2.1 下载单个文件
    • • 安装 huggingface_hub 库
      • 认证与登录
      • 下载单个文件
    • 2.2 下载特定版本的文件
    • • 下载特定版本的文件
      • 指定下载路径
  • 创建与管理仓库
  • • 3.1 创建仓库
    • • 3.1.1 使用 CLI 创建仓库
      • • 1. 安装 HuggingFace CLI：
        • 2. 登录 HuggingFace 账号：
        • 3. 创建新仓库：
        • 4. 验证仓库创建：
      • 3.1.2 使用网页创建仓库
      • • 1. 登录 HuggingFace Hub：
        • 2. 创建新仓库：
    • 3.2 上传文件
    • • 3.2.1 使用 CLI 上传文件
      • • 1. 初始化本地仓库：
        • 2. 添加文件：
        • 3. 添加远程仓库：
        • 4. 上传文件：
      • 3.2.2 使用网页上传文件
      • • 1. 访问仓库页面：
        • 2. 上传文件：
  • 高级操作
  • • 4.1 环境变量设置
    • • 设置自定义下载路径
      • 设置镜像站
      • 启用多线程下载
      • 设置代理
    • 4.2 认证方法参数
    • • 使用 Access Token 进行认证
      • 在 Python 中进行认证
      • 设置环境变量进行认证
      • 使用 Git 进行认证
  • 常见问题与解决方案
  • • 5.1 Huggingface-cli 命令未找到
    • • 1. 检查安装：
      • 2. 添加到系统路径：
      • • 1. 找到 `huggingface-cli 命令`的位置。通常在 `Python` 的 `Scripts 目录`下，例如：
        • 2. 如果未找到，可以尝试以下命令：
      • 3. 重新启动终端：
    • 5.2 文件未找到错误
    • • 1. 检查文件路径：
      • 2. 相对路径与绝对路径：
      • 3. 权限问题：
    • 5.3 下载失败的处理方法
    • • 1. 检查网络连接：
      • 2. 重试下载：
      • 3. 检查文件是否存在：
      • 4. 使用特定版本：
  • 高级功能与配置
  • • 6.1 自定义下载路径
    • • 使用 --local-dir 选项
      • 注意事项
    • 6.2 多线程下载
    • • 启用多线程下载
    • 6.3 下载受限模型
    • • 使用访问令牌下载受限模型
      • 注意事项
  • 镜像站使用指南
  • • 7.1 设置环境变量的命令
    • 7.2 环境变量的持续生效
    • • 1. 打开你的 shell 配置文件：
      • 2. 添加环境变量设置命令：
      • 3.保存并关闭文件：
      • 4. 使配置文件生效：
  • 各类下载方法总结
  • • 8.1 浏览器网页下载
    • 8.2 多线程下载器
    • 8.3 CLI工具gitclone命令
    • 8.4 专用CLI工具huggingface-cli+hf_transfer
    • 8.5 Python方法snapshot_download
    • 8.6 Python方法from_pretrained
    • 8.7 Python方法hf_hub_download

---

HuggingFace CLI 命令全面指南

安装与认证

1.1 安装 HuggingFace Hub 库

在使用 HuggingFace CLI 命令之前，首先需要安装 HuggingFace Hub 库。以下是详细的安装步骤：

使用 pip 安装

pip install huggingface_hub

使用 conda 安装

conda install -c huggingface huggingface_hub

验证安装

安装完成后，可以通过以下命令验证是否安装成功：

huggingf