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 other platforms (Discord, Slack, WhatsApp, etc.) by setting the corresponding environment variables after deployment.

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

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.

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.