Fly Hermes

What Fly Hermes does

The repository supplies a fly.toml, a hermes-shim script and a Dockerfile.append that you copy into a clone of Hermes Agent before running fly deploy. The first build installs uv, Node, Playwright's Chromium and the Python dependencies from the Hermes [all] extra. After deploying, you run hermes setup over fly ssh console, pick Quick Setup, choose a messaging platform and restart the Machine with fly apps restart.

The shipped fly.toml opens no public ports, because the messaging platforms only need outbound connections. A webhooks section covers cases where you do want inbound HTTP. A volume named hermes_data stores persistent data, and updating means pulling Hermes and redeploying. The README estimates about 15 dollars per month for the default shared-cpu-2x, 2 GB RAM, 10 GB volume setup running around the clock, and notes the Machine can be scaled down or turned off.

Key features

• Runs Hermes Agent as a Fly.io Machine with a persistent volume
• Setup through the hermes setup wizard over fly ssh console
• Telegram, Discord, Slack, WhatsApp and Signal supported through Hermes messaging
• Secrets set with fly secrets, including an OpenRouter key and a Telegram bot token
• No public IP by default, with a webhooks section for inbound HTTP

When to use it

• Keeping a personal Hermes Agent online around the clock and messaging it from a phone
• Hosting Hermes without maintaining your own server
• Scaling the Machine down or off when the agent is not in use

Who it is for: Hermes Agent users who want a cloud-hosted instance on Fly.io and are comfortable with the flyctl command line.

How it fits with Hermes Agent

Built for Hermes Agent. It deploys the upstream NousResearch/hermes-agent repository with Fly.io-specific files added on top.

How to install Fly Hermes

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 (OpenRouter, Anthropic, OpenAI or Nous Portal), and for Telegram a bot token and your numeric user ID

Note: This repository appears to be a copy of fly-apps/hermes-flyio, which was created earlier; its own install steps clone the fly-apps repository. Needs a Fly.io account, and the README estimates about 15 dollars per month.

FAQ