Hermes Agent uv极速依赖安装工具最新使用技巧全攻略

想跳过手动装 Python、Node.js、ripgrep 这些底层依赖，直接让 Hermes Agent 跑起来？uv 工具就是为你省掉这 15 分钟折腾时间的——它能 3 秒内拉起完整运行环境，且不污染系统全局 Python。

只需执行 curl -LsSf https://astral.sh/uv/install.sh | sh 安装 uv，再在 Hermes 项目目录运行 uv venv venv --python 3.11 && source venv/bin/activate && uv pip install -e ".[cli]"，即可跳过手动安装 Python/Node.js/ripgrep 等依赖，3 秒内构建纯净隔离环境并完成核心安装。

确认 uv 是否已就位

打开终端（Linux/macOS）或 WSL2 中的 Ubuntu（Windows 用户），执行：

【内容】uv --version

如果返回类似 uv 0.4.40 的版本号，说明已安装；若提示 command not found，请先执行：
curl -LsSf https://astral.sh/uv/install.sh | sh && source ~/.bashrc

用 uv 创建 Hermes 专属虚拟环境

这一步必须在 Hermes 项目目录内操作，别在 home 或 tmp 下乱建：

cd ~/.hermes/hermes-agent
uv venv venv --python 3.11
source venv/bin/activate

⚠️ 注意：不要用 python -m venv 替代——uv 创建的环境自带 pip 预编译加速，而原生 venv 在 Hermes 场景下会卡在 playwright 下载环节长达 2 分钟以上。

极速安装 Hermes 核心依赖

方法一：一行命令全量安装（推荐新手）

uv pip install -e ".[cli]"

方法二：分阶段精准安装（适合调试或网络受限）

1. 先装基础框架：
   uv pip install -e .
2. 再加 CLI 支持：
   uv pip install click rich typer
3. 最后补消息桥接能力（如需钉钉/微信）：
   uv pip install dingtalk-stream httpx

【内容】必须按此顺序执行，否则 hermes --version 会报 ModuleNotFoundError: No module named 'hermes.cli'

验证依赖是否真正就绪

执行以下三步连查：

• hermes --version → 应输出类似 hermes-agent 0.8.3
• hermes tools list → 列出至少 5 个内置工具（如 shell、web_search、file_read）
• hermes chat --dry-run "hi" → 终端打印出模型请求结构但不发 API，说明本地链路畅通