# hermes-agent | Nous Research | Knowledge Base | Instagit

The agent that grows with you

GitHub Stars: 2.4k

Repository: https://github.com/NousResearch/hermes-agent

---

## Articles

### [How to Add New Messaging Platform Adapters to the Hermes Agent Gateway](/NousResearch/hermes-agent/adding-new-messaging-platform-adapters-to-hermes-agent-gateway)

Learn how to add new messaging platform adapters to the Hermes Agent gateway. Integrate custom platforms by subclassing BasePlatform, implementing async methods, and registering your adapter.

- Tags: how-to-guide
- Published: 2026-03-09

### [How Hermes Agent Integrates with Atropos for RL Training: Architecture & Implementation](/NousResearch/hermes-agent/hermes-agent-rl-training-environment-integration-with-atropos)

Discover how Hermes Agent integrates with Atropos for RL training. Explore the architecture and implementation details for sandboxed rollouts and deterministic reward computation.

- Tags: architecture
- Published: 2026-03-09

### [Understanding the Event Hooks System in Hermes Agent: A Complete Guide](/NousResearch/hermes-agent/hermes-agent-event-hooks-system-creating-custom-hooks)

Explore Hermes Agent's event hooks system to extend functionality with custom Python code. Learn to create your own hooks in ~/.hermes/hooks/ with this complete guide.

- Tags: how-to-guide
- Published: 2026-03-09

### [How the execute_code Tool Enables Programmatic Tool Calling with RPC in Hermes Agent](/NousResearch/hermes-agent/how-execute-code-tool-enables-programmatic-tool-calling-rpc-hermes-agent)

Learn how the execute_code tool enables programmatic tool calling with RPC in Hermes Agent. LLM-generated Python scripts can invoke tools from a sandboxed child process.

- Tags: deep-dive
- Published: 2026-03-09

### [Configuration System Structure and Migration in Hermes CLI: A Complete Guide](/NousResearch/hermes-agent/hermes-cli-config-py-configuration-structure-config-migration)

Explore the Hermes CLI configuration system structure in hermes_cli/config.py. Learn how settings and secrets are managed and discover the automatic config migration process.

- Tags: how-to-guide
- Published: 2026-03-09

### [How Hermes Agent Implements Prompt Caching with Anthropic's cache_control](/NousResearch/hermes-agent/hermes-agent-prompt-caching-system-anthropic-cache-control)

Discover how Hermes Agent slashes API costs by up to 75% using Anthropic's cache_control for efficient prompt caching in multi-turn conversations. Learn about prompt caching.

- Tags: how-to-guide
- Published: 2026-03-09

### [Hermes Agent ShareGPT Trajectory Format: Structure and Implementation](/NousResearch/hermes-agent/hermes-agent-trajectory-format-for-sharegpt-conversations)

Understand the Hermes Agent ShareGPT trajectory format. Learn how conversations are saved as JSONL records with speaker roles, tool interactions, and metadata for efficient persistence.

- Tags: internals
- Published: 2026-03-09

### [How Hermes Agent Implements DM Pairing and User Allowlist Security](/NousResearch/hermes-agent/hermes-agent-gateway-dm-pairing-user-allowlist-security)

Discover how Hermes Agent secures gateway access with DM pairing and user allowlist controls across platforms. Learn about its two-layer authorization model for enhanced security.

- Tags: how-to-guide
- Published: 2026-03-09

### [How Environment Variables Control Provider Routing and Model Selection in Hermes Agent](/NousResearch/hermes-agent/hermes-agent-environment-variables-provider-routing-model-selection)

Discover how environment variables like HERMES_INFERENCE_PROVIDER and HERMES_MODEL control provider routing and model selection in Hermes Agent for dynamic inference.

- Tags: how-to-guide
- Published: 2026-03-09

### [How batch_runner.py Implements Parallel Trajectory Generation in Hermes Agent](/NousResearch/hermes-agent/how-batch-runner-py-implements-parallel-trajectory-generation-hermes-agent)

Discover how batch_runner.py in Hermes Agent achieves parallel trajectory generation using multiprocessing for efficient large-scale research runs and fault tolerance.

- Tags: internals
- Published: 2026-03-09

### [MCP Integration Pattern in Hermes Agent: A Complete Guide to Connecting External MCP Servers](/NousResearch/hermes-agent/hermes-agent-mcp-integration-pattern-connecting-external-mcp-servers)

Understand the MCP integration pattern in Hermes Agent. This guide details connecting external MCP servers as native tools using a discovery and registration system.

- Tags: how-to-guide
- Published: 2026-03-09

### [How Hermes Agent Implements Memory and User Modeling Using Honcho](/NousResearch/hermes-agent/hermes-agent-memory-and-user-modeling-with-honcho)

Learn how Hermes Agent uses Honcho to build AI-native sessions, manage long-term memory, prefetch user context, and dynamically retrieve user information for enhanced conversations.

- Tags: deep-dive
- Published: 2026-03-09

