Integration Quickstart

The Hermes plugin installs a memory provider and context engine that connect Hermes sessions to an Agentic Memory backend. It exposes 28 model-callable tools and uses canonical /v1/* backend routes by default.

Prerequisites

• An Agentic Memory API key from /account
• Hermes Agent installed and accessible on your PATH
• uvx available (bundled with uv)

1. Install the plugin

uvx agentic-memory-hermes install --force

If you previously installed an older version, force uv to refresh:

uvx --refresh-package agentic-memory-hermes agentic-memory-hermes install --force

This single command copies the memory provider and context engine into Hermes' plugin tree and runs:

• hermes config set memory.provider agentic-memory
• hermes config set context.engine agentic-memory

2. Configure credentials

Add your API key to the Hermes .env file:

AGENTIC_MEMORY_API_KEY=your-account-api-key

Non-secret config lives at $HERMES_HOME/agentic-memory.json and is written by hermes memory setup.

3. Verify

Start a Hermes session. The provider exposes these tools to the model:

• agentic_memory_search — relevance retrieval across conversations, research, and code
• agentic_memory_projects — list known project and repo IDs
• agentic_memory_read — read a canonical memory result
• agentic_memory_context — resolve compact context for the current task
• 24 passthrough tools: search_codebase, get_file_dependencies, trace_execution_path, search_conversations, memory graph CRUD, project scoping, and more

Forbidden tools (raw deletes, diagnostics, graph schema queries, Brave search, research scheduling) are never exposed to the model.