hermes agent基础配置需五步完成：一、安装python 3.9/3.10及pip，执行pip install hermes-agent==0.8.3；二、在.env中安全配置hermes_model_api_key；三、创建config.yaml定义model、server与logging；四、访问http://127.0.0.1:8000/ui启用webui；五、通过plugins.knowledge_base挂载本地文档并用--init-kb构建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您初次接触Hermes Agent，面对繁杂的环境依赖、密钥设置与服务对接步骤感到无从下手，则可能是由于缺少标准化的初始化流程。以下是完成Hermes Agent基础配置的完整操作清单：
一、安装Python运行环境与核心依赖
确保系统具备兼容版本的Python解释器及必要包管理工具，是启动Hermes Agent的前提条件。该步骤为后续所有组件加载提供底层支撑。
1、访问python.org下载并安装Python 3.9或3.10版本，勾选“Add Python to PATH”选项。
2、打开终端（Windows使用CMD或PowerShell，macOS/Linux使用Terminal），执行python --version验证安装成功。
3、执行pip install --upgrade pip更新包管理器至最新稳定版。
4、运行pip install hermes-agent==0.8.3安装指定版本代理核心库。
二、生成并配置API密钥凭证
Hermes Agent需通过有效凭证调用外部模型服务，密钥必须以安全方式注入配置文件，避免硬编码泄露风险。
1、登录目标大模型平台（如OpenAI、Qwen或DeepSeek），进入API Keys管理页面。
2、点击“Create new secret key”，复制生成的密钥字符串。
3、在项目根目录下创建.env文件，写入格式为HERMES_MODEL_API_KEY=sk-xxxxxx的键值对。
4、确认该文件未被提交至Git仓库，已在.gitignore中添加.env条目。
三、初始化本地配置文件config.yaml
通过YAML格式定义运行时参数，可灵活控制日志级别、端口绑定、插件启用状态等关键行为，替代命令行重复传参。
1、在项目目录中新建文件config.yaml。
2、填入以下最小化配置内容：
model:
provider: openai
base_url: https://api.openai.com/v1
server:
host: 127.0.0.1
port: 8000
logging:
level: INFO
3、保存后执行hermes-agent --config config.yaml启动服务。
四、启用WebUI交互界面
内置轻量级前端界面便于快速测试指令响应与调试工作流，无需额外部署前端服务即可访问可视化操作入口。
1、确保config.yaml中已设置server.port为可用端口（如8000）。
2、启动代理后，在浏览器地址栏输入http://127.0.0.1:8000/ui。
3、页面加载完成后，可在输入框中键入/help获取内置命令列表。
4、点击“Send”按钮发送请求，观察右侧响应区域实时返回的结构化结果。
五、连接本地知识库插件
通过挂载本地文档目录，使Hermes Agent具备基于私有资料的问答能力，所有解析与向量化过程均在本地完成，不上传原始数据。
1、准备一个纯文本文件夹，路径如./docs/，内含.md或.txt格式文档。
2、在config.yaml中新增插件配置段：
plugins:
knowledge_base:
enabled: true
path: ./docs
embedding_model: all-MiniLM-L6-v2
3、执行hermes-agent --config config.yaml --init-kb触发首次索引构建。
4、索引完成后，发送包含@kb前缀的问题（例如：@kb 如何配置SSL证书？），即可激活本地知识检索。
