System Reference

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)

SettingValue
Default modelnvidia/nemotron-3-ultra-550b-a55b:free
Fallback modelopenrouter/owl-alpha
Fallback chainopenrouter/owl-alpha โ†’ openrouter/free
Vision/medianvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free
ProviderOpenRouter
Goal turns77
Agent max turns60
Compressionenabled, threshold 0.33
Context enginecompressor
Gateway timeout1800s

โŒจ๏ธ 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

TopicWhat
Installationcurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash โ€” Linux, macOS, WSL2, Termux
QuickstartInstall โ†’ first conversation in <5 min
Learning PathChoose path by experience level and goals
UpdatingUpdate or uninstall to latest version
Termux (Android)Run Hermes directly on Android phone
Nix Setupnix run quick start โ†’ fully declarative NixOS module with container mode

Repo: github.com/NousResearch/hermes-agent

๐Ÿ–ฅ๏ธ 2. Using Hermes

TopicWhat
CLITerminal interface โ€” commands, keybindings, personalities
TUIInk terminal UI โ€” mouse-friendly, rich overlays, non-blocking input
Configurationconfig.yaml, providers, models, API keys
Configuring ModelsModel setup and switching
SessionsPersistence, resume, search, management, per-platform tracking
ProfilesIsolated Hermes instances with own config/skills/cron
Git WorktreesRun multiple Hermes agents safely on same repo
Docker BackendRun in Docker or use Docker as terminal backend
SecurityDangerous command approval, user authorization, container isolation
Checkpoints & RollbackShadow git repos + automatic snapshots for destructive ops

โšก 3. Core Features

TopicWhat
ToolsBuilt-in tools overview, toolsets, terminal backends
Skills SystemOn-demand knowledge docs โ€” progressive disclosure, agent-managed, Skills Hub
CuratorBackground maintenance for agent-created skills โ€” usage tracking, staleness, archival
MemoryMEMORY.md, USER.md, session search โ€” remembers across sessions
Memory ProvidersExternal plugins: Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover, Supermemory
Context Files.hermes.md, AGENTS.md, CLAUDE.md, global SOUL.md, .cursorrules โ€” auto-injected
Context ReferencesInline @-syntax for attaching files, folders, git diffs, URLs into messages
Personality & SOUL.mdCustomize voice โ€” global SOUL.md, built-in personalities, custom personas
PluginsExtend with custom tools, hooks, integrations
Built-in PluginsShipped plugins via lifecycle hooks (disk-cleanup, etc.)

๐Ÿค– 4. Automation

TopicWhat
Cron JobsSchedule tasks with natural language, one cron tool, attach skills
Delegationdelegate_task โ€” spawn isolated child agents for parallel workstreams
Kanban Multi-AgentDurable SQLite-backed task board for coordinating multiple profiles
Kanban TutorialStep-by-step kanban setup
Persistent GoalsStanding goal across turns until done (Ralph loop)
Code ExecutionPython execution with RPC tool access โ€” collapse multi-step workflows
HooksCustom code at lifecycle points โ€” log, alert, webhook
Batch ProcessingGenerate agent trajectories at scale โ€” parallel, checkpointing, toolset distribution

๐ŸŽจ 5. Media & Web

TopicWhat
Voice ModeReal-time voice โ€” CLI, Telegram, Discord (DMs, text + voice channels)
BrowserFull browser automation โ€” navigate, click, snapshot, vision
VisionImage analysis with auxiliary vision model
Image GenerationGenerate images via integrated providers
Text-to-SpeechTTS + voice message transcription across all platforms

๐Ÿ’ฌ 6. Messaging Platforms (17)

PlatformSetup
TelegramBot via BotFather
DiscordBot via Discord Developer Portal
SlackBot via Socket Mode
WhatsAppBot via built-in Baileys bridge
SignalBot via signal-cli daemon
EmailIMAP/SMTP assistant
SMSChatbot via Twilio
MatrixBot via Matrix SDK
MattermostBot integration
Home AssistantSmart home integration
WebhooksGitHub, GitLab triggers
DingTalkEnterprise messaging
YuanbaoChat platform
Microsoft TeamsVia plugin
LINEMessaging platform
IRCVia plugin
API ServerOpenAI-compatible frontend

๐Ÿ”Œ 7. Integrations

