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.

For full documentation, see hermes-agent.nousresearch.com.

Quick Start

1. Bind domain to port 8642: Go to Networking > Domain, bind your *.zeabur.app domain to port 8642
2. Connect your tool with Base URL https://<your-domain>/v1 and API Key from the Instructions panel
3. (Optional) Set Enable Dashboard to true when deploying, then bind another domain to port **9119. Login with admin` / the auto-generated password shown in Instructions.

Ports & Domains

This service exposes two independent ports. Bind a domain only to the ports you actually use:

Port	Purpose	When to bind a domain
8642	OpenAI-compatible API server	Required for external API access
9119	Web Dashboard (requires HERMES_DASHBOARD=true)	Only if you want the browser UI

Messaging platforms (Telegram, Discord, Slack, etc.) use outbound connections — they do not require any public URL or open port.

Persistent Storage

All data is stored under /opt/data (persistent volume):

Path	Description
/opt/data/config.yaml	Main configuration file
/opt/data/.env	API keys and secrets
/opt/data/sessions/	Conversation history
/opt/data/memories/	Persistent memory store
/opt/data/skills/	Agent-created skills
/opt/data/logs/	Runtime logs

Messaging Platforms

Telegram is configured at deploy time as an example. You can add any of the 20+ supported platforms (Discord, Slack, WhatsApp, Signal, Matrix, Email, WeChat, WeCom, Feishu, DingTalk, QQ Bot, Mattermost, and more) by setting the corresponding environment variables after deployment.

See the official Messaging Gateway guide for setup instructions.

CLI Access

You can use the Hermes CLI directly via the Zeabur Exec tab:

Command	Description
hermes	Interactive chat (REPL)
hermes --tui	Modern terminal UI
hermes status	Show status of all components
hermes config	View or edit configuration
hermes skills	Browse and install skills

Notes

• The Docker image is ~4.5 GB (includes Playwright + Chromium for browser automation). First deployment may take several minutes.
• First boot may take 30–60 seconds as the agent initializes config files and syncs skills.
• Recommended: 2+ vCPU / 4+ GB RAM for browser tools.

License

Hermes Agent is licensed under the MIT License.