### [How to Create Custom Skills and Contribute to the Skills Hub Ecosystem in Hermes Agent](/NousResearch/hermes-agent/creating-custom-skills-and-skills-hub-ecosystem-hermes-agent)

Learn how to create custom skills and contribute to the Hermes Agent Skills Hub. Follow our guide for authoring, testing, and publishing your own skills.

- Tags: how-to-guide
- Published: 2026-03-09

### [How the Cron Scheduler Integrates with the Messaging Gateway in Hermes Agent](/NousResearch/hermes-agent/hermes-agent-cron-scheduler-integration-messaging-gateway-automated-task-delivery)

Discover how Hermes Agent's cron scheduler integrates with the messaging gateway to automate task delivery. Learn how it runs jobs and sends messages to chat platforms.

- Tags: how-to-guide
- Published: 2026-03-09

### [How the Dangerous Command Approval System Works in Hermes Agent](/NousResearch/hermes-agent/hermes-agent-dangerous-command-approval-system-terminal-tool)

Discover how Hermes Agent's dangerous command approval system safeguards your terminal. Learn about regex pattern matching, allow-lists, and user approval before command execution.

- Tags: deep-dive
- Published: 2026-03-09

### [Understanding the Toolset System in Hermes Agent: Platform-Based Tool Grouping](/NousResearch/hermes-agent/hermes-agent-toolset-system-structure-and-tool-grouping-per-platform)

Explore the Hermes Agent toolset system and discover how tools are grouped by platform. Learn about shared core tools and platform-specific extensions for enhanced functionality.

- Tags: deep-dive
- Published: 2026-03-09

### [How Hermes Agent Implements Session Search Using FTS5 and LLM Summarization](/NousResearch/hermes-agent/hermes-agent-session-search-with-fts5-and-llm-summarization)

Discover how Hermes Agent enhances session search with FTS5 for fast retrieval and LLM summarization for concise, relevant results. Learn about our efficient two-stage pipeline.

- Tags: deep-dive
- Published: 2026-03-09

### [How delegate_tool Enables Subagent Spawning and Iteration Budget Sharing in Hermes Agent](/NousResearch/hermes-agent/how-delegate-tool-enables-subagent-spawning-iteration-budget-sharing-hermes-agent)

Learn how the delegate_tool in Hermes Agent spawns subagents and shares iteration budgets. Discover its role in enhancing agent capabilities and managing resources effectively.

- Tags: deep-dive
- Published: 2026-03-09

### [How the Context Compression System in Hermes Agent Handles Long Conversations](/NousResearch/hermes-agent/hermes-agent-context-compression-system-for-long-conversations)

Learn how Hermes Agent's context compression system manages long conversations by summarizing middle turns, preserving key messages for optimal AI interaction.

- Tags: deep-dive
- Published: 2026-03-09

### [AIAgent Class Architecture and Agent Loop in Hermes Agent: A Deep Dive](/NousResearch/hermes-agent/architecture-of-aiagent-class-and-agent-loop-in-hermes-agent-run-agent-py)

Explore the AIAgent class architecture and agent loop in NousResearch/hermes-agent. Understand LLM interactions, tool execution, and context management within run_agent.py.

- Tags: deep-dive
- Published: 2026-03-09

### [How the Hermes Agent Skills System Works and Its agentskills.io Compatibility](/NousResearch/hermes-agent/hermes-agent-skills-system-implementation-agentskills-io-compatibility)

Discover how Hermes Agent's skills system works, storing reusable knowledge and ensuring full agentskillsio compatibility. Learn about its progressive-disclosure implementation.

- Tags: internals
- Published: 2026-03-09

### [How the Hermes Agent Messaging Gateway Handles Platform-Specific Adapters for Telegram, Discord, Slack, and WhatsApp](/NousResearch/hermes-agent/hermes-agent-messaging-gateway-platform-adapters-telegram-discord-slack-whatsapp)

Discover how the Hermes Agent messaging gateway uses platform-specific adapters for Telegram, Discord, Slack, and WhatsApp. Run unified conversational logic across all platforms efficiently.

- Tags: how-to-guide
- Published: 2026-03-09

### [Hermes Agent Terminal Backends: Comparing Local, Docker, SSH, Daytona, Singularity, and Modal](/NousResearch/hermes-agent/differences-between-hermes-agent-terminal-backends-local-docker-ssh-daytona-singularity-modal)

Compare Hermes Agent terminal backends: local, Docker, SSH, Daytona, Singularity, and Modal. Understand their trade-offs in isolation, persistence, and resource management for optimal selection.

- Tags: comparison
- Published: 2026-03-09

### [How the Tool Registry System Works in Hermes Agent: A Complete Guide](/NousResearch/hermes-agent/how-does-the-tool-registry-system-work-and-add-new-tools-in-hermes-agent)

Discover how Hermes Agent's central tool registry system dynamically manages function schemas, Python handlers, and metadata for seamless tool discovery and dispatch. Learn to add new tools.

- Tags: how-to-guide
- Published: 2026-03-09