Hermes Bot: initial deployment with Feishu gateway

Dockerfile

@@ -0,0 +1,45 @@
+FROM python:3.12-slim
+
+# System deps
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git curl gnupg2 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create persistent data directories
+RUN mkdir -p /data/hermes/{sessions,memories,uploads,logs,palace,skills}
+
+WORKDIR /app
+
+# Clone hermes-agent
+RUN git clone --depth 1 https://github.com/NousResearch/hermes-agent.git /app/hermes-agent
+
+# Build venv
+RUN python3 -m venv /app/venv
+ENV PATH="/app/venv/bin:$PATH"
+RUN pip install --quiet --upgrade pip && \
+    pip install --quiet -e "/app/hermes-agent[feishu,mcp,cron,pty]" 2>&1 | tail -5
+
+# Create hermes home with symlinks to persistent storage
+RUN mkdir -p /root/.hermes && \
+    ln -sf /data/hermes/sessions /root/.hermes/sessions && \
+    ln -sf /data/hermes/memories /root/.hermes/memories && \
+    ln -sf /data/hermes/uploads  /root/.hermes/uploads && \
+    ln -sf /data/hermes/logs     /root/.hermes/logs && \
+    ln -sf /data/hermes/palace   /root/.hermes/palace && \
+    ln -sf /data/hermes/skills   /root/.hermes/skills
+
+# Copy config files
+COPY config.yaml /root/.hermes/config.yaml
+COPY SOUL.md /root/.hermes/SOUL.md
+COPY .env /root/.hermes/.env
+COPY entry.py /app/entry.py
+
+RUN chmod 600 /root/.hermes/.env
+
+# Expose port (for HF health check, not actually serving HTTP)
+EXPOSE 7860
+
+ENV HERMES_ACCEPT_HOOKS=1
+ENV MEMPALACE_PALACE_PATH=/data/hermes/palace
+
+CMD ["python3", "/app/entry.py"]

README.md

