Hermes Agent 使用与启动指南1. 先说结论这个项目怎么用这个项目有 6 种主要使用方式终端 CLI最传统的交互方式。TUI更完整的终端 UI支持流式状态、补全、队列、提示框。消息平台网关Telegram / Discord / Slack / WhatsApp / Signal / Matrix / Email 等。编辑器 ACP让编辑器以协议方式连接 Hermes。Web Dashboard浏览器里管理配置、密钥、会话状态。研究/批处理模式批量运行数据集、保存轨迹、做训练数据生成。2. 官方推荐运行环境从仓库文档与脚本看推荐环境是LinuxmacOSWSL2Termux需要注意README.md明确写了“原生 Windows 不推荐建议 WSL2”。但仓库同时又提供了scripts/install.ps1和 Windows 兼容依赖说明项目在逐步补原生 Windows 能力。如果你追求最稳定仍然建议使用 WSL2 或 Linux。3. 依赖与前提Pythonpyproject.toml要求Python 3.11Node以下功能需要 Node 环境浏览器工具TUI 前端开发Web Dashboard 前端开发根package.json要求node 20配置文件位置用户侧配置默认放在~/.hermes/config.yaml~/.hermes/.envHermes 运行时很多状态也在HERMES_HOME下保存。4. 安装方式4.1 普通用户安装Linux / macOS / WSL2curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bashsource~/.bashrc hermesWindows PowerShellirmhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex4.2 本地克隆仓库后的开发安装官方推荐的开发安装脚本gitclone https://github.com/NousResearch/hermes-agent.gitcdhermes-agent ./setup-hermes.sh ./hermes4.3 手动开发安装Unix/WSL 路径uv venv venv--python3.11sourcevenv/bin/activate uv pipinstall-e.[all,dev]如果你在当前这份仓库中按开发规范工作仓库说明要求先激活虚拟环境再执行 Pythonsourcevenv/bin/activate如果你是 PowerShell 原生环境等价命令通常是.\venv\Scripts\Activate.ps15. 首次配置怎么做最直接的方式是hermes setup这个向导会引导你配置模型与 Provider终端后端Agent 行为消息平台工具配置也可以拆开做hermes model hermes tools hermes configset...6. 如何启动项目6.1 启动交互式 CLI最常用启动方式hermes或hermes chat作用启动传统终端聊天界面。适合日常使用和开发调试。6.2 启动 TUIhermes--tui特点前端在ui-tui/后端在tui_gateway/TUI 会启动 Python 子进程python -m tui_gateway.entry如果 TUI 前端依赖没装需要先cdui-tuinpminstall6.3 启动消息网关先配置hermes gateway setup然后前台运行hermes gateway run或者简写hermes gateway如果要作为服务管理还可以hermes gatewayinstallhermes gateway start hermes gateway status hermes gateway stop适合场景挂 Telegram / Discord / Slack / WhatsApp 等。6.4 启动 Web Dashboard真实 CLI 子命令是hermes dashboard例如hermes dashboard --no-open hermes dashboard--port9119说明后端是hermes_cli/web_server.py前端源码在web/生产构建会被打到hermes_cli/web_dist/注意一个文档漂移点web/README.md里仍写的是python -m hermes_cli.main web --no-open但当前 CLI 实现里真实命令是dashboard6.5 启动 ACP 服务hermes acp或直接hermes-acp适合编辑器集成。6.6 直接以脚本方式运行 Agentpython run_agent.py--help或者安装后hermes-agent--help这种方式更偏底层调试不是普通用户首选入口。6.7 启动批处理python batch_runner.py--help示例python batch_runner.py--dataset_filedata.jsonl--batch_size10--run_namemy_run7. 如何实际使用这个项目7.1 最小可用路径如果你只想尽快跑起来安装 Hermes配置一个模型 Provider执行hermes直接开始对话7.2 编程代理使用典型流程进入你的项目目录启动hermes或hermes --tui让 Agent 读代码、查文件、修改文件、运行命令这个场景下的关键能力是read_filesearch_fileswrite_filepatchterminaldelegate_taskexecute_code7.3 消息机器人使用典型流程hermes gateway setup配置对应平台 Token / Secrethermes gateway run在 Telegram/Discord 等平台里直接发消息给机器人7.4 自动化使用典型流程启动网关或至少确保本地 Hermes 可用配置 cron用自然语言任务生成定时任务常见命令hermescronlist hermescronstatus8. 常用命令汇总命令作用hermes启动 CLI 聊天。hermes --tui启动 TUI。hermes setup运行初始化向导。hermes model选择/切换模型。hermes tools配置工具启用状态。hermes config set ...修改配置项。hermes gateway setup配置消息网关。hermes gateway run前台启动网关。hermes dashboard启动 Web Dashboard。hermes acp启动 ACP。hermes doctor诊断环境问题。hermes sessions browse浏览历史会话。hermes logs查看日志。9. 开发者常用命令9.1 测试仓库明确要求优先使用scripts/run_tests.sh而不是直接pytest。例如scripts/run_tests.sh scripts/run_tests.sh tests/gateway/ scripts/run_tests.sh tests/agent/test_x.py::test_y9.2 TUI 前端开发cdui-tuinpminstallnpmrun dev9.3 Web Dashboard 前端开发后端hermes dashboard --no-open前端cdwebnpminstallnpmrun dev9.4 文档站开发cdwebsitenpminstallnpmstart10. 启动路径建议如果你是不同角色建议这样启动普通用户hermes setup hermes代码开发者sourcevenv/bin/activate hermes--tui机器人/通知场景hermes gateway setup hermes gateway run运维/管理视角hermes dashboard11. 使用建议想最快上手用hermes。想获得更强终端交互体验用hermes --tui。想做机器人或远程会话用hermes gateway run。想做配置管理和会话概览用hermes dashboard。想把 Hermes 接进编辑器用hermes acp。