awesome-hermes-agent-ecosystem

# Awesome Hermes Agent Ecosystem > Skill by [ara.so](https://ara.so) — AI Agent Skills collection. This skill provides comprehensive knowledge of the Hermes Agent ecosystem maintained at [0xNyk/awesome-hermes-agent](https://github.com/0xNyk/awesome-hermes-agent). Hermes Agent by Nous Research is a self-improving AI agent with built-in learning loop, autonomous skill curation, and 18-platform messaging support. ## What is Hermes Agent? Hermes Agent is the only agent with: - **Built-in learning loop** — creates skills from experience and improves them during use - **Autonomous Curator (v0.12.0+)** — maintains its own skill library with 7-day grade/consolidate/prune cycles - **18 messaging platforms** — Telegram, Discord, Slack, WhatsApp, Signal, Feishu/Lark, WeCom, QQBot, Yuanbao, and more - **7 terminal backends** — local, Docker, SSH, Singularity, Modal, Daytona, Vercel Sandbox - **Conversational memory** — searches past conversations and builds user model across sessions Core repository: [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) (134k+ stars) ## Quick Start Path ### 1. Install Hermes Agent ```bash # Clone the repository git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent # Install dependencies (Python 3.10+) pip install -e . # Configure API keys export ANTHROPIC_API_KEY="your_key_here" # or use .env file cp .env.example .env ``` ### 2. First Conversation ```bash # Start interactive CLI hermes # Or one-off command hermes "analyze this codebase and suggest improvements" ``` ### 3. Add Your First Skills **Option A: Cross-platform skills (wondelai)** ```bash # Clone wondelai/skills (380+ stars, production-ready) cd ~/.hermes/skills git clone https://github.com/wondelai/skills.git wondelai # Skills auto-discovered on next run hermes "use the youtube search skill to find videos about agent frameworks" ``` **Option B: Literate programming (litprog-skill)** ```bash # Clone litprog-skill for code + documentation workflows cd ~/.hermes/skills git clone https://github.com/tlehman/litprog-skill.git # Use literate programming hermes "create a literate program that implements a binary tree" ``` ### 4. Add a GUI **Option A: Hermes-native workspace** ```bash # Clone hermes-workspace (500+ stars) git clone https://github.com/outsourc-e/hermes-workspace.git cd hermes-workspace npm install npm run dev # Access at http://localhost:3000 ``` **Option B: Multi-agent orchestration** ```bash # Clone mission-control (3.7k+ stars) git clone https://github.com/builderz-labs/mission-control.git cd mission-control docker-compose up -d # Access at http://localhost:8080 ``` ## Key Configuration ### Profile System (Multi-Instance) ```yaml # ~/.hermes/profiles/work.yaml name: work messaging_platform: slack terminal_backend: docker model: claude-opus-4 memory: conversation_window: 50 auto_summarize: true ``` ```bash # Use specific profile hermes --profile work "analyze the sales dashboard" ``` ### Cron Scheduling ```yaml # ~/.hermes/cron.yaml jobs: - name: daily-standup schedule: "0 9 * * 1-5" # 9 AM weekdays command: "summarize yesterday's commits and create standup report" - name: skill-curator schedule: "0 2 * * 0" # 2 AM Sundays command: "hermes curator --grade --consolidate --prune" ``` ### Messaging Gateway Setup ```bash # Telegram export TELEGRAM_BOT_TOKEN="your_token" hermes --messaging telegram # Discord export DISCORD_BOT_TOKEN="your_token" hermes --messaging discord # Slack export SLACK_BOT_TOKEN="xoxb-your-token" export SLACK_APP_TOKEN="xapp-your-token" hermes --messaging slack ``` ## Essential Skills & Plugins ### Goal Management & Cost Control ```bash # Install hermes-plugins (42-evey) cd ~/.hermes/skills git clone https://github.com/42-evey/hermes-plugins.git # Usage examples hermes "set a goal to refactor the authentication module by Friday" hermes "show me this week's API cost breakdown by model" hermes "switch to claude-sonnet for this task to save costs" ``` ### Inter-Agent Communication ```bash # Using hermes-plugins inter-agent bridge # Terminal 1: Agent A hermes --profile researcher --port 8001 # Terminal 2: Agent B hermes --profile writer --port 8002 # Agent A to Agent B hermes "send to writer agent: use this research summary to write a blog post" ``` ### Incident Response (SRE) ```bash # Install hermes-incident-commander cd ~/.hermes/skills git clone https://github.com/Lethe044/hermes-incident-commander.git # Cron-based monitoring hermes "monitor production services and alert on failures" # Manual incident handling hermes "diagnose why the API is returning 503 errors and apply a fix" ``` ### Spotify Control (Linux/Raspberry Pi) ```bash # Install hermes-spotify-skill (Linux-native) cd ~/.hermes/skills git clone https://github.com/Alexeyisme/hermes-spotify-skill.git # Configure Spotify credentials export SPOTIPY_CLIENT_ID="your_client_id" export SPOTIPY_CLIENT_SECRET="your_client_secret" export SPOTIPY_REDIRECT_URI="http://localhost:8888/callback" # Usage hermes "play lo-fi hip hop on Spotify" hermes "skip to the next track" hermes "transfer playback to my Raspberry Pi speaker" ``` ### Self-Hosted Cloud Integration (Nextcloud) ```bash # Install hermes-nextcloud cd ~/.hermes/skills git clone https://github.com/adnw-vinc/hermes-nextcloud.git # Configure export NEXTCLOUD_URL="https://your-nextcloud.example.com" export NEXTCLOUD_USERNAME="your_username" export NEXTCLOUD_APP_PASSWORD="your_app_password" # Usage hermes "list my nextcloud files" hermes "create a note about today's meeting in nextcloud" hermes "show my calendar for next week" ``` ## Deployment Patterns ### Production VPS Deployment ```bash # Systemd service cat > /etc/systemd/system/hermes.service <<EOF [Unit] Description=Hermes Agent After=network.target [Service] Type=simple User=hermes WorkingDirectory=/opt/hermes-agent Environment="ANTHROPIC_API_KEY=your_key" ExecStart=/usr/bin/hermes --messaging telegram --profile production Restart=always [Install] WantedBy=multi-user.target EOF sudo systemctl enable hermes sudo systemctl start hermes ``` ### Docker Deployment ```dockerfile # Dockerfile FROM python:3.11-slim WORKDIR /app COPY . . RUN pip install -e . ENV ANTHROPIC_API_KEY="" ENV TELEGRAM_BOT_TOKEN="" CMD ["hermes", "--messaging", "telegram"] ``` ```bash # Build and run docker build -t hermes-agent . docker run -d \ -e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \ -e TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN" \ -v ~/.hermes:/root/.hermes \ --name hermes \ hermes-agent ``` ### Vercel Sandbox Deployment ```bash # Use Vercel Sandbox backend (serverless) hermes --terminal vercel-sandbox "deploy this Next.js app" ``` ### Modal Deployment (Serverless GPU) ```bash # Use Modal for GPU-intensive tasks hermes --terminal modal "train this model on the full dataset" ``` ## Multi-Agent Orchestration ### Using oh-my-hermes Suite ```bash # Install oh-my-hermes (witt3rd) cd ~/.hermes/skills git clone https://github.com/witt3rd/oh-my-hermes.git # Deep research workflow hermes "research the state of agent frameworks using deep-research skill" # Consensus planning (Planner → Architect → Critic) hermes "create a ralplan for building a distributed task queue" # Verified execution (execute → verify → iterate) hermes "implement the task queue using ralph skill" # Full autopilot hermes "autopilot: research agent frameworks, plan architecture, implement MVP" ``` ### Inter-Agent Bridge Pattern ```python # In agent A's skill def send_to_agent(target_agent: str, message: str, port: int): """Send message to another Hermes instance""" import requests response = requests.post( f"http://localhost:{port}/api/message", json={"message": message} ) return response.json() # Usage send_to_agent("writer", "Use this data to write a report", port=8002) ``` ## MCP (Model Context Protocol) Integration ```bash # List available MCP servers hermes "list mcp servers" # Use MCP server hermes "use the filesystem MCP server to read project files" # Configure custom MCP server cat > ~/.hermes/mcp-servers.json <<EOF { "servers": { "custom-db": { "command": "node", "args": ["/path/to/db-mcp-server/index.js"], "env": { "DB_CONNECTION_STRING": "postgresql://..." } } } } EOF ``` ## Memory System ### Conversational Memory ```bash # Search past conversations hermes "what did we discuss about authentication last week?" # Summarize conversation history hermes "summarize all our discussions about the API redesign" ``` ### Skill Memory ```bash # Skills automatically improve from experience # After using a skill multiple times: hermes "show me how the 'api-integration' skill has evolved" # Curator grades skills automatically (v0.12.0+) hermes curator --report ``` ## Advanced Patterns ### Self-Improving Skill Factory ```bash # Install hermes-skill-factory cd ~/.hermes/skills git clone https://github.com/Romanescu11/hermes-skill-factory.git # Auto-generate skill from workflow hermes "watch me deploy this app, then create a reusable deployment skill" ``` ### Personal Obsidian API ```bash # Install personal-api skill cd ~/.hermes/skills git clone https://github.com/beiyuii/personal-api-skill.git # Point to your Obsidian vault export OBSIDIAN_VAULT_PATH="$HOME/Documents/Obsidian" # Usage hermes "read my daily notes and suggest priorities" hermes "what did I write about agent frameworks?" ``` ### Accumulator Betting Tracker ```bash # Install acca-tracker (sports betting multi-leg tracking) cd ~/.hermes/skills git clone https://github.com/svenmedina07-ship-it/skills.git cd skills/acca-tracker # Configure cron for 15-minute updates hermes "set up acca tracking cron job" # Manual check hermes "check my accumulator bet status" ``` ## API Server Mode ```bash # Start Hermes as API server hermes serve --port 8080 # Use REST API curl -X POST http://localhost:8080/api/chat \ -H "Content-Type: application/json" \ -d '{"message": "analyze this code", "context": {"file": "main.py"}}' ``` ```python # Python client import requests def ask_hermes(message: str, context: dict = None): response = requests.post( "http://localhost:8080/api/chat", json={"message": message, "context": context or {}} ) return response.json()["response"] # Usage result = ask_hermes("refactor this function", context={"file": "utils.py"}) ``` ## Troubleshooting ### Skills Not Loading ```bash # Check skills directory ls -la ~/.hermes/skills/ # Verify skill structure (needs skill.md or SKILL.md) cat ~/.hermes/skills/your-skill/skill.md # Force reload hermes --reload-skills "list available skills" ``` ### Memory Issues ```bash # Clear conversation history hermes clear-history # Reduce memory window in profile # ~/.hermes/profiles/default.yaml memory: conversation_window: 20 # Reduce from default 50 ``` ### Curator Failures ```bash # Manual curator run with debug hermes curator --grade --verbose # Skip consolidation if stuck hermes curator --grade --prune --skip-consolidate # Reset curator state rm ~/.hermes/curator/state.json ``` ### Messaging Gateway Issues ```bash # Test connection hermes --messaging telegram --test-connection # Debug webhook (for platforms like Telegram) export HERMES_WEBHOOK_URL="https://your-domain.com/webhook" hermes --messaging telegram --debug ``` ### Terminal Backend Failures ```bash # Test Docker backend docker ps # Ensure Docker is running hermes --terminal docker "echo test" # Fallback to local execution hermes --terminal local "echo test" # SSH backend with custom key hermes --terminal ssh \ --ssh-host "192.168.1.100" \ --ssh-user "ubuntu" \ --ssh-key "~/.ssh/hermes_key" ``` ## Common Workflows ### Daily Standup Automation ```yaml