praveen-ks-2001/hermes-agent-template

Hermes Agent – Railway 模板

它是什么 – 一个即用型 Railway 模板，运行开源 Hermes Agent（来自 Nous Research 的自主 LLM 驱动的 AI 助手）。该模板添加了一个基于 Web 的管理 UI，让您无需编辑任何配置文件即可配置 LLM 提供商、消息通道（Telegram、Discord、Slack 等）、工具，并管理 Hermes 网关。

主要功能

• 一键部署 – 通过徽章按钮在 Railway 上部署。
• 管理仪表板 (/setup) – 用于选择 LLM 提供商、启用通道、切换工具，并控制网关（启动/停止/重启）。
• 集成 Hermes UI (/) – 原生 Hermes Web 界面（聊天、密钥、技能、分析、控制台）通过同一登录代理。
• 用户配对 – 传入消息生成配对请求，您可以在仪表板中批准/拒绝。
• 实时状态与日志 – 在浏览器中查看网关运行时间、模型、待处理请求和流式日志。
• 备份与恢复 – 将整个 /data/.hermes 目录（配置、凭据、聊天历史、技能）快照为 zip，可下载 6 小时。
• 密码保护 的管理访问（基于 cookie 的登录，默认用户 admin）。
• 持久存储 – 在 /data 挂载 Railway 卷，以便配置在重新部署后保留。

如何开始

1. 获取 LLM 密钥 – 在 OpenRouter（或任何其他支持的提供商）注册并复制 API 密钥。
2. 创建 Telegram 机器人 – 与 @BotFather 对话，运行 /newbot，并复制机器人令牌。
3. 部署 – 点击 Deploy on Railway 按钮，设置 ADMIN_PASSWORD（或让系统生成一个），并挂载一个卷到 /data。
4. 配置 – 打开应用 URL，登录（admin / 您的密码），转到 /setup 并：
   • 选择提供商（例如 OpenRouter）并粘贴密钥/模型。
   • 启用 Telegram 并粘贴机器人令牌。
   • 点击 保存并启动。
5. 使用 – 给 Telegram 机器人发消息；第一条消息在仪表板中显示为配对请求。批准它并开始聊天。

支持的提供商与通道

• 提供商 – OpenRouter、Anthropic、Google AI Studio、xAI、DeepSeek、Qwen Cloud、GLM、Kimi、NVIDIA NIM、Fireworks AI、AWS Bedrock、Azure Foundry、Ollama Cloud、9Router、OmniRoute、任何兼容 OpenAI 的端点等。
• 通道 – Telegram、Discord、Slack、WhatsApp、Email、Mattermost、Matrix。
• 工具集成 – 网络搜索（Parallel、Tavily、Perplexity 等）、抓取（Firecrawl）、图像生成（FAL）、浏览器自动化（Browserbase）、GitHub、语音（Whisper/TTS）、记忆（Honcho）等。

架构概览

Railway 容器 (端口 $PORT)
 └─ server.py (Starlette + Uvicorn) – 处理 /login、/setup、/health，将 / 代理到原生 Hermes UI
     ├─ hermes-dashboard (监听 127.0.0.1:9119) – 仅通过代理可达
     └─ hermes-gateway – 实际与 Telegram/Discord 等通信的代理进程

网关由 server.py 监督；如果崩溃，会自动重启。

本地运行

docker build -t hermes-agent .
docker run --rm -it -p 8080:8080 \
  -e ADMIN_PASSWORD=changeme -v hermes-data:/data hermes-agent

访问 http://localhost:8080 并使用 admin / changeme 登录。

更新 – 模板通过 HERMES_REF 构建参数（默认 v0.22.2）固定特定的 Hermes 版本。要升级，请部署匹配的 release/<version>/<n> 分支或覆盖 HERMES_REF（后者可能破坏现有卷）。在更改版本之前，始终备份 /data 卷。

谁可能使用这个 – 希望以最少运维工作自托管自主 AI 助手的开发者或爱好者，尤其是那些喜欢 Railway 简单部署模型和用于管理通道、工具和用户访问的 Web UI 的人。

---

致谢 – Hermes Agent 由 Nous Research 开发；UI 灵感来自 OpenClaw Railway 管理模板。