Hermes Agent on Fly.io: deployment tool for Hermes Agent

Example deployment of Hermes Agent as a Fly.io Machines app with messaging access

What Hermes Agent on Fly.io does

You clone this repository and Hermes itself, pick a unique app name, create the Fly app and a 10 GB volume named hermes_data, set secrets such as OPENROUTER_API_KEY and TELEGRAM_BOT_TOKEN, and run fly deploy against a copy of the hermes-agent directory with the supplied fly.toml and Dockerfile.append applied. Success is confirmed when fly logs shows Hermes Gateway Starting.

The README estimates about $15 a month on the default config of shared-cpu-2x, 2 GB RAM and a 10 GB volume running 24/7, and says the first Docker build takes a few minutes because it installs uv, Node, Playwright's Chromium and the Hermes [all] extras. The shipped fly.toml exposes no ports, since the messaging platforms are outbound-only. After deploying, you run the interactive hermes setup wizard once over fly ssh console to choose a provider, model and messaging platform.

Key features

Fly.io Machines deployment with a persistent 10 GB volume
Secrets set through fly secrets for the LLM key and bot token
No public ports by default because messaging platforms connect outbound
First-run hermes setup wizard over fly ssh console
Cost estimate and scaling notes for the default machine size

When to use it

Keep a Hermes agent running 24/7 and reachable from Telegram
Move a Hermes install off a laptop onto managed machines
Use the example as a base for a Discord or Slack deployment

Who it is for: Developers who want a Hermes Agent running continuously on Fly.io instead of on their own hardware.

How it fits with Hermes Agent

Built for Hermes Agent: it builds the agent from the hermes-agent repository and runs the Hermes gateway on Fly.io.

How to install Hermes Agent on Fly.io

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

git clone https://github.com/fly-apps/hermes-flyio.git
cd hermes-flyio
git clone https://github.com/NousResearch/hermes-agent.git

Requirements: flyctl installed and logged in, a Fly.io account with a card on file, an LLM API key, and a Telegram bot token and user ID if you use Telegram.

Note: Fly Machines and volumes are paid, and the README estimates roughly $15 a month for the default configuration.

FAQ

What is Hermes Agent on Fly.io?

Hermes Agent on Fly.io is an example repository that deploys Hermes Agent as a Fly.io Machines app, so you can message it from Telegram, Discord, Slack, WhatsApp or Signal.

How do I install Hermes Agent on Fly.io?

Clone this repository and hermes-agent, choose a unique app name in fly.toml, then run fly apps create, fly volumes create, fly secrets set and fly deploy. The README gives each command in order.

What do I need to run Hermes Agent on Fly.io?

You need flyctl, a Fly.io account with a card on file, an LLM API key such as OpenRouter, and a Telegram bot token plus your numeric Telegram user ID if you use Telegram. Fly Machines and volumes are not in the always-free tier.