# Clone Hermes Agent
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent

# Install dependencies
npm install

# Run locally
npm start

# ~/.hermes/config.yaml
profiles:
  default:
    model: claude-sonnet-4-20250514
    temperature: 0.7
    messaging:
      - telegram
      - discord
    terminal_backend: local
    curator:
      enabled: true
      cycle_days: 7

# Configure Telegram
export TELEGRAM_BOT_TOKEN="your-token"
hermes messaging add telegram

# Configure Discord
export DISCORD_BOT_TOKEN="your-token"
hermes messaging add discord

# Configure Slack
export SLACK_BOT_TOKEN="xoxb-your-token"
export SLACK_APP_TOKEN="xapp-your-token"
hermes messaging add slack

# Clone to skills directory
cd ~/.hermes/skills
git clone https://github.com/wondelai/skills wondelai

# Skills are auto-discovered by Hermes
# Reference in conversation: "use the wondelai search skill"

cd ~/.hermes/skills
git clone https://github.com/tlehman/litprog-skill

# Use in conversation
# "Create a literate programming document for this API"

cd ~/.hermes/skills
git clone https://github.com/adnw-vinc/hermes-nextcloud

# Configure
export NEXTCLOUD_URL="https://cloud.example.com"
export NEXTCLOUD_USERNAME="your-username"
export NEXTCLOUD_APP_PASSWORD="your-app-password"
export NEXTCLOUD_TIMEZONE="America/New_York"

# Use commands
hermes "list my nextcloud files"
hermes "add task 'Deploy new feature' to nextcloud"

cd ~/.hermes/skills
git clone https://github.com/Alexeyisme/hermes-spotify-skill

# Install spotipy
pip install spotipy

# Configure
export SPOTIPY_CLIENT_ID="your-client-id"
export SPOTIPY_CLIENT_SECRET="your-client-secret"
export SPOTIPY_REDIRECT_URI="http://localhost:8888/callback"

# Use on headless Pi
hermes "play workout playlist on spotify"
hermes "set volume to 50%"
hermes "transfer playback to bedroom speaker"

---
name: my-custom-skill
description: Brief one-line description
triggers:
  - "phrase that activates this skill"
  - "another trigger phrase"
---

# my-custom-skill

## What it does
[Description]

## Usage
[Examples]

## Code
[Implementation]

---
name: project-file-search
description: Search files in project by content or name pattern
triggers:
  - "find files containing X"
  - "search project for Y"
  - "locate files matching pattern"
---

# project-file-search

## What it does
Fast file search across project using ripgrep and fd.

## Usage
```bash
# Search file contents
rg "pattern" --type py

# Search filenames
fd "pattern" --extension js

# Combined search with context
rg "TODO" -C 2 --type md

### Installing Plugins

**hermes-plugins (goal management, inter-agent bridge)**
```bash
cd ~/.hermes/plugins
git clone https://github.com/42-evey/hermes-plugins

# Enable goal manager
hermes plugin enable goal-manager

# Configure inter-agent bridge
export BRIDGE_PORT=9000
hermes plugin enable inter-agent-bridge

# Use in conversation
hermes "set goal: ship v2 by friday"
hermes "bridge to agent-2: coordinate on deployment"

# Dockerfile
FROM node:18-alpine

WORKDIR /app
RUN npm install -g @nousresearch/hermes-agent

COPY config.yaml /root/.hermes/config.yaml
COPY skills /root/.hermes/skills

EXPOSE 8080
CMD ["hermes", "start", "--api-server"]

# Build and run
docker build -t my-hermes .
docker run -d \
  -e ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY}" \
  -e TELEGRAM_BOT_TOKEN="${TELEGRAM_BOT_TOKEN}" \
  -p 8080:8080 \
  my-hermes

# modal_deploy.py
import modal

stub = modal.Stub("hermes-agent")

@stub.function(
    image=modal.Image.debian_slim().pip_install("@nousresearch/hermes-agent"),
    secrets=[modal.Secret.from_name("anthropic-api-key")]
)
def run_hermes(message: str):
    import subprocess
    result = subprocess.run(
        ["hermes", "chat", message],
        capture_output=True,
        text=True
    )
    return result.stdout

# Deploy
modal deploy modal_deploy.py

# Invoke
modal run modal_deploy.py::run_hermes --message "analyze this codebase"

# config.yaml
profiles:
  production:
    terminal_backend: vercel-sandbox
    vercel:
      sandbox_token: ${VERCEL_SANDBOX_TOKEN}
      timeout: 300

