Hermina

Hermina is a self-hosted control plane for creating, configuring, and operating multiple AI agents powered by Hermes Agent. Each agent has its own identity, model, memory, tools, schedules, and messaging channels.

Fastest path: install Hermina, run hermina onboard, connect the Web, Desktop, or Android app, and create your first agent. Start with one agent and one channel; add automation after a normal conversation works.

Install

Hermina currently targets Debian or Ubuntu servers with systemd. Run the installer as root:

curl -fsSL https://raw.githubusercontent.com/moonixt/hermina/master/install.sh | sudo bash

The installer prepares Docker, Hermes Agent, the Hermina CLI, the management API, the Web/Desktop build, and the base agent image. The default installation directory is /opt/hermina.

After installation:

hermina onboard

See Installation for prerequisites and verification, or go directly to the Quickstart.

What Hermina adds to Hermes

Hermes Agent is the intelligence and tool runtime inside each agent. Hermina adds the operational layer around it:

Multi-agent management — run independent agents instead of one global profile.
Isolated profiles — each agent owns its config.yaml, .env, SOUL.md, sessions, skills, and schedules.
Multiple interfaces — operate the same server from Web, Electron, Android, CLI, or TUI.
Messaging channels — connect WhatsApp, Telegram, Matrix, and other Hermes-compatible channels.
Remote control API — manage agents from authenticated clients without SSH.
Automation — queue work, schedule Hermes cron jobs, and review results in Inbox and Feed.

Choose your path

Goal	Start here	Then read
Install a new server	Installation	Quickstart
Use an existing server	Connect your apps	Manage agents
Configure agent behavior	Providers and models	Personas and behavior
Put an agent on WhatsApp	Channels and messaging	Access and permissions
Schedule recurring work	Tasks and schedules	Troubleshooting

How the pieces fit

A Hermina server has three layers:

Clients — the Web dashboard, Electron app, Android app, browser extension, CLI, and TUI.
Control plane — an authenticated HTTP API that applies configuration, streams chat, and controls runtimes.
Agents — Hermes profiles running in isolated Docker containers or, for advanced deployments, as angel services on the host.

Remote clients should use the /api/* contract. The CLI and TUI run locally and can access Docker, systemd, and the agent files directly.

Recommended learning path

For a first installation, follow this order:

Install and verify the server.
Connect one management client.
Create one agent and confirm its model responds.
Add a persona and one messaging channel.
Restrict access and slash commands.
Add schedules or queued tasks only after the base setup is stable.

Documentation for agents

The source of this site is plain Markdown. Machine-readable indexes are also available at /hermina/docs/llms.txt and /hermina/docs/llms-full.txt.