Hermes-Relay

Install in 30 seconds

One line installs the server plugin into your Hermes agent. After restarting hermes, run hermes-pair (or type /hermes-relay-pair in any Hermes chat surface) to generate a QR code the Android app can scan.

curl -fsSL https://raw.githubusercontent.com/Codename-11/hermes-relay/main/install.sh | bash

Then:

hermes-pair

Installs the 14 android_* device control tools, the /hermes-relay-pair skill, and a hermes-pair shell shim. Requires hermes-agent v0.8.0+ and Python 3.11+.

Sideload the APK

Prefer not to use Google Play? Grab the file ending in -sideload-release.apk from the latest GitHub Release and install it directly — that's the full-featured "Hermes Dev" build. Any .aab file is a Google Play bundle format and won't install directly — always pick the .apk.

Download APK →Sideload guide

Found a bug? We'd love to hear about it.

This is an indie project and every report helps. If something feels off, broken, or just weird, open an issue — we read every one.

Open an issue →

For AI Agents

Have an AI assistant install + maintain Hermes-Relay for you. Paste this block into Claude, GPT, or any agent — it'll fetch the canonical setup recipe and walk you through verification, pairing, and troubleshooting.

You are helping me install and maintain Hermes-Relay (https://github.com/Codename-11/hermes-relay), a native Android client + Python plugin for the Hermes AI agent platform.

Read the canonical setup recipe before acting:
  https://raw.githubusercontent.com/Codename-11/hermes-relay/main/skills/devops/hermes-relay-self-setup/SKILL.md

Then guide me through:
- Verifying hermes-agent is already installed (it's a prerequisite — Hermes-Relay is a plugin, not standalone)
- Running the install one-liner: `curl -fsSL https://raw.githubusercontent.com/Codename-11/hermes-relay/main/install.sh | bash`
- Pairing my phone via `hermes-pair` or `/hermes-relay-pair`
- Verifying with `hermes-status`

Always confirm before running shell commands. Never restart hermes-gateway without asking. If any step fails, consult the Troubleshooting section in the SKILL.md and ask me for the exact error.

Already have Hermes-Relay installed? The same recipe ships as a Hermes skill — invoke it from any chat with /hermes-relay-self-setup for re-setup, troubleshooting, or "is everything wired correctly?" checks. Single source, two delivery modes, no drift.