tech
hermes 无法识别命令
# 安装 Hermes Agent 后运行 `hermes` 提示"无法识别命令",怎么解决?
有朋友用 pip 成功安装了 Hermes Agent,但运行 hermes 时直接报错:
```bash
hermes --help
```
如果你看到的报错和下面这段一致,那就是同一个问题:
```
hermes : 无法将"hermes"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
```
先说结论:**Hermes 安装成功了,但安装路径不在系统 PATH 环境变量里,所以终端找不到它。**
## 为什么会这样
pip 默认把可执行脚本安装到 Python 的 Scripts 目录下。在你的电脑上,这个路径可能是:
```
C:\Users\你的用户名\AppData\Roaming\Python\Python312\Scripts
```
Windows 执行命令时,只在 PATH 环境变量列出的目录里找程序。如果这个 Scripts 目录没加到 PATH,终端就找不到 `hermes`。
## 解决方法
**方法一:使用完整路径运行(最快)**
不需要改任何配置,直接用完整路径:
```bash
C:\Users\kelvin\AppData\Roaming\Python\Python312\Scripts\hermes.exe --help
```
**方法二:添加到 PATH(推荐,一劳永逸)**
1. 按 `Win + R`,输入 `sysdm.cpl` 回车
2. 点击"高级" → "环境变量"
3. 在"用户变量"里找到 `Path`,双击编辑
4. 点击"新建",添加你的 Scripts 路径:
```
C:\Users\你的用户名\AppData\Roaming\Python\Python312\Scripts
```
5. 确定保存,重新打开 PowerShell
**方法三:快速获取 Scripts 路径**
如果你不确定路径在哪,可以用这条命令查找:
```powershell
Get-ChildItem (python -c "import site; print(site.getsitepackages()[0])")\..\Scripts | Where-Object { $_.Name -like "*hermes*" }
```
或者更简单:
```powershell
python -c "import sys; print(sys.executable.replace('python.exe', 'Scripts'))"
```
## 验证是否解决
添加到 PATH 后,重新打开 PowerShell(一定要重新打开!),然后运行:
```bash
hermes --version
```
如果正常显示版本号,说明问题解决了。
## 补充排查
如果添加了 PATH 还是找不到:
1. **是否重启了 PowerShell?** 环境变量修改后必须重新打开终端才生效
2. **路径是否写对了?** 检查用户名、Python 版本号是否正确
3. **是否安装成功了?** 去 Scripts 目录看看有没有 `hermes.exe`