System Reference June 10, 2026
โข
Updated June 10, 2026
โข
10 min read
โข
2102 words
Complete condensed reference: Hermes Agent config + full docs, local projects, skills, tools, cron jobs, plugins, infrastructure โ everything on one page.
reference
cheat-sheet
architecture
deployment
Hermes Agent โ Local Config โ๏ธ Config (~/.hermes/config.yaml) Setting Value Default model nvidia/nemotron-3-ultra-550b-a55b:freeFallback model openrouter/owl-alphaFallback chain openrouter/owl-alpha โ openrouter/freeVision/media nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:freeProvider OpenRouter Goal turns 77 Agent max turns 60 Compression enabled, threshold 0.33 Context engine compressor Gateway timeout 1800s
โจ๏ธ CLI Essentials 1
2
3
4
5
6
7
8
hermes config set <key> <val> # Set config value
hermes config show # Full config
hermes skills list # List skills
hermes skills reload # Reload after edits
hermes sessions list # Active sessions
hermes --resume <id> # Resume session
hermes gateway restart # Restart gateway
hermes logs --follow # Live log tail
๐ Key Paths 1
2
3
4
5
6
7
8
9
~/.hermes/config.yaml # Main config
~/.hermes/.env # API keys (NOT inherited by crons)
~/.hermes/skills/ # Installed skills
~/.hermes/cron/ # Cron job output
~/.hermes/logs/ # agent.log, errors.log, gateway.log
~/.hermes/dreams/ # Dream Swarm reports (dated)
~/.hermes/plugins/ # Hermes plugins (OMP Suite)
~/.hermes/kanban.db # OMP Kanban SQLite
~/.hermes/state.db # Session/usage stats SQLite
Hermes Agent โ Full Documentation Condensed Condensed from hermes-agent.nousresearch.com/docs/llms.txt โ the complete Hermes Agent documentation index. Covers all 10 doc categories, ~100 pages.
๐ 1. Getting Started Topic What Installation curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash โ Linux, macOS, WSL2, TermuxQuickstart Install โ first conversation in <5 min Learning Path Choose path by experience level and goals Updating Update or uninstall to latest version Termux (Android) Run Hermes directly on Android phone Nix Setup nix run quick start โ fully declarative NixOS module with container mode
Repo : github.com/NousResearch/hermes-agent
๐ฅ๏ธ 2. Using Hermes Topic What CLI Terminal interface โ commands, keybindings, personalities TUI Ink terminal UI โ mouse-friendly, rich overlays, non-blocking input Configuration config.yaml, providers, models, API keysConfiguring Models Model setup and switching Sessions Persistence, resume, search, management, per-platform tracking Profiles Isolated Hermes instances with own config/skills/cron Git Worktrees Run multiple Hermes agents safely on same repo Docker Backend Run in Docker or use Docker as terminal backend Security Dangerous command approval, user authorization, container isolation Checkpoints & Rollback Shadow git repos + automatic snapshots for destructive ops
โก 3. Core Features Topic What Tools Built-in tools overview, toolsets, terminal backends Skills System On-demand knowledge docs โ progressive disclosure, agent-managed, Skills Hub Curator Background maintenance for agent-created skills โ usage tracking, staleness, archival Memory MEMORY.md, USER.md, session search โ remembers across sessionsMemory Providers External plugins: Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory Context Files .hermes.md, AGENTS.md, CLAUDE.md, global SOUL.md, .cursorrules โ auto-injectedContext References Inline @-syntax for attaching files, folders, git diffs, URLs into messages Personality & SOUL.md Customize voice โ global SOUL.md, built-in personalities, custom personas Plugins Extend with custom tools, hooks, integrations Built-in Plugins Shipped plugins via lifecycle hooks (disk-cleanup, etc.)
๐ค 4. Automation Topic What Cron Jobs Schedule tasks with natural language, one cron tool, attach skills Delegation delegate_task โ spawn isolated child agents for parallel workstreamsKanban Multi-Agent Durable SQLite-backed task board for coordinating multiple profiles Kanban Tutorial Step-by-step kanban setup Persistent Goals Standing goal across turns until done (Ralph loop) Code Execution Python execution with RPC tool access โ collapse multi-step workflows Hooks Custom code at lifecycle points โ log, alert, webhook Batch Processing Generate agent trajectories at scale โ parallel, checkpointing, toolset distribution
Topic What Voice Mode Real-time voice โ CLI, Telegram, Discord (DMs, text + voice channels) Browser Full browser automation โ navigate, click, snapshot, vision Vision Image analysis with auxiliary vision model Image Generation Generate images via integrated providers Text-to-Speech TTS + voice message transcription across all platforms
Platform Setup Telegram Bot via BotFather Discord Bot via Discord Developer Portal Slack Bot via Socket Mode WhatsApp Bot via built-in Baileys bridge Signal Bot via signal-cli daemon Email IMAP/SMTP assistant SMS Chatbot via Twilio Matrix Bot via Matrix SDK Mattermost Bot integration Home Assistant Smart home integration Webhooks GitHub, GitLab triggers DingTalk Enterprise messaging Yuanbao Chat platform Microsoft Teams Via plugin LINE Messaging platform IRC Via plugin API Server OpenAI-compatible frontend
๐ 7. Integrations Topic What Providers Nous Portal, OpenRouter, OpenAI, Anthropic, Google, any OpenAI-compatible MCP Model Context Protocol โ connect external tool servers, filter which tools Hermes loads ACP Agent Context Protocol โ use Hermes inside VS Code, Zed, JetBrains API Server Expose as OpenAI-compatible API for any frontend Honcho Memory AI-native persistent memory โ dialectic reasoning, multi-agent user modeling Provider Routing Route requests across providers Fallback Providers Automatic failover chain Credential Pools Rotate across multiple API keys
๐ 8. Guides & Tutorials Guide What Tips & Best Practices Prompt tips, CLI shortcuts, context files, memory, cost optimization, security Local LLMs on Mac llama.cpp / MLX on Apple Silicon โ model selection, memory optimization, benchmarks Daily Briefing Bot Research โ summarize โ deliver to Telegram/Discord every morning Team Telegram Assistant Bot for whole team โ code help, research, sysadmin Python Library Embed AIAgent in your own scripts/apps โ no CLI required Use MCP with Hermes Connect MCP servers, filter tools, safe real workflows Use Voice Mode Setup voice across CLI, Telegram, Discord voice channels Use SOUL.md Shape default voice โ what belongs there vs AGENTS.md vs /personality Build a Plugin Complete plugin with tools, hooks, data files, skills Automate with Cron Real-world patterns โ monitoring, reports, pipelines, multi-skill Work with Skills Find, install, use, create skills Delegation Patterns When/how to use subagents โ parallel research, code review, multi-file GitHub PR Review Agent Auto code reviewer โ monitor repos, review PRs, deliver feedback
๐ ๏ธ 9. Developer Guide Topic What Contributing Dev setup, code style, PR process Architecture Major subsystems, execution paths, data flow Agent Loop AIAgent execution, API modes, tools, callbacks, fallback Prompt Assembly System prompt building, cache stability, ephemeral layers Context Compression & Caching Compression strategies, prompt caching Gateway Internals Boot, authorization, session routing, message delivery Session Storage SQLite session store with FTS5 search Provider Runtime Provider resolution, credentials, API modes, auxiliary models Adding Tools Schemas, handlers, registration, toolsets Adding Providers Auth, runtime resolution, CLI flows, adapters, tests, docs Adding Platform Adapters New messaging platform integration Creating Skills SKILL.md format, guidelines, publishing Extending the CLI Wrapper CLIs with custom widgets, keybindings, layout
๐ 10. Reference Reference What CLI Commands Authoritative terminal command reference Slash Commands Complete CLI + messaging slash command reference Profile Commands Profile management commands Environment Variables All env vars used by Hermes Tools Reference All built-in tools grouped by toolset Toolsets Reference Core, composite, platform, dynamic toolsets MCP Config Reference MCP config keys, filtering semantics, utility-tool policy Model Catalog Available models across providers Bundled Skills Catalog ~90 skills shipped with Hermes Optional Skills Catalog ~60 additional installable skills FAQ & Troubleshooting Common issues and solutions
Cron Jobs Job Schedule Skills Toolsets Purpose llm-wiki-evolveDaily 03:00 hugo-llm-wikiterminal, file Research โ build โ deploy โ verify live site Nightly Dream SwarmDaily 04:44 nightly-sentinelterminal, file, delegation Ecosystem diagnostic โ dream.md + Discord report
Dream Swarm Naming Reports saved as ~/.hermes/dreams/YYYY-MM-DD/YYYY-MM-DD_{vivid-title}.md โ poetic 2-3 word title derived from dominant signal of the day.
Examples: vivid-kanban-dream, marathon-embed-session, silent-cost-drift
Cron Env Critical : Cron jobs spawn isolated shells โ env vars from ~/.hermes/.env are NOT inherited . Always source first:
1
set -a; source ~/.hermes/.env; set +a
Local Projects Active / Primary Project Path Stack Purpose LLM-Wiki ~/hugo-llm-wiki/Hugo + vanilla JS Self-discovering docs site (this site) Wiki ~/wiki/Markdown Personal knowledge base macos-web ~/macos-web/Svelte 5 + Vite macOS dashboard app Lyrix ~/lyrix-bench/Svelte 5 + Vite Lyrix benchmark app LRX ~/lrx/Svelte + Tailwind Web app Daisy ~/daisyskull/Svelte + Vite DaisyUI project Skeleton ~/skeleton/Monorepo (pnpm) Skeleton UI framework OMP Suite ~/.hermes/plugins/omp-suite/Python Routa kanban + wterm terminal plugin
Dev Experiments Project Path eleven3, flow2batch, flow2draw ~/dev/generative-ai-docs, terracraft ~/dev/todprod, udytor, vibesdk ~/dev/vinki, z_uditor ~/dev/
Dashboards & CMS Project Path Stack Purpose Svelte Flexiboards ~/svelte-flexiboards-dashboard/Svelte 5 FlexiBoard dashboard prototype hugo-sveltia-lab ~/hugo-sveltia-lab/Hugo + Sveltia Hugo + Sveltia CMS experiment sveltia-cms ~/sveltia-cms/Svelte monorepo Sveltia CMS core svelteflow ~/svelteflow/Svelte + XYFlow Flow editor hugging_chat-ui ~/hugging_chat-ui/Svelte + Tailwind HuggingFace chat UI deep-chat ~/deep-chat/Web component Chat UI library merms ~/merms/โ Mermaid ecosystem tools Dicebear ~/dicebeardev/โ Avatar library dev
Nginx-Served Domains Domain Path Purpose llm-wiki.0rk.de~/hugo-llm-wiki/public/LLM Wiki (this site) mixbox-review.0rk.deโ Mixbox review n8n.0rk.deโ n8n automation opendaw-studio.0rk.deโ OpenDAW studio opendaw-yjs.0rk.deโ OpenDAW YJS sync
Archived Project Path Notes daistory ~/daistory/DaisyUI monorepo scrapez ~/scrapez/Python scraping GURU ~/GURU/Reference material ASSETS ~/ASSETS/Static assets .antigravity-server ~/.antigravity-server/Server project mj-tools ~/mj-tools/sref-panel tool docs ~/docs/General docs
Plugins OMP Suite (~/.hermes/plugins/omp-suite/) Property Value LOC 1,626 Tables 5 SQLite Endpoints 17 Hooks 7 Git 3 commits, no remote (private)
6 Kanban specialist skills (~/.hermes/skills/routas-rs/):
Skill Role routas-backlog-refinerClarify scope, write cards routas-blocked-resolverClassify blockers routas-dev-crafterImplement scoped changes routas-done-reporterTerminal lane, produce completion report routas-review-guardIndependently verify routas-todo-orchestratorRe-validate backlog
Dashboard: port 9119. Kanban board: omp-suite-swarm.
Skills Skill Categories (30 dirs, 7 with SKILL.md) Category Active Skill Purpose hermes-essentialsโ
SKILL.md Core config, debugging, planning, TDD superpower-pipelineโ
SKILL.md Research + web search pipeline superpower-researchโ
SKILL.md Deep research automation omp-suiteโ
SKILL.md OMP plugin agent hugo-llm-wikiโ
SKILL.md Hugo docs site patterns (loaded by cron) thermo-nuclear-code-quality-reviewโ
SKILL.md Strict maintainability review transcript-extractโ
SKILL.md Extract transcripts from URLs discord-interview-dashboardโ
SKILL.md Discord bot dashboard frontend/svelte-flexiboards-dashboard Svelte 5 dashboard patterns devops/discord-send-embed, nightly-sentinel, server-disk-ops, puter, hermes-dashboard-plugins DevOps tools routas-rs/6 specialist skills (see OMP above) Kanban workflow mlops/evaluation, inference, models, research, training, vector-databases (subdirs) ML ops reference 23 other dirs DESCRIPTION.md only Reference stubs โ no active workflow
Skill Stats 30 skill directories total7 with full SKILL.md (executable workflows)~100 total files across all skill dirsPruned: svelte-dashboard-integration (replaced by vanilla dashboard) Core Infrastructure Tool Version Purpose Hugo 0.140+ Static site generator Nginx โ Reverse proxy + SSL Let’s Encrypt (Certbot) โ SSL certificates Python 3 โ Research automation, scripts Node.js 22 Svelte dev (not in deploy pipeline) npm 10 Package management OpenRouter โ LLM API provider DuckDuckGo โ Research search (API often blocked)
Svelte Ecosystem Framework Usage Svelte 5 macOS dashboard, Lyrix, Flexiboards DaisyUI Component framework Skeleton UI Component library XYFlow Flow editor (svelteflow) FlexiBoard Drag-and-drop dashboard panels
Python Ecosystem Domain Tools Scraping Scrapy (scrapez) ML/AI Generative AI docs, vibesdk Data flow2batch, flow2draw
Infrastructure Hugo Site 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
hugo - llm - wiki /
โโโ config . toml # Site config, baseURL, outputs
โโโ content /
โ โโโ _index . md # Homepage
โ โโโ llm - wiki - reference . md # This page
โ โโโ topics / # AI/Hugo/Svelte research topics (6 pages)
โ โโโ research / # Research automation docs
โ โโโ evolving / # Continuously updated changelog
โโโ themes / lotusdocs /
โ โโโ layouts /
โ โ โโโ _default /
โ โ โ โโโ baseof . html # HTML shell + sidebar + nav
โ โ โ โโโ single . html # Article layout
โ โ โ โโโ list . html # Section index
โ โ โ โโโ list . json . json # JSON feed per section
โ โ โโโ index . html # Homepage layout
โ โ โโโ topic / list . json . json # Topic JSON
โ โโโ static / css / main . css # Dark theme
โโโ scripts /
โ โโโ deploy . sh # hugo --minify โ nginx reload
โ โโโ research - automation . py # DuckDuckGo โ Hugo markdown
โโโ public / # Built output โ Nginx
Deploy Pipeline 1
2
3
4
5
# One command
cd ~/hugo-llm-wiki && hugo --minify && sudo nginx -t && sudo systemctl reload nginx
# Script
bash ~/hugo-llm-wiki/scripts/deploy.sh
Nginx 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
server {
listen 443 ssl http2 ;
server_name llm-wiki.0rk.de ;
root /home/dv/hugo-llm-wiki/public ;
index index.html ;
ssl_certificate /etc/letsencrypt/live/llm-wiki.0rk.de/fullchain.pem ;
ssl_certificate_key /etc/letsencrypt/live/llm-wiki.0rk.de/privkey.pem ;
location / {
add_header Access-Control-Allow-Origin * always ;
try_files $uri $uri/ = 404 ;
}
location /dashboard {
try_files $uri $uri/ /dashboard/index.html ;
}
location ~ * \.(css|js|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot) $ {
expires 7d ;
add_header Cache-Control "public, immutable" ;
}
}
Topic Knowledge Base Managed in ~/hugo-llm-wiki/content/topics/. Fed by JSON API at /topics/index.json.
Topic File Status Hugo documentation automation hugo-documentation-automation-patterns.mdโ
Complete LLM-powered knowledge bases llm-powered-knowledge-bases.mdโ
Complete Self-discovering doc systems self-discovering-documentation-systems.mdโ
Complete AI content evolution ai-content-evolution-strategies.mdโ
Complete Svelte 5 best practices svelte-5-best-practices.mdโ
Complete Svelte 5 migration guide svelte-5-migration-guide.mdโ
Complete
Data flow : research-automation.py โ content/topics/*.md โ hugo build โ /topics/index.json โ dashboard SPA
Quick Ref Task Command Hermes model switch hermes config set model.default "prov/model:free"New Hugo content hugo new content/topics/my-topic.mdHugo dev server hugo server -DHugo build hugo --minifyDeploy bash ~/hugo-llm-wiki/scripts/deploy.shCheck JSON feed curl -s llm-wiki.0rk.de/topics/index.json | python3 -m json.toolRun research python3 ~/hugo-llm-wiki/scripts/research-automation.pyView Hermes logs tail -f ~/.hermes/logs/agent.logNginx test+reload sudo nginx -t && sudo systemctl reload nginxList cron jobs hermes cron listSource env (cron) set -a; source ~/.hermes/.env; set +a