企业官网建设流程全解析

Hermes Agent 安装与环境搭建完整指南：五步跑通第一次对话

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent

Hermes Agent 是一个自带学习循环的 AI 智能体：它会从对话中沉淀技能、跑定时任务，还能接入 Telegram 等平台。跑完这份指南，你会得到一个本机可用的hermes命令——进终端就能和任意模型开会话，随时用hermes doctor自检环境。

30 秒决策速览

阶段一：开工前自检

在终端执行，确认两条命令都能输出版本号：

git --version uv --version

• 缺 git：用系统包管理器安装。
• 缺 uv：用 uv 官方一行脚本安装，装完执行source ~/.bashrc重新加载 shell。
• 两者都有：进入下一阶段。

阶段二：克隆代码与目录要点

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent

目录里留意的三个路径：

• agent/——核心运行时，对话循环、上下文压缩、工具调度都在这里；
• apps/desktop/——桌面客户端源码，只用 CLI 可跳过；
• .env.example——环境变量模板，阶段三要复制它。

阶段三：配置注入（环境变量配置清单）

把 venv 建在仓库外（避免被 agent 自己的命令误删），再装依赖：

uv venv ~/.hermes/venvs/hermes-dev --python 3.11 source ~/.hermes/venvs/hermes-dev/bin/activate uv pip install -e ".[all,dev]"

预期：依赖解析完成、安装无报错。然后从模板建配置：

cp .env.example .env

打开.env，必填项只有一类：LLM 供应商密钥，如OPENAI_API_KEY。语音、IM 平台、TTS 等几十项均为可选，先留空。

阶段四：体检通过（安装验证与排错）

hermes doctor

预期：逐项输出 ✓，无 ERROR 行。两条典型失败输出及解法：

• hermes: command not found→ 虚拟环境未激活或 PATH 未刷新，执行source ~/.bashrc后重试；
• Python 版本报错 → 用uv venv --python 3.11重建环境，重新安装依赖。

阶段五：首跑，最小命令序列

hermes # 进入交互 TUI，首次会走设置向导 hermes model # 选一个模型供应商和模型

选完模型，在 TUI 里发一条任意消息，看到流式输出即环境搭好。

卡住了？

• 脚本中断：重跑uv pip install -e ".[all,dev]"续装；仍失败先查网络。
• 命令找不到：用which hermes确认 venv 是否激活，未激活执行source ~/.bashrc。
• 依赖冲突：先uv pip check定位冲突包，再重建 venv 重装。

现在打开终端执行hermes，完成首次模型选择。

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent