---
name: Hermes Agent Setup & Usage
description: Complete guide to installing, configuring, and using Hermes Agent — the open-source AI agent framework for terminal, messaging platforms, and autonomous workflows.
source: custom
risk: low
---

## Purpose & Scope

Set up and use Hermes Agent, the open-source AI agent framework that runs in your terminal, connects to messaging platforms (Telegram, Discord, Feishu), and automates workflows via cron jobs and skills.

## Quick Install

### macOS / Linux
```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | sh
```

### Windows (PowerShell)
```powershell
iwr -Uri https://hermes-agent.nousresearch.com/install.ps1 -UseBasicParsing | iex
```

## Core Concepts

### Skills
Skills are reusable AI capabilities stored in `~/.hermes/skills/`. Each skill is a SKILL.md file with YAML frontmatter and markdown content. Load a skill with:
```bash
hermes skill install <skill-name>
```

### Tools
Hermes comes with built-in tools: terminal, file operations, web search, browser automation, and more. Configure in `~/.hermes/config.yaml`.

### Cron Jobs
Schedule recurring AI tasks:
```bash
hermes cron create --name "daily-report" --schedule "0 9 * * *" --prompt "Generate daily report"
```

### Multi-Platform
Connect Hermes to:
- **Telegram:** Chat with your agent on the go
- **Discord:** Add to your server for team workflows
- **Feishu (飞书):** Enterprise integration with docs and calendar
- **WhatsApp:** Personal assistant in your pocket

## Common Workflows

### 1. Code Review Assistant
```bash
hermes skill install code-review-expert
```
Then: `hermes chat` → "Review this PR for security issues"

### 2. Daily News Briefing
```bash
hermes cron create --name "news" --schedule "0 8 * * *" \
  --prompt "Curate top 5 tech news from Hacker News and summarize"
```

### 3. Meeting Summarizer
```bash
hermes skill install meeting-summarizer
cat transcript.txt | hermes chat --skill meeting-summarizer
```

## Configuration Tips

- **Model Provider:** Set in `~/.hermes/config.yaml` (supports OpenAI, Anthropic, DeepSeek, OpenRouter)
- **Memory:** Hermes remembers across sessions via persistent memory store
- **Skills Directory:** `~/.hermes/skills/` — add your own or install from registry
- **Plugins:** Extend with community plugins for custom integrations