hermes-relay-self-setup

What problem does it solve?

Provides a self-contained, agent-readable recipe to install, verify, update, troubleshoot, pair, and uninstall the Hermes-Relay plugin and Android pairing pipeline so users and agents can get a Hermes-Relay instance running end-to-end without manual orchestration across multiple components.

Core Features & Use Cases

• Idempotent installation and updates: Single one-liner installer that clones or updates the repo, performs editable pip installs, regenerates shims, and optionally restarts the gateway.
• Automated verification and health checks: Guided checks for relay health, bridge status, shims presence, plugin import, and systemd service state with clear expected outputs.
• Pairing and recovery flows: QR and manual code pairing flows for Android clients, plus troubleshooting guidance for common failure modes like disabled bridge, missing tools, or rate limits.

Quick Start

Run the canonical installer one-liner to install or update the relay, verify health endpoints and tooling, and then run hermes-pair to complete Android pairing.