Hermes Agent

Nous Research 的自进化 Agent

Nous Research OpenAI 兼容格式 macOSLinuxWindows

Hermes Agent 是 Nous Research 的开源 Agent，在终端、桌面端与消息平台运行，支持工具调用、持久记忆与技能自学习。适合需要一个可长期运行、跨平台、且能接任意 OpenAI 兼容后端的 Agent 的团队。它通过 model.base_url / OPENAI_BASE_URL 指向自定义端点。

网关 base_url（国内站）https://api.shinloo.com/v1填到各工具的 base_url / OPENAI_BASE_URL / apiBase 之类设置里。OpenAI 线路填 /v1；Anthropic / Gemini 线路填网关根 https://api.shinloo.com。

OpenAI 兼容调用路径https://api.shinloo.com/v1/chat/completionsOpenAI 线路的客户端用这个地址（GET /v1/models 可查你的 Key 可用模型）。

推荐模型（国内站已开通）deepseek-v4-prodeepseek-v4.1-flashqwen3.8-max-0902以上为本站公示的模型名，实际可用清单以你的 Key 调 GET /v1/models 返回为准。

省事版 — 一键接入

脚本从 Hermes Agent 的官方来源安装，把网关配置写进工具自己的配置文件（写之前先备份原文件），再发一次真请求验证。会提示你粘贴网关 Key（也可用 --key 传入）； --uninstall 只还原它写进去的内容。

shell

curl -fsSL https://api.shinloo.com/agents/hermes/setup | bash

1 · 安装

从 Hermes Agent 自己的官方来源安装。

安装

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# 或通过 PyPI：
pip install hermes-agent

2 · 配置 — 指向国内站网关

网关 base URL https://api.shinloo.com/v1；Key 在控制台创建。

配置

国内站 https://api.shinloo.com（OpenAI 兼容格式，原生支持）：
方式 A（环境变量，写进 ~/.hermes/.env 或 shell）：
   export OPENAI_BASE_URL=https://api.shinloo.com/v1
   export OPENAI_API_KEY=<你的网关密钥>
   然后运行 hermes model 选择 provider（或 hermes setup）。
方式 B（config.yaml，hermes config edit）：
   model:
     provider: <自定义 provider 名>
     base_url: https://api.shinloo.com/v1
     api_key: <你的网关密钥>

3 · 验证

发一次请求，能返回就说明走的是国内站网关。

验证

hermes chat -q "say hi"
# 能返回一句回答即接入成功；也可运行 hermes doctor 检查配置。

4 · 常见坑

接入靠 config.yaml 的 model/provider 路由（脚本会写 model.provider=custom:<站点> 与 providers.<站点> 段），.env 里的 OPENAI_BASE_URL 只作为兜底。
脚本会先备份你已有的 ~/.hermes/config.yaml（保存为 config.yaml.<站点>.bak），--uninstall 可一键还原。
若你原来已有 model:/providers: 两段，脚本会把它们注释掉（留 # [站点] 你原来的值痕迹）以免 YAML 重复键报错。

工具侧步骤的官方来源： hermes-agent.nousresearch.com/docs hermes-agent.nousresearch.com/docs/reference/environment-var hermes-agent.nousresearch.com/docs/getting-started/installat