Hermes Agent

Hermes Agent is an autonomous AI agent built by Nous Research. It features persistent memory, 40+ built-in tools, cron scheduling, and multi-platform messaging support.

Quick Start

1. Deploy this template — fill in your OpenRouter API key (required) and optionally a Telegram bot token.
2. Access the API server — after deployment, your instance exposes an OpenAI-compatible endpoint at your domain.
3. Use the API — send requests with your auto-generated API key (shown in the service instructions):

curl https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "default", "messages": [{"role": "user", "content": "Hello!"}]}'

Messaging Platforms

Telegram is configured at deploy time as an example. You can add any of the 14+ supported platforms (Discord, Slack, WhatsApp, Signal, Matrix, Email, WeChat, WeCom, Feishu, DingTalk, QQ Bot, Mattermost, BlueBubbles/iMessage, SMS, Home Assistant, generic webhooks) by setting the corresponding environment variables after deployment.

See the official Messaging Gateway guide for setup instructions for each platform.

Using Zeabur AI Hub (alternative to OpenRouter)

Instead of an OpenRouter key, you can use Zeabur AI Hub — an OpenAI-compatible aggregator. After deployment:

1. Put your AI Hub key in OPENROUTER_API_KEY (reuse the same variable).
2. Edit /opt/data/config.yaml via the Zeabur Files tab:
   • model.base_url: "https://sfo1.aihub.zeabur.ai/v1" (or hnd1 for Tokyo)
   • model.default: "claude-sonnet-4-5" (or any AI Hub model)
3. Restart the service.

Note: the OPENROUTER_BASE_URL env var does not override config.yaml — you must edit the file.

Configuration

• LLM providers, tools, and all other settings — refer to the official Configuration guide and Environment Variables reference.
• Edit config files via the Zeabur Files tab at /opt/data/:
  • config.yaml — model selection, terminal backend, platform settings
  • SOUL.md — agent personality and system prompt
  • .env — all environment variables
• After editing, restart the service to apply changes.

CLI Access

You can use the Hermes CLI directly via the Zeabur Exec tab (or zeabur service exec). The hermes command is available out of the box:

Command	Description
hermes	Interactive chat (REPL)
hermes --tui	Modern terminal UI
hermes -z "prompt"	One-shot query (for scripting)
hermes status	Show status of all components
hermes model	Switch model / provider
hermes config	View or edit configuration
hermes sessions list	List past conversations
hermes -c	Resume last conversation
hermes cron	Manage scheduled jobs
hermes skills	Browse and install skills

Run hermes --help for the full command list.

Notes

• The Docker image is ~4.5 GB (includes Playwright + Chromium for browser automation). First deployment may take several minutes to pull the image.
• First boot may take 30–60 seconds as the agent initializes config files and syncs skills.
• Using browser tools may cause high memory usage — if you encounter OOM (out of memory) errors, consider upgrading to a larger instance (recommended 4 vCPU / 8 GB RAM).

License

Hermes Agent is licensed under the MIT License by Nous Research.