TopicWhat
ProvidersNous Portal, OpenRouter, OpenAI, Anthropic, Google, any OpenAI-compatible
MCPModel Context Protocol โ€” connect external tool servers, filter which tools Hermes loads
ACPAgent Context Protocol โ€” use Hermes inside VS Code, Zed, JetBrains
API ServerExpose as OpenAI-compatible API for any frontend
Honcho MemoryAI-native persistent memory โ€” dialectic reasoning, multi-agent user modeling
Provider RoutingRoute requests across providers
Fallback ProvidersAutomatic failover chain
Credential PoolsRotate across multiple API keys

๐Ÿ“– 8. Guides & Tutorials

GuideWhat
Tips & Best PracticesPrompt tips, CLI shortcuts, context files, memory, cost optimization, security
Local LLMs on Macllama.cpp / MLX on Apple Silicon โ€” model selection, memory optimization, benchmarks
Daily Briefing BotResearch โ†’ summarize โ†’ deliver to Telegram/Discord every morning
Team Telegram AssistantBot for whole team โ€” code help, research, sysadmin
Python LibraryEmbed AIAgent in your own scripts/apps โ€” no CLI required
Use MCP with HermesConnect MCP servers, filter tools, safe real workflows
Use Voice ModeSetup voice across CLI, Telegram, Discord voice channels
Use SOUL.mdShape default voice โ€” what belongs there vs AGENTS.md vs /personality
Build a PluginComplete plugin with tools, hooks, data files, skills
Automate with CronReal-world patterns โ€” monitoring, reports, pipelines, multi-skill
Work with SkillsFind, install, use, create skills
Delegation PatternsWhen/how to use subagents โ€” parallel research, code review, multi-file
GitHub PR Review AgentAuto code reviewer โ€” monitor repos, review PRs, deliver feedback

๐Ÿ› ๏ธ 9. Developer Guide

TopicWhat
ContributingDev setup, code style, PR process
ArchitectureMajor subsystems, execution paths, data flow
Agent LoopAIAgent execution, API modes, tools, callbacks, fallback
Prompt AssemblySystem prompt building, cache stability, ephemeral layers
Context Compression & CachingCompression strategies, prompt caching
Gateway InternalsBoot, authorization, session routing, message delivery
Session StorageSQLite session store with FTS5 search
Provider RuntimeProvider resolution, credentials, API modes, auxiliary models
Adding ToolsSchemas, handlers, registration, toolsets
Adding ProvidersAuth, runtime resolution, CLI flows, adapters, tests, docs
Adding Platform AdaptersNew messaging platform integration
Creating SkillsSKILL.md format, guidelines, publishing
Extending the CLIWrapper CLIs with custom widgets, keybindings, layout

๐Ÿ“š 10. Reference

ReferenceWhat
CLI CommandsAuthoritative terminal command reference
Slash CommandsComplete CLI + messaging slash command reference
Profile CommandsProfile management commands
Environment VariablesAll env vars used by Hermes
Tools ReferenceAll built-in tools grouped by toolset
Toolsets ReferenceCore, composite, platform, dynamic toolsets
MCP Config ReferenceMCP config keys, filtering semantics, utility-tool policy
Model CatalogAvailable models across providers
Bundled Skills Catalog~90 skills shipped with Hermes
Optional Skills Catalog~60 additional installable skills
FAQ & TroubleshootingCommon issues and solutions

Cron Jobs

JobScheduleSkillsToolsetsPurpose
llm-wiki-evolveDaily 03:00hugo-llm-wikiterminal, fileResearch โ†’ build โ†’ deploy โ†’ verify live site
Nightly Dream SwarmDaily 04:44nightly-sentinelterminal, file, delegationEcosystem 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

ProjectPathStackPurpose
LLM-Wiki~/hugo-llm-wiki/Hugo + vanilla JSSelf-discovering docs site (this site)
Wiki~/wiki/MarkdownPersonal knowledge base
macos-web~/macos-web/Svelte 5 + VitemacOS dashboard app
Lyrix~/lyrix-bench/Svelte 5 + ViteLyrix benchmark app
LRX~/lrx/Svelte + TailwindWeb app
Daisy~/daisyskull/Svelte + ViteDaisyUI project
Skeleton~/skeleton/Monorepo (pnpm)Skeleton UI framework
OMP Suite~/.hermes/plugins/omp-suite/PythonRouta kanban + wterm terminal plugin

Dev Experiments

ProjectPath
eleven3, flow2batch, flow2draw~/dev/
generative-ai-docs, terracraft~/dev/
todprod, udytor, vibesdk~/dev/
vinki, z_uditor~/dev/

Dashboards & CMS

