Skip to main content
Give Hermes Agent persistent memory backed by your Cognee Cloud tenant with a drop-in memory provider plugin. Each completed turn is stored in Cognee’s session cache and promoted into the permanent knowledge graph at session end — no code required.

​
1. Install the plugin

The cognee-integration-hermes-agent package is not yet published on PyPI. Install it locally from the cognee-integrations repository:
Requires Python 3.10+. The plugin declares cognee>=1.0.0,<2.0.0 as a pip dependency.

​
2. Connect to Cognee Cloud

Hermes connects to Cloud in remote mode: set COGNEE_BASE_URL (and COGNEE_API_KEY) to your tenant. There are no silent fallbacks — if the configured mode fails, the failure surfaces.
No LLM key is needed in remote mode — your tenant does the knowledge extraction server-side. Non-secret settings are also saved to $HERMES_HOME/cognee.json; secrets go to $HERMES_HOME/.env.

​
3. Run and verify

Run Hermes as usual — memory is captured and recalled automatically:
During a session, just talk to the agent:
The provider exposes three memory tools to the agent:
  • cognee_recall — session-first recall with graph fallback
  • cognee_remember — persist content into the knowledge graph
  • cognee_forget — delete memory
At session end, if COGNEE_IMPROVE_ON_END=true (the default), cognee.improve(...) promotes the session cache into your permanent graph.

​
Configuration

Manage the plugin with hermes cognee status, hermes cognee setup, hermes cognee config, and hermes cognee install.

Full integration guide

Tools, connection modes, and how it works

Hermes Agent

Learn about Hermes Agent