Hermes Charm Juju Charm for Hermes Agent
Cosmic Juju charm for Hermes Agent

Hermes Charm

Deploy Hermes Agent on any cloud with Juju — from bare metal and LXD to VMs and Kubernetes — with a polished dashboard, multi-provider AI routing, and operational actions built in.

Get started View on GitHub
Install
juju deploy hermes

Features

Everything you need to run Hermes Agent as a managed, cloud-native service.

Production-friendly ops

One-command deploy on any substrate

Run on bare metal, LXD, VMs, or Kubernetes with the same Juju workflow.

20+ AI providers supported

Anthropic, OpenAI, Google, GitHub Copilot, OpenRouter, DeepSeek, Groq, xAI, and more.

Multi-model fallback chain

Configure resilient fallback behavior so Hermes keeps responding even when a primary model is unavailable.

Web Dashboard with built-in TUI chat

Use the dashboard for day-to-day management and open a terminal-style chat experience when you need it.

Auto-managed systemd services

The gateway and dashboard are supervised and started as managed services for reliable operation.

Backup, restore, and auto-update

Recover state with Juju actions and keep the deployment fresh with update support.

Messaging integrations

Connect Hermes to Telegram, Discord, Slack, WhatsApp, Signal, LINE, Matrix, Mattermost, and more.

Operational actions

Expose the controls you need for status, dashboard URLs, backup, models, and pairing management.

Polished by design

A clean interface with professional motion, strong contrast, and mobile-friendly layout.

Quick Start

Deploy Hermes, then configure your primary provider and fallback chain.

Copy & run
Deploy
juju deploy hermes
Set primary provider (GitHub Copilot example)
juju config hermes ai-provider=copilot ai-model=claude-sonnet-4 ai-api-key=ghu_xxx
Or use Anthropic directly
juju config hermes ai-provider=anthropic ai-model=claude-sonnet-4 ai-api-key=sk-ant-xxx
Fallback chain
juju config hermes ai-fallback-models="openai/gpt-4,google/gemini-2.5-pro"

TUI Access

Use the built-in Hermes CLI over Juju SSH for interactive chat.

Terminal first
TUI mode
juju ssh hermes/leader -- sudo -u ubuntu hermes chat --tui
Classic REPL
juju ssh hermes/leader -- sudo -u ubuntu hermes chat

Dashboard

The web dashboard auto-starts on port 9119 and is reachable at the unit IP.

Auto-started service
  • Open the dashboard directly from the unit IP, with port 9119 exposed by the charm-managed service.
  • Use it to monitor Hermes state, access chat workflows, and manage deployment operations without leaving your browser.
  • Pair it with the TUI for a powerful dual interface: polished web UX and fast terminal control.

Actions

Operational hooks exposed through Juju actions.

Management APIs
  • get-status — inspect service and deployment state.
  • get-dashboard-url — retrieve the dashboard endpoint.
  • backup — create a backup of the deployment state.
  • list-models — enumerate available models/providers.
  • pairing-list — inspect pairing/integration state.