From 187cd6aafcccaea171b3887cbacc55ca40025ed7 Mon Sep 17 00:00:00 2001
From: A <258483684+la14-1@users.noreply.github.com>
Date: Sat, 28 Feb 2026 06:53:13 -0800
Subject: [PATCH] feat(agent): add Hermes Agent (Nous Research) (#2023)

Implements Hermes Agent on Sprite cloud. Hermes is a persistent AI
agent by Nous Research with multi-platform messaging (Telegram,
Discord, Slack, CLI), memory across sessions, tool use, and native
OpenRouter support.

- Add hermes agent entry to manifest.json with env config
- Add matrix entries for all 7 clouds (sprite implemented, rest missing)
- Create sh/sprite/hermes.sh thin bash shim

Closes #1952

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 manifest.json       | 45 ++++++++++++++++++++++++++++++++++++++++++++-
 sh/sprite/hermes.sh | 34 ++++++++++++++++++++++++++++++++++
 2 files changed, 78 insertions(+), 1 deletion(-)
 create mode 100644 sh/sprite/hermes.sh

diff --git a/manifest.json b/manifest.json
index 84ecdfef..1a3e0533 100644
--- a/manifest.json
+++ b/manifest.json
@@ -241,6 +241,42 @@
         "agentic",
         "engineering"
       ]
+    },
+    "hermes": {
+      "name": "Hermes Agent",
+      "description": "Persistent AI agent with multi-platform messaging, memory across sessions, and tool use",
+      "url": "https://github.com/NousResearch/hermes-agent",
+      "install": "curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash",
+      "launch": "hermes",
+      "env": {
+        "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
+        "OPENAI_BASE_URL": "https://openrouter.ai/api/v1",
+        "OPENAI_API_KEY": "${OPENROUTER_API_KEY}"
+      },
+      "notes": "Natively supports OpenRouter via OPENROUTER_API_KEY. Also works via OPENAI_BASE_URL + OPENAI_API_KEY for OpenAI-compatible mode. Installs Python 3.11 via uv.",
+      "icon": "https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/assets/agents/hermes.png",
+      "featured_cloud": [
+        "sprite",
+        "hetzner",
+        "gcp"
+      ],
+      "creator": "Nous Research",
+      "repo": "NousResearch/hermes-agent",
+      "license": "MIT",
+      "created": "2025-06",
+      "added": "2026-02",
+      "github_stars": 1016,
+      "stars_updated": "2026-02-28",
+      "language": "Python",
+      "runtime": "python",
+      "category": "cli",
+      "tagline": "Persistent AI agent with memory, tools, and multi-platform messaging",
+      "tags": [
+        "agent",
+        "messaging",
+        "memory",
+        "tools"
+      ]
     }
   },
   "clouds": {
@@ -392,6 +428,13 @@
     "sprite/zeroclaw": "implemented",
     "sprite/codex": "implemented",
     "sprite/opencode": "implemented",
-    "sprite/kilocode": "implemented"
+    "sprite/kilocode": "implemented",
+    "local/hermes": "missing",
+    "hetzner/hermes": "missing",
+    "aws/hermes": "missing",
+    "daytona/hermes": "missing",
+    "digitalocean/hermes": "missing",
+    "gcp/hermes": "missing",
+    "sprite/hermes": "implemented"
   }
 }
diff --git a/sh/sprite/hermes.sh b/sh/sprite/hermes.sh
new file mode 100644
index 00000000..0f92cfb9
--- /dev/null
+++ b/sh/sprite/hermes.sh
@@ -0,0 +1,34 @@
+#!/bin/bash
+set -eo pipefail
+
+# Thin shim: ensures bun is available, runs bundled sprite.js (local or from GitHub release)
+
+_ensure_bun() {
+    if command -v bun &>/dev/null; then return 0; fi
+    printf '\033[0;36mInstalling bun...\033[0m\n' >&2
+    curl -fsSL --show-error https://bun.sh/install | bash >/dev/null || { printf '\033[0;31mFailed to install bun\033[0m\n' >&2; exit 1; }
+    export PATH="$HOME/.bun/bin:$PATH"
+    command -v bun &>/dev/null || { printf '\033[0;31mbun not found after install\033[0m\n' >&2; exit 1; }
+}
+
+_ensure_bun
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+
+# SPAWN_CLI_DIR override — force local source (used by e2e tests)
+if [[ -n "${SPAWN_CLI_DIR:-}" && -f "$SPAWN_CLI_DIR/packages/cli/src/sprite/main.ts" ]]; then
+    exec bun run "$SPAWN_CLI_DIR/packages/cli/src/sprite/main.ts" hermes "$@"
+fi
+
+# Local checkout — run from source
+if [[ -n "$SCRIPT_DIR" && -f "$SCRIPT_DIR/../../packages/cli/src/sprite/main.ts" ]]; then
+    exec bun run "$SCRIPT_DIR/../../packages/cli/src/sprite/main.ts" hermes "$@"
+fi
+
+# Remote — download bundled sprite.js from GitHub release
+SPRITE_JS=$(mktemp)
+trap 'rm -f "$SPRITE_JS"' EXIT
+curl -fsSL "https://github.com/OpenRouterTeam/spawn/releases/download/sprite-latest/sprite.js" -o "$SPRITE_JS" \
+    || { printf '\033[0;31mFailed to download sprite.js\033[0m\n' >&2; exit 1; }
+
+exec bun run "$SPRITE_JS" hermes "$@"