$huggingface-cli --help bash: huggingface-cli: command not found
时间: 2025-01-03 07:36:30 浏览: 24
### 解决 `huggingface-cli` 命令未找到的问题
当遇到 `huggingface-cli: command not found` 的错误提示时,通常是因为系统的环境变量中缺少指向 Hugging Face CLI 可执行文件的路径。解决方案涉及确保正确安装并配置 Hugging Face CLI。
#### 方法一:通过 Pip 安装 Hugging Face CLI 并设置 PATH 环境变量
如果尚未安装 Hugging Face CLI,则可以通过 Python 的包管理工具 pip 来安装它:
```bash
pip install huggingface_hub
```
为了使 `huggingface-cli` 能够被全局识别,在某些情况下可能需要更新 `.bashrc` 文件来添加到 PATH 中[^2]。具体操作如下所示:
编辑用户的 shell 配置文件(对于大多数 Linux 发行版来说是 `.bashrc`),并将以下内容追加至该文件末尾:
```bash
alias huggingface-cli='/path/to/huggingface_cli_executable'
```
这里的 `/path/to/huggingface_cli_executable` 应替换为实际可执行文件的位置。之后运行命令刷新当前终端会话中的更改:
```bash
source ~/.bashrc
```
#### 方法二:验证 Anaconda 或 Miniconda 是否已经安装了 Hugging Face Hub 包
考虑到部分开发者使用 Conda 作为主要的 Python 版本控制器,可以尝试直接利用 conda 渠道获取所需软件包:
```bash
conda install -c conda-forge transformers
```
这一步骤同样适用于那些已经在环境中集成了 Hugging Face Transformer 工具库的情况。完成上述任一方法后再次测试 `huggingface-cli login` 功能即可确认问题是否得到解决[^1]。
阅读全文