# Clone and setup
git clone https://github.com/builderz-labs/mission-control
cd mission-control

# Configure fleet
cat > fleet.yaml <<EOF
agents:
  - name: hermes-researcher
    type: hermes
    skills: [deep-research, web-search]
  - name: hermes-executor
    type: hermes
    skills: [ralph, code-execution]
  - name: hermes-monitor
    type: hermes
    skills: [incident-commander, monitoring]
EOF

# Start dashboard
docker-compose up

# Agent 1: Research
hermes "research deployment patterns and report to executor agent"

# Agent 2: Execute (receives via bridge)
# Automatically picks up research context
hermes "implement the recommended pattern"

cd ~/.hermes/skills
git clone https://github.com/Yonkoo11/hermes-dojo

# Enable autonomous improvement
hermes plugin enable dojo

# Dojo monitors performance and iterates on weak skills
# Check improvement log
cat ~/.hermes/dojo/evolution.log

cd ~/.hermes/skills
git clone https://github.com/Romanescu11/hermes-skill-factory

# Point at repetitive workflow
hermes "observe my next 3 git workflows and create a skill"

# Executes workflow 3x, extracts pattern, generates skill
# New skill appears in ~/.hermes/skills/auto-generated/

# config.yaml (curator runs every 7 days by default)
curator:
  enabled: true
  cycle_days: 7
  min_skill_grade: 6.0
  consolidation_threshold: 0.85

# config.yaml
cron:
  - schedule: "0 9 * * *"  # Daily 9am
    task: "check production health and report"
    
  - schedule: "0 */4 * * *"  # Every 4 hours
    task: "sync nextcloud calendar to local database"
    
  - schedule: "0 0 * * 0"  # Weekly Sunday midnight
    task: "run full test suite and update skill docs"

# config.yaml
mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    
    github:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_TOKEN: ${GITHUB_TOKEN}

# Use MCP resources in conversation
hermes "use filesystem MCP to read all markdown files"
hermes "use github MCP to list open PRs in my repos"

# Check skill directory structure
ls -la ~/.hermes/skills/

# Each skill needs SKILL.md or README.md
# Verify skill frontmatter is valid YAML

# Force reload
hermes reload-skills

# Check curator status
hermes curator status

# Manual trigger (doesn't wait for cron)
hermes curator run

# View grading results
cat ~/.hermes/curator/last_cycle.json

# Test individual platform
hermes messaging test telegram

# Check logs
tail -f ~/.hermes/logs/messaging.log

# Verify tokens
hermes messaging status

# Test backend connection
hermes terminal test

# Switch backend
hermes config set terminal_backend local

# SSH backend debug
ssh -v user@host  # Test connection manually

import yaml

with open("SKILL.md") as f:
    content = f.read()
    frontmatter = content.split("---")[1]
    data = yaml.safe_load(frontmatter)
    
    assert "name" in data
    assert "description" in data
    assert "triggers" in data
    assert len(data["triggers"]) >= 3

# Test skill loads in Hermes
hermes validate-skill /path/to/skill

# Test in Claude Code
# Install skill via Claude Desktop settings
# Verify triggers work in conversation

# 1. Install Hermes
npm install -g @nousresearch/hermes-agent
hermes init

# 2. Add core skills
cd ~/.hermes/skills
git clone https://github.com/wondelai/skills wondelai
git clone https://github.com/Yonkoo11/hermes-dojo dojo
git clone https://github.com/Lethe044/hermes-incident-commander incident-commander

# 3. Install plugins
cd ~/.hermes/plugins
git clone https://github.com/42-evey/hermes-plugins

# 4. Configure
cat > ~/.hermes/config.yaml <<EOF
profiles:
  production:
    model: claude-sonnet-4-20250514
    messaging:
      - telegram
      - slack
    terminal_backend: docker
    curator:
      enabled: true
      cycle_days: 7
    cron:
      - schedule: "*/15 * * * *"
        task: "check service health"
      - schedule: "0 9 * * *"
        task: "daily standup report"
EOF

# 5. Set environment
export ANTHROPIC_API_KEY="your-key"
export TELEGRAM_BOT_TOKEN="your-token"
export SLACK_BOT_TOKEN="your-token"

# 6. Start
hermes start --profile production

# 7. Interact via Telegram
# "check production health"
# "what skills do i have"
# "improve the deploy-service skill"