App Store template
Hermes Agent icon

Hermes Agent

An open-source AI agent with persistent memory, a web dashboard, and messaging gateways.

Launch in your Sealos workspace.

Hermes Agent template preview
Template previewFull screenshot
Template deployments
15 on Sealos
Deployment
Your own instance
Category
AI

About this template

Overview

Hermes Agent is an open-source AI agent with persistent memory, a web dashboard, and messaging gateways. This template deploys the official Hermes Docker runtime on Sealos Cloud with a protected dashboard and a private data volume.

From the documentation

The official Hermes Docker Compose bundle contains a gateway and a dashboard. The template keeps those roles in one StatefulSet Pod so both processes share the official /opt/data home directory on persistent storage. The dashboard serves the browser UI on port 9119; the gateway's authenticated API server is available on port 8642 and through the /v1 ingress path.

How to deploy Hermes Agent

  1. Choose Deploy now to start Hermes Agent in your Sealos workspace.
  2. Review dashboard_username, dashboard_password, api_server_key and the remaining settings in the deployment form.
  3. Launch the template, then inspect the application status and resource cards in Canvas.

Resources to plan for

Start with the resources defined by the Hermes Agent template. Review CPU, memory, persistent storage, and network allocations for every service in Canvas. Capacity needs depend on your data and workload; monitor usage as they grow.

Template configuration and setup

Access after deployment

Use the application URL or connection details shown in Canvas. Follow the deployment guide for first-time account setup or client configuration, and keep generated credentials available for that step.

Hosting and billing

Sealos monthly plans include compute, memory, storage, and traffic. Size your plan for all deployed services. Software licenses and external AI or API services may have separate terms and charges. Confirm the applicable plan and optional charges in Cost Center.

Compare Sealos resource plans
Read full documentationCollapse documentation

For current cloud charges, refer to Sealos plan pricing. Upstream documentation may reference earlier billing models.

Deploy and Host Hermes Agent on Sealos

Hermes Agent is an open-source AI agent with persistent memory, a web dashboard, and messaging gateways. This template deploys the official Hermes Docker runtime on Sealos Cloud with a protected dashboard and a private data volume.

Hermes Agent

About Hosting Hermes Agent

The official Hermes Docker Compose bundle contains a gateway and a dashboard. The template keeps those roles in one StatefulSet Pod so both processes share the official /opt/data home directory on persistent storage. The dashboard serves the browser UI on port 9119; the gateway's authenticated API server is available on port 8642 and through the /v1 ingress path.

Hermes stores sessions, configuration, skills, and memory under HERMES_HOME. Sealos provisions a 1 GiB persistent volume for /opt/data, an HTTPS ingress, and the application entry in Canvas. No database or object-storage service is required by the official Docker bundle.

Common Use Cases

  • Personal AI workspace: Keep sessions, skills, and memory available across restarts.
  • Remote agent dashboard: Use the protected web dashboard from a browser.
  • Messaging gateway: Connect Telegram, Discord, Slack, WhatsApp, Signal, or email channels configured through Hermes.
  • Automation and scheduling: Run recurring tasks through Hermes' built-in gateway and scheduler.

Dependencies for Hermes Agent Hosting

The template includes the official Hermes Agent image, a gateway container, a dashboard container, a persistent volume, a Service, an HTTPS Ingress, and a Canvas App entry.

Deployment Dependencies

Implementation Details

Architecture Components
  • Gateway container: Runs the official gateway run command and exposes the authenticated API server on 8642.
  • Dashboard container: Runs the official dashboard command on 9119 and provides the browser UI.
  • Persistent volume: Mounts /opt/data for HERMES_HOME, sessions, skills, configuration, and memory.
  • Service and Ingress: Routes the dashboard at / and the API server at /v1 over HTTPS.
Configuration
  • dashboard_username and dashboard_password enable the documented username/password provider for a non-loopback dashboard.
  • api_server_key is required by the official API server for every bind address.
  • openai_api_key is optional and enables model-backed chat actions when an OpenAI-compatible provider is selected.
  • dashboard_secret is generated by Sealos and keeps dashboard sessions stable across restarts.