ProjectPathStackPurpose
Svelte Flexiboards~/svelte-flexiboards-dashboard/Svelte 5FlexiBoard dashboard prototype
hugo-sveltia-lab~/hugo-sveltia-lab/Hugo + SveltiaHugo + Sveltia CMS experiment
sveltia-cms~/sveltia-cms/Svelte monorepoSveltia CMS core
svelteflow~/svelteflow/Svelte + XYFlowFlow editor
hugging_chat-ui~/hugging_chat-ui/Svelte + TailwindHuggingFace chat UI
deep-chat~/deep-chat/Web componentChat UI library
merms~/merms/โ€”Mermaid ecosystem tools
Dicebear~/dicebeardev/โ€”Avatar library dev

Nginx-Served Domains

DomainPathPurpose
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

ProjectPathNotes
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/)

PropertyValue
LOC1,626
Tables5 SQLite
Endpoints17
Hooks7
Git3 commits, no remote (private)

6 Kanban specialist skills (~/.hermes/skills/routas-rs/):

SkillRole
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)

CategoryActive SkillPurpose
hermes-essentialsโœ… SKILL.mdCore config, debugging, planning, TDD
superpower-pipelineโœ… SKILL.mdResearch + web search pipeline
superpower-researchโœ… SKILL.mdDeep research automation
omp-suiteโœ… SKILL.mdOMP plugin agent
hugo-llm-wikiโœ… SKILL.mdHugo docs site patterns (loaded by cron)
thermo-nuclear-code-quality-reviewโœ… SKILL.mdStrict maintainability review
transcript-extractโœ… SKILL.mdExtract transcripts from URLs
discord-interview-dashboardโœ… SKILL.mdDiscord bot dashboard
frontend/svelte-flexiboards-dashboardSvelte 5 dashboard patterns
devops/discord-send-embed, nightly-sentinel, server-disk-ops, puter, hermes-dashboard-pluginsDevOps 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 dirsDESCRIPTION.md onlyReference stubs โ€” no active workflow

Skill Stats

  • 30 skill directories total
  • 7 with full SKILL.md (executable workflows)
  • ~100 total files across all skill dirs
  • Pruned: svelte-dashboard-integration (replaced by vanilla dashboard)

Tools & Stack

Core Infrastructure

ToolVersionPurpose
Hugo0.140+Static site generator
Nginxโ€”Reverse proxy + SSL
Let’s Encrypt (Certbot)โ€”SSL certificates
Python 3โ€”Research automation, scripts
Node.js22Svelte dev (not in deploy pipeline)
npm10Package management
OpenRouterโ€”LLM API provider
DuckDuckGoโ€”Research search (API often blocked)

Svelte Ecosystem

FrameworkUsage
Svelte 5macOS dashboard, Lyrix, Flexiboards
DaisyUIComponent framework
Skeleton UIComponent library
XYFlowFlow editor (svelteflow)
FlexiBoardDrag-and-drop dashboard panels

Python Ecosystem

DomainTools
ScrapingScrapy (scrapez)
ML/AIGenerative AI docs, vibesdk
Dataflow2batch, 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.

TopicFileStatus
Hugo documentation automationhugo-documentation-automation-patterns.mdโœ… Complete
LLM-powered knowledge basesllm-powered-knowledge-bases.mdโœ… Complete
Self-discovering doc systemsself-discovering-documentation-systems.mdโœ… Complete
AI content evolutionai-content-evolution-strategies.mdโœ… Complete
Svelte 5 best practicessvelte-5-best-practices.mdโœ… Complete
Svelte 5 migration guidesvelte-5-migration-guide.mdโœ… Complete

Data flow: research-automation.py โ†’ content/topics/*.md โ†’ hugo build โ†’ /topics/index.json โ†’ dashboard SPA


Quick Ref

TaskCommand
Hermes model switchhermes config set model.default "prov/model:free"
New Hugo contenthugo new content/topics/my-topic.md
Hugo dev serverhugo server -D
Hugo buildhugo --minify
Deploybash ~/hugo-llm-wiki/scripts/deploy.sh
Check JSON feedcurl -s llm-wiki.0rk.de/topics/index.json | python3 -m json.tool
Run researchpython3 ~/hugo-llm-wiki/scripts/research-automation.py
View Hermes logstail -f ~/.hermes/logs/agent.log
Nginx test+reloadsudo nginx -t && sudo systemctl reload nginx
List cron jobshermes cron list
Source env (cron)set -a; source ~/.hermes/.env; set +a