企业官网建设流程全解析

Hermes Agent 安装配置指南：从克隆仓库到跑通第一次对话

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

克隆完仓库、装完依赖，终端却卡在"模型没配好"上？这种情况比你想的多。Hermes Agent 是一个会自我进化的 AI 代理：能调工具、能接多个平台，还会从你的使用里积累技能。

先说前置条件：Linux / macOS 最顺，Windows 用户用 WSL2 或原生 PowerShell。需要 Python 3.11，脚本会替你处理，不用自己准备。网络只要能访问模型 API 就行。

🔧 安装 Hermes Agent，把环境搭起来

先把代码拿到本地：

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

关键是 venv 建在仓库外面——venv 放进源码目录，agent 跑起来后可能把它删掉，连运行时一起毁掉。建好虚拟环境再装依赖：

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

系统里没有 uv 的话先装上它，这是个 Python 包管理器。安装过程中可能提示输入 sudo 密码装系统依赖，正常现象。

装完跑一次自检：

hermes doctor

输出里各项都是 OK、没有 ERROR，就算正常。

装好之后还可以接桌面应用，会话按来源文件夹分组，找旧对话方便很多。

⚙️ 配置 Hermes Agent：搞定最关键的三件事

把密钥写进 ~/.hermes/.env

密钥只放~/.hermes/.env，别写进 config.yaml——后者管设置，前者管秘密。往文件里加一行就行：

echo "OPENROUTER_API_KEY=***" >> ~/.hermes/.env

改完重跑hermes doctor，provider 显示已配置就生效了。

用 hermes model 定默认模型

hermes model会弹出交互式列表，选定的结果写进~/.hermes/config.yaml。怎么确认：开一轮对话发消息，回复来自你刚选的模型就算设好了。

摸清配置目录都在哪

~/.hermes/下：config.yaml 管设置，.env 管密钥，skills/ 放技能，memories/ 放记忆，state.db 是会话数据库。想迁移到新机器，把这个目录拷走就行。

✅ 跑通后你该看到什么

直接开一个会话：

hermes

启动后看两个字段：横幅处显示 Python 3.11，底部状态栏的模型是刚配的那个。再问一句"你好"，有回复就说明环境就绪。如果报 401 或模型错误，看下一节。

🔍 卡在哪儿了

• hermes命令找不到 → 先激活 venv：source ~/.hermes/venvs/hermes/bin/activate
• 对话报 401 或认证错误 → 检查~/.hermes/.env里密钥是否完整，重跑hermes doctor

🚀 接下来做这三件事

先跑hermes setup补完剩余配置，再用hermes tools看看哪些工具集开着，最后读一遍仓库根目录的AGENTS.md，把架构摸个大概。

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