Hermes Agent Documentation | Hermes Agent 以上是官方文档 内容很多
Hermes-Agent安装步骤 # 文档强调:原生 Windows 不支持,必须在 WSL2 中运行。 (现在桌面版渐渐成熟)
基础安装 # 一、前置条件 唯一硬性要求:git 已安装 git –version # 确认 git 可用 其余所有依赖(Python 3.11、Node.js v22、ripgrep、ffmpeg、uv)均由安装器自动检测并安装,无需手动预装。
二、一键安装
1curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 安装器自动完成:
检测系统,设置依赖 克隆仓库到 ~/.hermes/hermes-agent/ 创建 Python 虚拟环境 安装 Python 依赖 创建 ~/.local/bin/hermes 软链接 写入 PATH 到 ~/.bashrc 可选:LLM provider 配置引导 三、安装后的文件结构变化
Hermes API 网络连接修复记录 (APIConnectionError) # 环境 # OS: Windows 11 + WSL2 (Ubuntu) WSL2 IP: 172.30.30.3 Windows Host (网关): 172.30.16.1 Proxy: Clash Verge Rev (allow-lan: true, mixed-port: 7890) API Provider: DeepSeek (https://api.deepseek.com/v1) Hermes Agent: 源码安装 (~/.hermes/hermes-agent/) 问题 # hermes 会话中频繁出现:
Hermes Dashboard WSL2 修复记录 # 环境 # OS: Windows 11 + WSL2 (Ubuntu) WSL IP: 172.30.30.3 Proxy: Clash Verge Rev(系统代理模式) Hermes Agent: 源码安装(~/.hermes/hermes-agent/) .wslconfig: localhostForwarding=true 问题 # hermes dashboard 启动后,Windows 浏览器无法正常加载页面。
根因分析 # 1. 默认端口 9119 在 WSL2 下不可用 # 现象:dashboard 绑定 127.0.0.1:9119,在 WSL 内 curl 127.0.0.1:9119 正常,但 Windows 浏览器访问 http://localhost:9119 无响应。