@@ -0,0 +1,17 @@
+---
+title: Hermes Bot
+emoji: ⚕️
+colorFrom: green
+colorTo: blue
+sdk: docker
+app_port: 7860
+pinned: false
+---
+
+# Hermes Agent — Feishu Bot
+
+AI assistant powered by [Hermes Agent](https://github.com/NousResearch/hermes-agent) with Feishu integration.
+
+**Model:** inclusionai/ling-2.6-1t:free (OpenRouter)
+
+> ⚠️ This Space uses Persistent Storage for session/memory persistence.

SOUL.md

@@ -0,0 +1,20 @@
+You are Hermes Agent, an intelligent AI assistant created by Nous Research. You are helpful, knowledgeable, and direct. You assist users with a wide range of tasks including answering questions, writing and editing code, analyzing information, creative work, and executing actions via your tools. You communicate clearly, admit uncertainty when appropriate, and prioritize being genuinely useful over being verbose.
+
+## Memory Iron Rules (Must follow every conversation turn)
+
+### Rule 1: Load memory at conversation start
+- When receiving a user message, first check memory tools for user-related info
+- Review previous conversation context and user preferences
+
+### Rule 2: Save key information immediately
+- User's personal info (name, preferences, projects, etc.) -> save to memory immediately
+- Important conversation conclusions and decisions -> save immediately
+- Don't wait until conversation ends to save
+
+### Rule 3: Check for missed saves before ending
+- Before the last reply, check if any important info hasn't been saved
+- Ensure all key memories are persisted
+
+### Rule 4: Memory usage norms
+- Call memory-related tools at least once per conversation turn (read or write)
+- Reference memory content naturally in replies, don't force "based on memory..."

config.yaml

@@ -0,0 +1,21 @@
+model: inclusionai/ling-2.6-1t:free
+provider: openrouter
+max_turns: 90
+platforms:
+  feishu:
+    enabled: true
+    extra:
+      domain: feishu
+      connection_mode: websocket
+memory:
+  provider: none
+compress:
+  enabled: true
+  threshold: 50
+  target_ratio: 20
+  protect_last: 20
+no_mcp: true
+terminal:
+  backend: local
+  timeout: 180
+timezone: Asia/Shanghai

entry.py

@@ -0,0 +1,115 @@
+#!/usr/bin/env python3
+"""Hermes Agent entry point for HuggingFace Space.
+
+- Starts a trivial HTTP server on port 7860 (HF health check).
+- Launches the Hermes Gateway in a background thread.
+- Keeps running until interrupted.
+"""
+
+import os
+import sys
+import threading
+import time
+import logging
+from http.server import HTTPServer, BaseHTTPRequestHandler
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+)
+logger = logging.getLogger("entry")
+
+# ---------------------------------------------------------------------------
+# Health-check server (HF requires port 7860 to be listening)
+# ---------------------------------------------------------------------------
+
+class _HealthHandler(BaseHTTPRequestHandler):
+    def do_GET(self):
+        self.send_response(200)
+        self.send_header("Content-Type", "text/plain")
+        self.end_headers()
+        self.wfile.write(b"Hermes Gateway is running")
+
+    def log_message(self, fmt, *args):
+        pass  # silence health-check logs
+
+
+def _start_health_server(port=7860):
+    server = HTTPServer(("0.0.0.0", port), _HealthHandler)
+    logger.info("Health-check server listening on :%d", port)
+    server.serve_forever()
+
+
+# ---------------------------------------------------------------------------
+# Memory health check
+# ---------------------------------------------------------------------------
+
+def check_memory_health():
+    """Verify persistent storage symlinks are intact."""
+    hermes_home = os.path.expanduser("~/.hermes")
+    issues = []
+    for subdir in ("sessions", "memories", "uploads"):
+        target = os.path.join(hermes_home, subdir)
+        if os.path.islink(target):
+            real = os.path.realpath(target)
+            if not os.path.isdir(real):
+                issues.append(f"{subdir} -> {real} (target missing)")
+            else:
+                logger.info("Symlink OK: %s -> %s", subdir, real)
+        elif os.path.isdir(target):
+            logger.warning("NOT a symlink: %s (data may be lost on rebuild)", target)
+        else:
+            issues.append(f"{subdir} missing")
+
+    # Check persistent volume writable
+    test_path = "/data/hermes/logs/write_test"
+    try:
+        os.makedirs(os.path.dirname(test_path), exist_ok=True)
+        with open(test_path, "w") as f:
+            f.write("ok")
+        os.remove(test_path)
+        logger.info("Persistent storage /data/hermes is writable")
+    except Exception as e:
+        issues.append(f"Cannot write to /data/hermes: {e}")
+
+    if issues:
+        logger.warning("Memory health issues: %s", "; ".join(issues))
+    else:
+        logger.info("Memory health check PASSED")
+
+
+# ---------------------------------------------------------------------------
+# Main
+# ---------------------------------------------------------------------------
+
+def main():
+    logger.info("=== Hermes Agent — HuggingFace Space Entry ===")
+
+    # Check persistent storage
+    check_memory_health()
+
+    # Start health-check server in background
+    health_thread = threading.Thread(target=_start_health_server, daemon=True)
+    health_thread.start()
+
+    # Launch Hermes Gateway
+    from hermes_cli.main import cli
+    logger.info("Launching Hermes Gateway...")
+
+    # The gateway blocks, so we run it in the main thread
+    try:
+        sys.argv = ["hermes", "gateway", "run", "-v"]
+        cli()
+    except KeyboardInterrupt:
+        logger.info("Shutting down...")
+    except SystemExit as e:
+        if e.code != 0:
+            logger.error("Gateway exited with code %s", e.code)
+            raise
+    except Exception as e:
+        logger.error("Gateway crashed: %s", e, exc_info=True)
+        raise
+
+
+if __name__ == "__main__":
+    main()