# The Hermes Bible

> An unofficial, community-built knowledge base for Hermes Agent by Nous Research. It collects the official documentation alongside community-contributed flows: setup guides, configuration patterns, and real-world workflows.

For a single document containing the full text of every doc and flow (ideal for pasting into an LLM to audit a setup), see [llms-full.txt](https://hermesbible.com/llms-full.txt).

## Documentation

### Getting Started

- [Installation](https://hermesbible.com/docs/getting-started/installation): Get Hermes Agent up and running in under two minutes! Quick Install With the Hermes Desktop installer on macOS or Windows (recommended) To easily install the co
- [Quickstart](https://hermesbible.com/docs/getting-started/quickstart): This guide gets you from zero to a working Hermes setup that survives real use. Install, choose a provider, verify a working chat, and know exactly what to do w
- [Learning Path](https://hermesbible.com/docs/getting-started/learning-path): Hermes Agent can do a lot — CLI assistant, Telegram/Discord bot, task automation, RL training, and more. This page helps you figure out where to start and what
- [Updating & Uninstalling](https://hermesbible.com/docs/getting-started/updating): Updating Git installs Update to the latest version with a single command: This pulls the latest code from , updates dependencies, and prompts you to configure a
- [Android / Termux](https://hermesbible.com/docs/getting-started/termux): Hermes on Android with Termux This is the tested path for running Hermes Agent directly on an Android phone through Termux. It gives you a working local CLI on
- [Nix & NixOS Setup](https://hermesbible.com/docs/getting-started/nix-setup): Hermes Agent ships a Nix flake with three levels of integration: Level Who it's for What you get / Any Nix user (macOS, Linux) Pre built binary with all deps —

### Core Features

- [Features Overview](https://hermesbible.com/docs/user-guide/features/overview): Hermes Agent includes a rich set of capabilities that extend far beyond basic chat. From persistent memory and file aware context to browser automation and voic
- [Tools & Toolsets](https://hermesbible.com/docs/user-guide/features/tools): Tools are functions that extend the agent's capabilities. They're organized into logical toolsets that can be enabled or disabled per platform. Available Tools
- [Skills System](https://hermesbible.com/docs/user-guide/features/skills): Skills are on demand knowledge documents the agent can load when needed. They follow a progressive disclosure pattern to minimize token usage and are compatible
- [Curator](https://hermesbible.com/docs/user-guide/features/curator): The curator is a background maintenance pass for agent created skills . It tracks how often each skill is viewed, used, and patched, moves long unused skills th
- [Persistent Memory](https://hermesbible.com/docs/user-guide/features/memory): Hermes Agent has bounded, curated memory that persists across sessions. This lets it remember your preferences, your projects, your environment, and things it h
- [Memory Providers](https://hermesbible.com/docs/user-guide/features/memory-providers): Hermes Agent ships with 8 external memory provider plugins that give the agent persistent, cross session knowledge beyond the built in MEMORY.md and USER.md. On
- [Context Files](https://hermesbible.com/docs/user-guide/features/context-files): Hermes Agent automatically discovers and loads context files that shape how it behaves. Some are project local and discovered from your working directory. is no
- [Context References](https://hermesbible.com/docs/user-guide/features/context-references): Type followed by a reference to inject content directly into your message. Hermes expands the reference inline and appends the content under an section. Support
- [How SOUL.md works now](https://hermesbible.com/docs/user-guide/features/personality): Hermes Agent's personality is fully customizable. is the primary identity — it's the first thing in the system prompt and defines who the agent is. — a durable
- [Plugins](https://hermesbible.com/docs/user-guide/features/plugins): Hermes has a plugin system for adding custom tools, hooks, and integrations without modifying core code. If you want to create a custom tool for yourself, your
- [Built-in Plugins](https://hermesbible.com/docs/user-guide/features/built-in-plugins): Hermes ships a small set of plugins bundled with the repository. They live under and load automatically alongside user installed plugins in . They use the same
- [Scheduled Tasks (Cron)](https://hermesbible.com/docs/user-guide/features/cron): Schedule tasks to run automatically with natural language or cron expressions. Hermes exposes cron management through a single tool with action style operations
- [Subagent Delegation](https://hermesbible.com/docs/user-guide/features/delegation): The tool spawns child AIAgent instances with isolated context, restricted toolsets, and their own terminal sessions. Each child gets a fresh conversation and wo
- [Kanban (Multi-Agent Board)](https://hermesbible.com/docs/user-guide/features/kanban): Kanban — Multi Agent Profile Collaboration Want a walkthrough? Read the Kanban tutorial — four user stories (solo dev, fleet farming, role pipeline with retry,
- [Kanban tutorial](https://hermesbible.com/docs/user-guide/features/kanban-tutorial): Kanban tutorial A walkthrough of the four use cases the Hermes Kanban system was designed for, with the dashboard open in a browser. If you haven't read the Kan
- [Persistent Goals](https://hermesbible.com/docs/user-guide/features/goals): Persistent Goals ( ) gives Hermes a standing objective that survives across turns. After every turn a lightweight judge model checks whether the goal is satisfi
- [Code Execution](https://hermesbible.com/docs/user-guide/features/code-execution): Code Execution (Programmatic Tool Calling) The tool lets the agent write Python scripts that call Hermes tools programmatically, collapsing multi step workflows
- [Event Hooks](https://hermesbible.com/docs/user-guide/features/hooks): Hermes has three hook systems that run custom code at key lifecycle points: System Registered via Runs in Use case Gateway hooks + in Gateway only Logging, aler
- [Batch Processing](https://hermesbible.com/docs/user-guide/features/batch-processing): Batch processing lets you run the Hermes agent across hundreds or thousands of prompts in parallel, generating structured trajectory data. This is primarily use
- [Voice Mode](https://hermesbible.com/docs/user-guide/features/voice-mode): Hermes Agent supports full voice interaction across CLI and messaging platforms. Talk to the agent using your microphone, hear spoken replies, and have live voi
- [Browser Automation](https://hermesbible.com/docs/user-guide/features/browser): Browser Automation Hermes Agent includes a full browser automation toolset with multiple backend options: Browserbase cloud mode via Browserbase for managed clo
- [Vision & Image Paste](https://hermesbible.com/docs/user-guide/features/vision): Vision & Image Paste Hermes Agent supports multimodal vision — you can paste images from your clipboard directly into the CLI and ask the agent to analyze, desc
- [Image Generation](https://hermesbible.com/docs/user-guide/features/image-generation): Image Generation Hermes Agent generates images from text prompts via FAL.ai. Eleven models are supported out of the box, each with different speed, quality, and
- [Voice & TTS](https://hermesbible.com/docs/user-guide/features/tts): Hermes Agent supports both text to speech output and voice message transcription across all messaging platforms. TIP — Nous Subscribers If you have a paid Nous
- [MCP (Model Context Protocol)](https://hermesbible.com/docs/user-guide/features/mcp): MCP lets Hermes Agent connect to external tool servers so the agent can use tools that live outside Hermes itself — GitHub, databases, file systems, browser sta
- [ACP Editor Integration](https://hermesbible.com/docs/user-guide/features/acp): Hermes Agent can run as an ACP server, letting ACP compatible editors talk to Hermes over stdio and render: chat messages tool activity file diffs terminal comm
- [API Server](https://hermesbible.com/docs/user-guide/features/api-server): The API server exposes hermes agent as an OpenAI compatible HTTP endpoint. Any frontend that speaks the OpenAI format — Open WebUI, LobeChat, LibreChat, NextCha
- [Honcho Memory](https://hermesbible.com/docs/user-guide/features/honcho): Honcho is an AI native memory backend that adds dialectic reasoning and deep user modeling on top of Hermes's built in memory system. Instead of simple key valu
- [Provider Routing](https://hermesbible.com/docs/user-guide/features/provider-routing): Provider Routing When using OpenRouter as your LLM provider, Hermes Agent supports provider routing — fine grained control over which underlying AI providers ha
- [Fallback Providers](https://hermesbible.com/docs/user-guide/features/fallback-providers): Fallback Providers Hermes Agent has three layers of resilience that keep your sessions running when providers hit issues: 1. Credential pools — rotate across mu
- [Credential Pools](https://hermesbible.com/docs/user-guide/features/credential-pools): Credential Pools Credential pools let you register multiple API keys or OAuth tokens for the same provider. When one key hits a rate limit or billing quota, Her
- [Codex App-Server Runtime](https://hermesbible.com/docs/user-guide/features/codex-app-server-runtime): Codex App Server Runtime Hermes can optionally hand and turns to the Codex CLI app server instead of running its own tool loop. When enabled, terminal commands,
- [Computer Use (macOS)](https://hermesbible.com/docs/user-guide/features/computer-use): Computer Use (macOS) Hermes Agent can drive your Mac's desktop — clicking, typing, scrolling, dragging — in the background . Your cursor doesn't move, keyboard
- [Deliverable Mode](https://hermesbible.com/docs/user-guide/features/deliverable-mode): Deliverable Mode When Hermes Agent runs inside a messaging gateway (Slack, Discord, Telegram, WhatsApp, Signal, etc.), it can deliver generated files directly i
- [Extending the Dashboard](https://hermesbible.com/docs/user-guide/features/extending-the-dashboard): The Hermes web dashboard ( ) is built to be reskinned and extended without forking the codebase. Three layers are exposed: 1. Themes — YAML files that repaint t
- [Kanban worker lanes](https://hermesbible.com/docs/user-guide/features/kanban-worker-lanes): Kanban worker lanes A worker lane is a class of process that the kanban dispatcher can route tasks to. Each lane has an identity (the assignee string), a spawn
- [LSP — Semantic Diagnostics](https://hermesbible.com/docs/user-guide/features/lsp): Language Server Protocol (LSP) Hermes runs full language servers — pyright, gopls, rust analyzer, typescript language server, clangd, and ~20 more — as backgrou
- [Skins & Themes](https://hermesbible.com/docs/user-guide/features/skins): Skins control the visual presentation of the Hermes CLI: banner colors, spinner faces and verbs, response box labels, branding text, and the tool activity prefi
- [Spotify](https://hermesbible.com/docs/user-guide/features/spotify): Spotify Hermes can control Spotify directly — playback, queue, search, playlists, saved tracks/albums, and listening history — using Spotify's official Web API
- [Subscription Proxy](https://hermesbible.com/docs/user-guide/features/subscription-proxy): The subscription proxy is a local HTTP server that lets external apps — OpenViking, Karakeep, Open WebUI, anything that speaks OpenAI compatible chat completion
- [Nous Tool Gateway](https://hermesbible.com/docs/user-guide/features/tool-gateway): One subscription. Every tool built in. The Tool Gateway is included with every paid Nous Portal subscription. It routes Hermes' tool calls — web search, image g
- [Tool Search](https://hermesbible.com/docs/user-guide/features/tool-search): Tool Search When you have many MCP servers or non core plugin tools attached to a session, their JSON schemas can consume a substantial fraction of the context
- [Web Dashboard](https://hermesbible.com/docs/user-guide/features/web-dashboard): The web dashboard is a browser based UI for managing your Hermes Agent installation. Instead of editing YAML files or running CLI commands, you can configure se
- [Web Search & Extract](https://hermesbible.com/docs/user-guide/features/web-search): Web Search & Extract Hermes Agent includes two model callable web tools backed by multiple providers: — search the web and return ranked results — fetch and ext
- [X (Twitter) Search](https://hermesbible.com/docs/user-guide/features/x-search): X (Twitter) Search The tool lets the agent search X (Twitter) posts, profiles, and threads directly. It's backed by xAI's built in tool on the Responses API at

### Messaging Platforms

- [Messaging Gateway](https://hermesbible.com/docs/user-guide/messaging/index): Chat with Hermes from Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin, BlueBubb
- [Telegram](https://hermesbible.com/docs/user-guide/messaging/telegram): Telegram Setup Hermes Agent integrates with Telegram as a full featured conversational bot. Once connected, you can chat with your agent from any device, send v
- [Discord](https://hermesbible.com/docs/user-guide/messaging/discord): Discord Setup Hermes Agent integrates with Discord as a bot, letting you chat with your AI assistant through direct messages or server channels. The bot receive
- [Slack](https://hermesbible.com/docs/user-guide/messaging/slack): Slack Setup Connect Hermes Agent to Slack as a bot using Socket Mode. Socket Mode uses WebSockets instead of public HTTP endpoints, so your Hermes instance does
- [WhatsApp](https://hermesbible.com/docs/user-guide/messaging/whatsapp): WhatsApp Setup Hermes connects to WhatsApp through a built in bridge based on Baileys . This works by emulating a WhatsApp Web session — not through the officia
- [Signal](https://hermesbible.com/docs/user-guide/messaging/signal): Signal Setup Hermes connects to Signal through the signal cli daemon running in HTTP mode. The adapter streams messages in real time via SSE (Server Sent Events
- [Email](https://hermesbible.com/docs/user-guide/messaging/email): Email Setup Hermes can receive and reply to emails using standard IMAP and SMTP protocols. Send an email to the agent's address and it replies in thread — no sp
- [SMS (Twilio)](https://hermesbible.com/docs/user-guide/messaging/sms): SMS Setup (Twilio) Hermes connects to SMS through the Twilio API. People text your Twilio phone number and get AI responses back — same conversational experienc
- [Matrix](https://hermesbible.com/docs/user-guide/messaging/matrix): Matrix Setup Hermes Agent integrates with Matrix, the open, federated messaging protocol. Matrix lets you run your own homeserver or use a public one like matri
- [Mattermost](https://hermesbible.com/docs/user-guide/messaging/mattermost): Mattermost Setup Hermes Agent integrates with Mattermost as a bot, letting you chat with your AI assistant through direct messages or team channels. Mattermost
- [Home Assistant Integration](https://hermesbible.com/docs/user-guide/messaging/homeassistant): Home Assistant Integration Hermes Agent integrates with Home Assistant in two ways: 1. Gateway platform — subscribes to real time state changes via WebSocket an
- [Webhooks](https://hermesbible.com/docs/user-guide/messaging/webhooks): Receive events from external services (GitHub, GitLab, JIRA, Stripe, etc.) and trigger Hermes agent runs automatically. The webhook adapter runs an HTTP server
- [BlueBubbles (iMessage)](https://hermesbible.com/docs/user-guide/messaging/bluebubbles): BlueBubbles (iMessage) Connect Hermes to Apple iMessage via BlueBubbles — a free, open source macOS server that bridges iMessage to any device. Prerequisites A
- [DingTalk](https://hermesbible.com/docs/user-guide/messaging/dingtalk): DingTalk Setup Hermes Agent integrates with DingTalk (钉钉) as a chatbot, letting you chat with your AI assistant through direct messages or group chats. The bot
- [Feishu / Lark](https://hermesbible.com/docs/user-guide/messaging/feishu): Feishu / Lark Setup Hermes Agent integrates with Feishu and Lark as a full featured bot. Once connected, you can chat with the agent in direct messages or group
- [Google Chat](https://hermesbible.com/docs/user-guide/messaging/google_chat): Google Chat Setup Connect Hermes Agent to Google Chat as a bot. The integration uses Cloud Pub/Sub pull subscriptions for inbound events and the Chat REST API f
- [LINE](https://hermesbible.com/docs/user-guide/messaging/line): LINE Setup Run Hermes Agent as a LINE bot via the official LINE Messaging API. The adapter lives as a bundled platform plugin under — no core edits, just enable
- [Microsoft Graph Webhook Listener](https://hermesbible.com/docs/user-guide/messaging/msgraph-webhook): The gateway platform is an inbound event listener. It's how Hermes receives change notifications from Microsoft Graph — "a Teams meeting ended," "a new message
- [ntfy](https://hermesbible.com/docs/user-guide/messaging/ntfy): ntfy ntfy is a simple HTTP based pub sub notification service. It works with the free public server at or any self hosted instance, and supports any client that
- [Open WebUI](https://hermesbible.com/docs/user-guide/messaging/open-webui): Open WebUI Integration Open WebUI (126k★) is the most popular self hosted chat interface for AI. With Hermes Agent's built in API server, you can use Open WebUI
- [Photon iMessage](https://hermesbible.com/docs/user-guide/messaging/photon): Photon iMessage Connect Hermes to iMessage through [Photon][photon], a managed service that handles the Apple line allocation and abuse prevention layer so you
- [QQ Bot](https://hermesbible.com/docs/user-guide/messaging/qqbot): QQ Bot Connect Hermes to QQ via the Official QQ Bot API (v2) — supporting private (C2C), group @ mentions, guild, and direct messages with voice transcription.
- [SimpleX Chat](https://hermesbible.com/docs/user-guide/messaging/simplex): SimpleX Chat SimpleX Chat is a private, decentralised messaging platform where users own their contacts and groups. Unlike other platforms, SimpleX assigns no p
- [Teams Meetings](https://hermesbible.com/docs/user-guide/messaging/teams-meetings): Microsoft Teams Meetings Use the Teams meeting pipeline when you want Hermes to ingest Microsoft Graph meeting events, fetch transcripts first, fall back to rec
- [Microsoft Teams](https://hermesbible.com/docs/user-guide/messaging/teams): Microsoft Teams Setup Connect Hermes Agent to Microsoft Teams as a bot. Unlike Slack's Socket Mode, Teams delivers messages by calling a public HTTPS webhook ,
- [WeCom Callback (Self-Built App)](https://hermesbible.com/docs/user-guide/messaging/wecom-callback): WeCom Callback (Self Built App) Connect Hermes to WeCom (Enterprise WeChat) as a self built enterprise application using the callback/webhook model. INFO — WeCo
- [WeCom (Enterprise WeChat)](https://hermesbible.com/docs/user-guide/messaging/wecom): Connect Hermes to WeCom (企业微信), Tencent's enterprise messaging platform. The adapter uses WeCom's AI Bot WebSocket gateway for real time bidirectional communica
- [Weixin (WeChat)](https://hermesbible.com/docs/user-guide/messaging/weixin): Connect Hermes to WeChat (微信), Tencent's personal messaging platform. The adapter uses Tencent's iLink Bot API for personal WeChat accounts — this is distinct f
- [WhatsApp Business (Cloud API)](https://hermesbible.com/docs/user-guide/messaging/whatsapp-cloud): WhatsApp Business Cloud API Setup Hermes can connect to WhatsApp through Meta's official WhatsApp Business Cloud API. This is the production grade path: no Node
- [Yuanbao](https://hermesbible.com/docs/user-guide/messaging/yuanbao): Connect Hermes to Yuanbao, Tencent's enterprise messaging platform. The adapter uses a WebSocket gateway for real time message delivery and supports both direct

### Secrets

- [Bitwarden Secrets Manager](https://hermesbible.com/docs/user-guide/secrets/bitwarden): Bitwarden Secrets Manager Pull API keys from Bitwarden Secrets Manager at process startup instead of storing them in plaintext inside . One bootstrap secret (a
- [Secrets](https://hermesbible.com/docs/user-guide/secrets/index): Secrets Hermes can pull API keys from external secret managers at process startup instead of storing them in . The bootstrap token for the secret manager lives

### Skills

- [Google Workspace — Gmail, Calendar, Drive, Sheets & Docs](https://hermesbible.com/docs/user-guide/skills/google-workspace): Google Workspace Skill Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for Hermes. Uses OAuth2 with automatic token refresh. Prefers the Google W

### Using Hermes

- [CLI Interface](https://hermesbible.com/docs/user-guide/cli): Hermes Agent's CLI is a full terminal user interface (TUI) — not a web UI. It features multiline editing, slash command autocomplete, conversation history, inte
- [TUI](https://hermesbible.com/docs/user-guide/tui): The TUI is the modern front end for Hermes — a terminal UI backed by the same Python runtime as the Classic CLI. Same agent, same sessions, same slash commands;
- [Configuration](https://hermesbible.com/docs/user-guide/configuration): All settings are stored in the directory for easy access. TIP — Easiest path to a working Run — one OAuth gets you a model provider and all four Tool Gateway to
- [Configuring Models](https://hermesbible.com/docs/user-guide/configuring-models): Configuring Models Hermes uses two kinds of model slots: Main model — what the agent thinks with. Every user message, every tool call loop, every streamed respo
- [Sessions](https://hermesbible.com/docs/user-guide/sessions): Hermes Agent automatically saves every conversation as a session. Sessions enable conversation resume, cross session search, and full conversation history manag
- [Profiles: Running Multiple Agents](https://hermesbible.com/docs/user-guide/profiles): Profiles: Running Multiple Agents Run multiple independent Hermes agents on the same machine — each with its own config, API keys, memory, sessions, skills, and
- [Git Worktrees](https://hermesbible.com/docs/user-guide/git-worktrees): Hermes Agent is often used on large, long‑lived repositories. When you want to: Run multiple agents in parallel on the same project, or Keep experimental refact
- [Docker](https://hermesbible.com/docs/user-guide/docker): Hermes Agent — Docker There are two distinct ways Docker intersects with Hermes Agent: 1. Running Hermes IN Docker — the agent itself runs inside a container (t
- [Security](https://hermesbible.com/docs/user-guide/security): Hermes Agent is designed with a defense in depth security model. This page covers every security boundary — from command approval to container isolation to user
- [Checkpoints and /rollback](https://hermesbible.com/docs/user-guide/checkpoints-and-rollback): Checkpoints and Hermes Agent can automatically snapshot your project before destructive operations and restore it with a single command. Checkpoints are opt in
- [Desktop App](https://hermesbible.com/docs/user-guide/desktop): The Hermes desktop app is a native app built around the same agent you get from the CLI and the gateway — same config, same API keys, same sessions, same skills
- [Running Many Gateways at Once](https://hermesbible.com/docs/user-guide/multi-profile-gateways): Running Many Gateways at Once Operate multiple profiles — each with its own bot tokens, sessions, and memory — as managed services on a single machine. This pag
- [Profile Distributions: Share a Whole Agent](https://hermesbible.com/docs/user-guide/profile-distributions): Profile Distributions: Share a Whole Agent A profile distribution packages a complete Hermes agent — personality, skills, cron jobs, MCP connections, config — a
- [Windows (Native) Guide](https://hermesbible.com/docs/user-guide/windows-native): Hermes runs natively on Windows 10 and Windows 11 — no WSL, no Cygwin, no Docker. This page is the deep dive: what works natively, what's WSL only, what the ins
- [Windows (WSL2) Guide](https://hermesbible.com/docs/user-guide/windows-wsl-quickstart): Hermes Agent now supports both native Windows and WSL2. This page covers the WSL2 path; for the native PowerShell install see the dedicated Windows (Native) Gui

### Integrations

- [Integrations](https://hermesbible.com/docs/integrations/index): Hermes Agent connects to external systems for AI inference, tool servers, IDE workflows, programmatic access, and more. These integrations extend what Hermes ca
- [AI Providers](https://hermesbible.com/docs/integrations/providers): This page covers setting up inference providers for Hermes Agent — from cloud APIs like OpenRouter and Anthropic, to self hosted endpoints like Ollama and vLLM,
- [Nous Portal](https://hermesbible.com/docs/integrations/nous-portal): Nous Portal is Nous Research's unified subscription gateway and the recommended way to run Hermes Agent . One OAuth login replaces the juggling act of separate

### Guides & Tutorials

- [Tips & Best Practices](https://hermesbible.com/docs/guides/tips): A quick wins collection of practical tips that make you immediately more effective with Hermes Agent. Each section targets a different aspect — scan the headers
- [Run Local LLMs on Mac](https://hermesbible.com/docs/guides/local-llm-on-mac): This guide walks you through running a local LLM server on macOS with an OpenAI compatible API. You get full privacy, zero API costs, and surprisingly good perf
- [Tutorial: Daily Briefing Bot](https://hermesbible.com/docs/guides/daily-briefing-bot): Tutorial: Build a Daily Briefing Bot In this tutorial, you'll build a personal briefing bot that wakes up every morning, researches topics you care about, summa
- [Tutorial: Team Telegram Assistant](https://hermesbible.com/docs/guides/team-telegram-assistant): Set Up a Team Telegram Assistant This tutorial walks you through setting up a Telegram bot powered by Hermes Agent that multiple team members can use. By the en
- [Using Hermes as a Python Library](https://hermesbible.com/docs/guides/python-library): Hermes isn't just a CLI tool. You can import directly and use it programmatically in your own Python scripts, web applications, or automation pipelines. This gu
- [Use MCP with Hermes](https://hermesbible.com/docs/guides/use-mcp-with-hermes): This guide shows how to actually use MCP with Hermes Agent in day to day workflows. If the feature page explains what MCP is, this guide is about how to get val
- [Use Voice Mode with Hermes](https://hermesbible.com/docs/guides/use-voice-mode-with-hermes): This guide is the practical companion to the Voice Mode feature reference. If the feature page explains what voice mode can do, this guide shows how to actually
- [Use SOUL.md with Hermes](https://hermesbible.com/docs/guides/use-soul-with-hermes): is the primary identity for your Hermes instance. It's the first thing in the system prompt — it defines who the agent is, how it speaks, and what it avoids. If
- [Build a Hermes Plugin](https://hermesbible.com/docs/guides/build-a-hermes-plugin): This guide walks through building a complete Hermes plugin from scratch. By the end you'll have a working plugin with multiple tools, lifecycle hooks, shipped d
- [Automate Anything with Cron](https://hermesbible.com/docs/guides/automate-with-cron): The daily briefing bot tutorial covers the basics. This guide goes further — five real world automation patterns you can adapt for your own workflows. For the f
- [Working with Skills](https://hermesbible.com/docs/guides/work-with-skills): Skills are on demand knowledge documents that teach Hermes how to handle specific tasks — from generating ASCII art to managing GitHub PRs. This guide walks you
- [Delegation & Parallel Work](https://hermesbible.com/docs/guides/delegation-patterns): Hermes can spawn isolated child agents to work on tasks in parallel. Each subagent gets its own conversation, terminal session, and toolset. Only the final summ
- [Tutorial: GitHub PR Review Agent](https://hermesbible.com/docs/guides/github-pr-review-agent): Tutorial: Build a GitHub PR Review Agent The problem: Your team opens PRs faster than you can review them. PRs sit for days waiting for eyeballs. Junior devs me
- [Automation Blueprints](https://hermesbible.com/docs/guides/automation-blueprints): Copy paste blueprints for common automation patterns. Each blueprint uses Hermes's built in cron scheduler for time based triggers and webhook platform for even
- [AWS Bedrock](https://hermesbible.com/docs/guides/aws-bedrock): Hermes Agent supports Amazon Bedrock as a native provider using the Converse API — not the OpenAI compatible endpoint. This gives you full access to the Bedrock
- [Microsoft Foundry](https://hermesbible.com/docs/guides/azure-foundry): Hermes Agent's provider supports Microsoft Foundry (formerly Azure AI Foundry) and Azure OpenAI. A single Foundry resource can host models with two different wi
- [Script-Only Cron Jobs (No LLM)](https://hermesbible.com/docs/guides/cron-script-only): Script Only Cron Jobs Sometimes you already know exactly what message you want to send. You don't need an agent to reason about it — you just need a script to r
- [Cron Troubleshooting](https://hermesbible.com/docs/guides/cron-troubleshooting): When a cron job isn't behaving as expected, work through these checks in order. Most issues fall into one of four categories: timing, delivery, permissions, or
- [Google Gemini](https://hermesbible.com/docs/guides/google-gemini): Hermes Agent supports Google Gemini as a native provider using the Google AI Studio / Gemini API — not the OpenAI compatible endpoint. This lets Hermes translat
- [Run Hermes Locally with Ollama — Zero API Cost](https://hermesbible.com/docs/guides/local-ollama-setup): The Problem Cloud LLM APIs charge per token. A heavy coding session can cost $5–20. For personal projects, learning, or privacy sensitive work, that adds up — a
- [Register a Microsoft Graph Application](https://hermesbible.com/docs/guides/microsoft-graph-app-registration): The Teams meeting pipeline reads meeting transcripts, recordings, and related artifacts from Microsoft Graph using app only (daemon) authentication — no user si
- [Migrate from OpenClaw](https://hermesbible.com/docs/guides/migrate-from-openclaw): imports your OpenClaw (or legacy Clawdbot/Moldbot) setup into Hermes. This guide covers exactly what gets migrated, the config key mappings, and what to verify
- [MiniMax OAuth](https://hermesbible.com/docs/guides/minimax-oauth): Hermes Agent supports MiniMax through a browser based OAuth login flow, using the same credentials as the MiniMax portal. No API key or credit card is required
- [OAuth over SSH / Remote Hosts](https://hermesbible.com/docs/guides/oauth-over-ssh): Some Hermes providers — xAI Grok OAuth , Spotify , and remote MCP servers (Linear, Sentry, Atlassian, Asana, Figma, …) — use a loopback redirect OAuth flow. The
- [Operate the Teams Meeting Pipeline](https://hermesbible.com/docs/guides/operate-teams-meeting-pipeline): Use this guide after you have already enabled the feature from Teams Meetings. This page covers: operator CLI flows routine subscription maintenance failure tri
- [Pipe Script Output to Messaging Platforms](https://hermesbible.com/docs/guides/pipe-script-output): is a small, scriptable CLI that pushes a message to any messaging platform Hermes is already configured for. Think of it as a cross platform for notifications —
- [Run Hermes Agent with Nous Portal](https://hermesbible.com/docs/guides/run-hermes-with-nous-portal): This guide walks you through running Hermes Agent on a Nous Portal subscription end to end — from signing up to verifying that every tool routes correctly. If y
- [Run Nemotron 3 Ultra free in Hermes Agent](https://hermesbible.com/docs/guides/run-nemotron-3-ultra-free): Nous Research has been inducted into the Nemotron Coalition of leading AI labs working with NVIDIA to advance open frontier foundation models. In honor of this,
- [Automated GitHub PR Comments with Webhooks](https://hermesbible.com/docs/guides/webhook-github-pr-review): This guide walks you through connecting Hermes Agent to GitHub so it automatically fetches a pull request's diff, analyzes the code changes, and posts a comment
- [xAI Grok OAuth (SuperGrok / X Premium+)](https://hermesbible.com/docs/guides/xai-grok-oauth): Hermes Agent supports xAI Grok through a browser based OAuth login flow against accounts.x.ai, using either a SuperGrok subscription (grok.com) or an X Premium+

### Developer Guide

- [Contributing](https://hermesbible.com/docs/developer-guide/contributing): Thank you for contributing to Hermes Agent! This guide covers setting up your dev environment, understanding the codebase, and getting your PR merged. Contribut
- [Architecture](https://hermesbible.com/docs/developer-guide/architecture): This page is the top level map of Hermes Agent internals. Use it to orient yourself in the codebase, then dive into subsystem specific docs for implementation d
- [Agent Loop Internals](https://hermesbible.com/docs/developer-guide/agent-loop): The core orchestration engine is 's class — a large file that handles everything from prompt assembly to tool dispatch to provider failover. Core Responsibiliti
- [Prompt Assembly](https://hermesbible.com/docs/developer-guide/prompt-assembly): Hermes deliberately separates: cached system prompt state ephemeral API call time additions This is one of the most important design choices in the project beca
- [Context Compression and Caching](https://hermesbible.com/docs/developer-guide/context-compression-and-caching): Context Compression and Caching Hermes Agent uses a dual compression system and Anthropic prompt caching to manage context window usage efficiently across long
- [Gateway Internals](https://hermesbible.com/docs/developer-guide/gateway-internals): The messaging gateway is the long running process that connects Hermes to 20+ external messaging platforms through a unified architecture. Key Files File Purpos
- [Session Storage](https://hermesbible.com/docs/developer-guide/session-storage): Session Storage Hermes Agent uses a SQLite database ( ) to persist session metadata, full message history, and model configuration across CLI and gateway sessio
- [Provider Runtime Resolution](https://hermesbible.com/docs/developer-guide/provider-runtime): Hermes has a shared provider runtime resolver used across: CLI gateway cron jobs ACP auxiliary model calls Primary implementation: — credential resolution, — pr
- [Adding Tools](https://hermesbible.com/docs/developer-guide/adding-tools): Before writing a tool, ask yourself: should this be a skill instead? WARNING — Built in Core Tools Only This page is for adding a built in Hermes tool to the re
- [Adding Providers](https://hermesbible.com/docs/developer-guide/adding-providers): Hermes can already talk to any OpenAI compatible endpoint through the custom provider path. Do not add a built in provider unless you want first class UX for th
- [Adding a Platform Adapter](https://hermesbible.com/docs/developer-guide/adding-platform-adapters): Adding a Platform Adapter This guide covers adding a new messaging platform to the Hermes gateway. A platform adapter connects Hermes to an external messaging s
- [Creating Skills](https://hermesbible.com/docs/developer-guide/creating-skills): Skills are the preferred way to add new capabilities to Hermes Agent. They're easier to create than tools, require no code changes to the agent, and can be shar
- [Extending the CLI](https://hermesbible.com/docs/developer-guide/extending-the-cli): Hermes exposes protected extension hooks on so wrapper CLIs can add widgets, keybindings, and layout customizations without overriding the 1000+ line method. Th
- [ACP Internals](https://hermesbible.com/docs/developer-guide/acp-internals): The ACP adapter wraps Hermes' synchronous in an async JSON RPC stdio server. Key implementation files: Boot flow The Zed ACP Registry path launches the same ada
- [Browser CDP Supervisor](https://hermesbible.com/docs/developer-guide/browser-supervisor): The CDP supervisor closes two long standing gaps in Hermes' browser tooling: 1. Native JS dialogs ( / / / ) block the page's JS thread. Without supervision, the
- [Context Engine Plugins](https://hermesbible.com/docs/developer-guide/context-engine-plugin): Building a Context Engine Plugin Context engine plugins replace the built in with an alternative strategy for managing conversation context. For example, a Loss
- [Cron Internals](https://hermesbible.com/docs/developer-guide/cron-internals): The cron subsystem provides scheduled task execution — from simple one shot delays to recurring cron expression jobs with skill injection and cross platform del
- [Image Generation Provider Plugins](https://hermesbible.com/docs/developer-guide/image-gen-provider-plugin): Building an Image Generation Provider Plugin Image gen provider plugins register a backend that services every tool call — DALL·E, gpt image, Grok, Flux, Imagen
- [Memory Provider Plugins](https://hermesbible.com/docs/developer-guide/memory-provider-plugin): Building a Memory Provider Plugin Memory provider plugins give Hermes Agent persistent, cross session knowledge beyond the built in MEMORY.md and USER.md. This
- [Model Provider Plugins](https://hermesbible.com/docs/developer-guide/model-provider-plugin): Building a Model Provider Plugin Model provider plugins declare an inference backend — an OpenAI compatible endpoint, an Anthropic Messages server, a Codex styl
- [Plugin LLM Access](https://hermesbible.com/docs/developer-guide/plugin-llm-access): is the supported way for a plugin to make an LLM call. Chat completion, structured extraction, sync, async, with or without images — same surface, same trust ga
- [Programmatic Integration](https://hermesbible.com/docs/developer-guide/programmatic-integration): Hermes ships three protocols for driving the agent from external programs — IDE plugins, custom UIs, CI pipelines, embedded sub agents. Pick the one that matche
- [Tools Runtime](https://hermesbible.com/docs/developer-guide/tools-runtime): Hermes tools are self registering functions grouped into toolsets and executed through a central registry/dispatch system. Primary files: Tool registration mode
- [Trajectory Format](https://hermesbible.com/docs/developer-guide/trajectory-format): Trajectory Format Hermes Agent saves conversation trajectories in ShareGPT compatible JSONL format for use as training data, debugging artifacts, and reinforcem
- [Video Generation Provider Plugins](https://hermesbible.com/docs/developer-guide/video-gen-provider-plugin): Building a Video Generation Provider Plugin Video gen provider plugins register a backend that services every tool call. Built in providers (xAI, FAL) ship as p
- [Web Search Provider Plugins](https://hermesbible.com/docs/developer-guide/web-search-provider-plugin): Building a Web Search Provider Plugin Web search provider plugins register a backend that services , , and (optionally) deep crawl tool calls. Built in provider

### Reference

- [CLI Commands Reference](https://hermesbible.com/docs/reference/cli-commands): This page covers the terminal commands you run from your shell. For in chat slash commands, see Slash Commands Reference. Global entrypoint Global options Optio
- [Slash Commands Reference](https://hermesbible.com/docs/reference/slash-commands): Hermes has two slash command surfaces, both driven by a central in : Interactive CLI slash commands — dispatched by , with autocomplete from the registry Messag
- [Profile Commands Reference](https://hermesbible.com/docs/reference/profile-commands): Profile Commands Reference This page covers all commands related to Hermes profiles. For general CLI commands, see CLI Commands Reference. Top level command for
- [Environment Variables](https://hermesbible.com/docs/reference/environment-variables): Environment Variables Reference All variables go in . You can also set them with . LLM Providers Variable Description OpenRouter API key (recommended for flexib
- [Built-in Tools Reference](https://hermesbible.com/docs/reference/tools-reference): This page documents Hermes' built in tools, grouped by toolset. Availability varies by platform, credentials, and enabled toolsets. Quick counts (current regist
- [Toolsets Reference](https://hermesbible.com/docs/reference/toolsets-reference): Toolsets are named bundles of tools that control what the agent can do. They're the primary mechanism for configuring tool availability per platform, per sessio
- [MCP Config Reference](https://hermesbible.com/docs/reference/mcp-config-reference): This page is the compact reference companion to the main MCP docs. For conceptual guidance, see: MCP (Model Context Protocol) Use MCP with Hermes Root config sh
- [Model Catalog](https://hermesbible.com/docs/reference/model-catalog): Model Catalog Hermes fetches curated model lists for OpenRouter and Nous Portal from a JSON manifest hosted alongside the docs site. This lets maintainers updat
- [Bundled Skills Catalog](https://hermesbible.com/docs/reference/skills-catalog): Hermes ships with a large built in skill library copied into on install. Each skill below links to a dedicated page with its full definition, setup, and usage.
- [Optional Skills Catalog](https://hermesbible.com/docs/reference/optional-skills-catalog): Optional skills ship with hermes agent under but are not active by default . Install them explicitly: For example: Each skill below links to a dedicated page wi
- [FAQ & Troubleshooting](https://hermesbible.com/docs/reference/faq): Quick answers and fixes for the most common questions and issues. Frequently Asked Questions What LLM providers work with Hermes? Hermes Agent works with any Op

## Community Flows

### Architecture

- [Hermes Agent as a Personal AI Operating System](https://hermesbible.com/flows/hermes-as-personal-ai-operating-system) (by YanXbt): A layer-by-layer analysis of Hermes mapped to operating-system concepts — memory, profiles, Kanban, cron, /goal, skills, the Curator, Tool Search, the Gateway, voice, and security — plus the compounding effect, token economics, and how it compares to other frameworks.
- [8 Loops Inside Hermes Agent (And Why They Compound)](https://hermesbible.com/flows/8-loops-inside-hermes-agent) (by YanXbt): A complete map of the eight loops Hermes Agent runs simultaneously — from the millisecond core loop to the weekly Curator — how they nest across timescales, and what breaks when any one of them fails.

### Automation

- [How to Make Hermes + xurl Actually Work as a System](https://hermesbible.com/flows/hermes-xurl-as-a-system) (by YanXbt): xurl gives your Hermes agent direct access to X — searching, reading, and publishing. On its own it's just an execution tool. Paired with /goal, research, and memory, it becomes a structured, repeatable content system.
- [Hermes /goal — The Full Guide](https://hermesbible.com/flows/hermes-goal-the-full-guide) (by YanXbt): A complete guide to Hermes' /goal command — what it does, every subcommand, how to write strong measurable goals, the recommended workflow, best practices, and ready-to-use example prompts.
- [Hermes Agent Builds Itself While You Sleep: The Complete Guide to the 9-Hour Overnight Workflow](https://hermesbible.com/flows/hermes-9-hour-overnight-workflow) (by YanXbt): A full hour-by-hour map of the autonomous overnight cycle — from session close and self-improvement to knowledge ingestion, the morning briefing, the infrastructure behind it, and the security layers that make unattended operation safe.
- [Grok + Hermes + Telegram: A Real-Time X Intelligence Stack](https://hermesbible.com/flows/grok-hermes-telegram-realtime-x-stack) (by YanXbt): Pair Grok's native real-time X access with Hermes Agent's persistent scheduling and Telegram delivery to build a 24/7 intelligence agent that drafts a morning brief before you wake up — using your existing SuperGrok subscription.
- [The Complete Hermes Agent /goal Playbook](https://hermesbible.com/flows/complete-goal-playbook-21-workflows) (by YanXbt): 21 copy-paste /goal commands across 6 categories — research, lead gen, content, email, operations, and development — plus a Chief of Staff setup that runs your entire morning ops autonomously.
- [10 Hermes Agent Hacks That Turned My Chat Agent Into a 24/7 System](https://hermesbible.com/flows/10-hermes-hacks-24-7-system) (by YanXbt): Ten domain-agnostic Hermes setups — mission control, event triggers, cron jobs, structured /goal, sub-agents, Telegram workspaces, Kanban, skills, webhooks, and separate agents — that turn a chat window into a system that runs while you sleep.

### Configuration

- [Hermes Agent SOUL.md: Why 50 Lines Matter More Than Your Model](https://hermesbible.com/flows/soul-md-why-50-lines-matter-more-than-your-model) (by YanXbt): A complete guide to SOUL.md — where it sits in the prompt stack, what belongs in it, token economics, advanced role templates, /personality overlays, profiles, and the iterative method for growing an effective agent identity.
- [I'm Not Sharing My SOUL.md. I'm Sharing Something More Useful.](https://hermesbible.com/flows/soul-md-operating-contract-template) (by Tony): Why a SOUL.md is an operating contract, not a personality hack — plus a sanitized, copy-paste template you can adapt to make your Hermes Agent behave like an operator instead of a chatbot.
- [The 170-Line SOUL.md That Made My Hermes Agent Dangerous](https://hermesbible.com/flows/170-line-soul-md-that-made-hermes-dangerous) (by Tony): Why a single 170-line markdown file — not a secret model or magic framework — is what makes a Hermes Agent push back, hold you accountable, and act like an operator instead of a chatbot.
- [10 Real Hermes Agent Settings That Actually Matter](https://hermesbible.com/flows/10-hermes-settings-that-matter) (by Tony): A no-nonsense rundown of the real Hermes configuration that moves the needle — identity, memory, profiles, cron, gateway, MCP, skills, context files, delegation, and plugins. Real config keys and commands only, no made-up env vars.

### Desktop & GUI

- [Hermes Desktop: a full tour of the native GUI for Hermes Agent](https://hermesbible.com/flows/hermes-desktop-full-tour) (by Tony): A hands-on walkthrough of Hermes Desktop — the native Electron app that wraps the full Hermes Agent runtime. Same config, keys, sessions, skills, and memory as the CLI and TUI, with a real settings UI, live tool output, a file browser, voice mode, and remote-backend support.

### Engineering Automation

- [How we used four AI agents to turn Jira tickets into reviewed PRs for about $12 each](https://hermesbible.com/flows/jira-to-pr-four-agents) (by Luke): An event-driven engineering workflow where four specialized Hermes agents handle ticket intake, coding, review, and CI — while humans keep merge authority. Routine tickets go from intake to reviewed PR in about four hours for roughly $12 in AI spend.

### Guides

- [Hidden Features in Hermes You Should Know About](https://hermesbible.com/flows/hidden-hermes-features-you-should-know) (by hermes_updates): A community-sourced collection of lesser-known Hermes Agent commands and behaviors — cross-platform /handoff, session resume, context compression levers, local browser via CDP, the REST API, the native desktop app, /steer mid-task, and delegating to Claude Code.
- [Hermes Agent FULL GUIDE: Architecture, Setup, and the Self-Improving Loop](https://hermesbible.com/flows/hermes-full-guide-architecture-setup-self-improving-loop) (by Scotty Beam): A complete walkthrough of how Hermes is put together — installation, model routing, terminal backends, messaging, context and memory engines — and how its self-improving loop turns conversations into permanent upgrades.
- [Hermes Agent: The Complete Guide — From Zero to Self-Improving AI Employee](https://hermesbible.com/flows/hermes-complete-guide-zero-to-self-improving) (by YanXbt): An end-to-end guide to running Hermes Agent 24/7: installation, model selection, messaging, the dashboard most people use wrong, use cases, the self-improvement loop, and security.

### Integrations

- [Hermes + Grok: Three New Superpowers That Change the Workflow](https://hermesbible.com/flows/hermes-grok-three-new-superpowers) (by babyape113): If you already pay for X Premium, you already have Grok. Connect it to Hermes with one OAuth login — no API key — and the agent reads X for you, runs browser tasks, and executes multi-skill playbooks from a single slash command. A tour of X Search, Browse.sh, and Skill Bundles.

### Memory & Context

- [Forget About Memory: Building a Context OS for Your Hermes Agent](https://hermesbible.com/flows/context-os-for-hermes-agent) (by Tony): Most AI memory is a sticky note. This flow breaks down an 11-layer context architecture for Hermes Agent — identity, facts, procedures, session archives, compression, and scheduled routines — and the distinctions that decide whether your agent actually remembers how you work.

### Multi-Agent

- [Hermes + NotebookLM + Obsidian: Build a 3-Agent Research Department That Gets Smarter Every Day](https://hermesbible.com/flows/3-agent-research-department-notebooklm-obsidian) (by YanXbt): A three-profile Hermes setup where Scout finds signals, Analyst synthesizes through NotebookLM, and Briefer delivers a morning brief — coordinated through a shared Obsidian vault. Roughly $19-27/month, one evening to set up.

### Orchestration

- [How to Become a Hermes Agent Operator](https://hermesbible.com/flows/how-to-become-a-hermes-agent-operator) (by Mike): Go from a single Hermes install to a control room orchestrating a team of specialist agents on one cheap VPS. Covers install, memory and SOUL.md, the orchestrator pattern, messaging surfaces, cron, and the operator mindset that makes it all compound.
- [How to Dominate Projects with the Hermes Agent Kanban Board](https://hermesbible.com/flows/dominate-projects-with-hermes-kanban) (by Tony): One agent is the wrong unit once work grows teeth. This field manual shows how to use Hermes Kanban — boards, tasks, claims, blocks, schedules, and receipts — to give long-running multi-agent work durable coordination that survives a dead shell.

### Security

- [Hermes x Bitwarden: The Security Stack AI Agents Actually Need](https://hermesbible.com/flows/hermes-bitwarden-security-stack) (by YanXbt): How Hermes Agent ships credential management (Bitwarden Secrets Manager) and credential protection (iron-proxy egress firewall) as composable, first-class infrastructure — not README advice.

### Self-Improvement

- [Introducing Hermes Dreaming: Reviewable Self-Improvement for Hermes Agent](https://hermesbible.com/flows/hermes-dreaming-reviewable-self-improvement) (by Tony): Hermes Dreaming is a staged, artifact-first self-improvement engine for Hermes Agent. It proposes changes as reviewable artifacts you can diff, validate, apply, or discard — turning self-improvement into a receipt trail instead of silent mutation.

### Trading

- [Hermes + Polymarket: A Self-Learning Up/Down Trading Agent](https://hermesbible.com/flows/hermes-polymarket-self-learning-trading-agent) (by YanXbt): A step-by-step guide to building a self-learning Hermes agent that trades Polymarket 5-minute up/down crypto markets — VPS setup, Telegram control, CLOB v2 execution, and a self-improving loop that adjusts probability estimates from live results.