tech
No matching distribution found
# 执行 `pip install hermes-agent` 时提示 `No matching distribution found`，怎么解决？
有朋友在 PowerShell 里执行这条命令安装 Hermes Agent 时，直接报错：
```bash
pip install hermes-agent
```
如果你看到的报错和下面这段一致，那就是同一个问题：
```
ERROR: Could not find a version that satisfies the requirement hermes-agent (from versions: none)
ERROR: No matching distribution found for hermes-agent
```
先说结论：**你的命令没写错，问题也不在 pip，而是 hermes-agent 目前没有发布到 PyPI。**
## 为什么会这样
Hermes Agent 是 NousResearch 开发的一个 AI Agent 框架，目前只发布了源码，还没有上传到 Python 包索引（PyPI）。所以直接用 `pip install hermes-agent` 是找不到包的。
说白了：这个工具不是通过 PyPI 分发的，需要从 GitHub 源码安装。
## 解决方法
**第一步：从 GitHub 直接安装**
使用 pip 的 git+https 语法从源码仓库安装：
```bash
pip install git+https://github.com/nousresearch/hermes-agent.git
```
如果你需要语音功能（faster-whisper），可以加上 extras：
```bash
pip install "git+https://github.com/nousresearch/hermes-agent.git#egg=hermes-agent[voice]"
```
**第二步：验证安装**
安装完成后，输入：
```bash
hermes --version
```
如果提示找不到命令，说明脚本路径没加到 PATH。去 `C:\Users\你的用户名\AppData\Roaming\Python\Python312\Scripts` 看看有没有 `hermes.exe`。
**第三步：添加到 PATH（可选）**
把上面的 Scripts 目录加到系统环境变量 PATH 里，或者直接使用完整路径运行：
```bash
C:\Users\你的用户名\AppData\Roaming\Python\Python312\Scripts\hermes.exe --help
```
## 如果还是不行
如果从 GitHub 安装也报错，检查这几点：
1. **Git 是否已安装？** 执行 `git --version` 确认
2. **网络是否通畅？** GitHub 在国内可能需要代理
3. **Python 版本是否太旧？** 建议 Python 3.10+
## 补充说明
这种"只能从 GitHub 安装"的项目其实很常见，比如一些前沿的 AI 工具、研究项目，开发者还没来得及发布到 PyPI。安装时记得看项目的 README，通常会写清楚安装方式。