Resource Profile
ComponentReplicasCPU limitMemory limitStorage
Gateway1100m512Mi-
Dashboard1100m256Mi-
Hermes data volume1--1Gi

These are the initial personal low-load tiers for the official image. Adjust them from Canvas after observing actual model and tool workloads.

License Information

Hermes Agent is licensed under the MIT License.

Why Deploy Hermes Agent on Sealos?

Sealos is an AI-assisted Cloud Operating System built on Kubernetes. Deploying Hermes Agent on Sealos provides one-click provisioning, automatic HTTPS, persistent storage, pay-as-you-go resource usage, and Canvas operations for logs and resource changes.

  • One-click deployment: Start from the App Store template without hand-writing Kubernetes manifests.
  • Persistent agent state: Keep the Hermes home directory across restarts and upgrades.
  • Secure public access: Use the documented dashboard credentials and API bearer key behind Sealos HTTPS.
  • Operational control: Use Canvas, the AI dialog, and resource cards to inspect or tune the deployment.

Deployment Guide

  1. Open the Hermes Agent template and click Deploy Now.
  2. Enter a strong dashboard_username, dashboard_password, and api_server_key. Add openai_api_key when chat actions need an OpenAI-compatible provider.
  3. Wait for deployment to complete, typically 2-3 minutes for the image and persistent volume. After deployment, Sealos opens the Canvas.
  4. Open the generated HTTPS URL. The dashboard login page accepts the username and password entered in step 2.

Login and API Access

Dashboard login

Open the application URL and sign in at /login with dashboard_username and dashboard_password. The dashboard uses the upstream basic-auth provider for non-loopback deployments.

API clients

Send the configured bearer key when calling the API server through the /v1 path:

curl -H "Authorization: Bearer <api_server_key>" \
  "https://<your-hermes-host>/v1/models"

Keep the API key private because the Hermes API can invoke agent tools, including terminal actions.

Configuration and Scaling

Use the Hermes dashboard for model providers, skills, channels, schedules, and memory settings. Use Canvas resource cards for CPU, memory, storage, logs, and environment changes. The official bundle is intentionally single-replica because /opt/data contains the agent's local state.

Troubleshooting

Dashboard does not open

Check the dashboard container logs and confirm that dashboard_username, dashboard_password, and the generated dashboard secret are present. The dashboard must bind to 0.0.0.0 for the Sealos ingress.

API requests return 401

Use the exact api_server_key configured during deployment and send it as a Bearer token. The API server intentionally fails closed without a key.

Chat actions need a model credential

Set openai_api_key or configure another supported provider in the dashboard. The dashboard and gateway can be healthy while model calls remain unconfigured.

Getting Help

Additional Resources

License

This Sealos template is provided for Sealos users under the templates repository license. Hermes Agent itself is licensed under the MIT License.

From launch to everyday operations

Why deploy
on Sealos

A shorter path from an app you want to an app you can run. Sealos brings deployment and ongoing operations into one place.

  1. One-click deployment

    Start with a ready-made template. Review its configuration and launch from the Sealos console.

  2. Managed Kubernetes

    Run on managed infrastructure with built-in workload scheduling and recovery.

  3. Automatic HTTPS

    Give your application a public HTTPS endpoint with certificates managed for you.

  4. Persistent storage

    Keep application data on persistent volumes across container restarts.

  5. Room to grow

    Adjust CPU, memory, and replicas from the console as your workload changes.

One template. Connected resources.

You Get the Whole Stack

Sealos provisions the resources defined by your template and brings them together in your workspace.

  • App Service

    Container workloads with configurable CPU, memory, and replicas.

  • Public HTTPS URL

    An address for your app, with managed TLS certificates.

  • Database

    A database provisioned alongside your app when the template calls for one.

  • Persistent Volume

    Storage for the files and data your application needs to keep.

  • Environment Variables

    Application settings and secrets configured in one place.

  • Logs & Metrics

    Inspect container logs and resource usage from the console.

Resources and their configuration vary by template. Review the deployment form for this app’s exact setup.

Explore more production-ready templates.

More