Hermuse: deployment tool for Hermes Agent

Hermuse

imkofty/Hermuse

Scripts and guides to run Hermes Agent, 9Router and a Telegram gateway on your own server

In short

Hermuse is a set of install scripts and guides that deploys Hermes Agent with 9Router and a Telegram gateway on a Linux VM. It copies the stack the author runs on a VM called Muse.

What Hermuse does

Hermuse uses shell scripts to install Hermes, 9Router and their dependencies, connect a Telegram bot through the Hermes gateway, and add a Cloudflare tunnel to a model dashboard you can open in a browser. Supervisor scripts restart the gateway, 9Router and the tunnel client, and a doctor script reports failures.

Hermes can use Nous directly through OAuth or an API key, or route to models through 9Router, an OpenAI-compatible service bound to 127.0.0.1:20128. The tunnel uses long-polling over Cloudflare Pages and D1 because the author's VM blocked other connection types, and the README says plain cloudflared is probably simpler on a normal network. A watchdog is meant to run from cron. The README is available in several languages.

Key features

scripts/install.sh for Hermes and 9Router
Telegram gateway setup
Cloudflare tunnel to a model dashboard
Supervisor scripts and a cron watchdog
doctor.sh health check
Guides in several languages

When to use it

Running a personal Telegram bot on a small VPS
Putting a model dashboard behind a Cloudflare tunnel
Copying a known-working Hermes server layout

Who it is for: Self-hosters who want a step-by-step Hermes and Telegram setup on their own Ubuntu server.

How it fits with Hermes Agent

It is built around Hermes Agent and its gateway, installing Hermes and wiring it to Telegram and 9Router.

How to install Hermuse

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

bash scripts/install.sh
hermes setup --portal
hermes gateway setup

Requirements: Ubuntu 22.04 or 24.04 VM (2 vCPU, 4 GB RAM is enough), a free Cloudflare account, and a Telegram bot from BotFather

FAQ

What is Hermuse?

Hermuse is a collection of scripts and guides that runs Hermes Agent, 9Router and a Telegram gateway on your own Linux server.

What do I need to run Hermuse?

You need an Ubuntu 22.04 or 24.04 VM, a free Cloudflare account for the dashboard tunnel, and a Telegram bot created through BotFather.

Is Hermuse free and open source?

Yes. The repository is licensed under MIT.