whatisgithub

What is hermes-nexus-memory?

neboy72/hermes-nexus-memory — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A lightweight Python plugin that gives Hermes Agent persistent, searchable memory using Qdrant and a choice of three embedding providers.

Mindmap

mindmap
  root((hermes nexus memory))
    What it does
      Persistent agent memory
      Semantic search
      Survives restarts
    Tech stack
      Python
      Qdrant
      Embedding providers
    Use cases
      Remember facts
      Search by meaning
      Local or cloud embeddings
    Audience
      Developers
      Agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give a Hermes Agent persistent memory that survives restarts and model switches

USE CASE 2

Search past facts, decisions, and patterns by meaning instead of exact keywords

USE CASE 3

Choose between a free local embedding model or a paid cloud provider for quality

USE CASE 4

Save, search, and delete specific agent memories through three simple tools

What is it built with?

PythonQdrantsentence-transformersOllama

How does it compare?

neboy72/hermes-nexus-memorya-bissell/unleash-liteabhiinnovates/whatsapp-hr-assistant
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/53/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Python 3.11+, a local Qdrant server on port 6333, and Hermes Agent already installed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Hermes Nexus Memory is a Python plugin that gives Hermes Agent persistent memory using Qdrant, a vector database, so the agent no longer forgets everything at the end of a session. It lets an AI agent search past facts, decisions, and patterns by meaning rather than exact keyword matching, and that stored information survives restarts, model switches, and gateway restarts. The plugin exposes three tools: one to search memories semantically, one to save a new memory with a category and source, and one to delete a specific memory by its ID. It works with three different embedding providers, which are the underlying systems that turn text into the numeric vectors used for semantic search. The default is sentence-transformers, which runs locally in Python and needs no account or API key. A second option runs through Ollama as a local service. The third, Voyage, is a paid cloud API that offers the highest quality results but requires signing up for an API key. Setup is done with a single install script, followed by restarting the Hermes gateway, or through a built-in setup wizard that walks you through picking an embedding provider. The system requires Python 3.11 or newer and a Qdrant server running locally on the default port. The author positions this as a smaller and simpler alternative to other memory plugins, at roughly 400 lines of Python code, with local operation by default and no mandatory external API dependency, compared to some alternatives that require thousands of lines of code or a mandatory cloud account. The project includes a troubleshooting table covering common issues like missing tools, a Qdrant server that is not running, or lost memories after switching embedding providers. It is licensed under MIT.

Copy-paste prompts

Prompt 1
Help me install Hermes Nexus Memory and set it up with sentence-transformers
Prompt 2
Explain the difference between the sentence-transformers, Ollama, and Voyage embedding options
Prompt 3
Show me how to troubleshoot a Qdrant connection issue with Nexus memory
Prompt 4
Walk me through switching Hermes Nexus Memory from local embeddings to the Voyage cloud API

Frequently asked questions

What is hermes-nexus-memory?

A lightweight Python plugin that gives Hermes Agent persistent, searchable memory using Qdrant and a choice of three embedding providers.

What language is hermes-nexus-memory written in?

Mainly Python. The stack also includes Python, Qdrant, sentence-transformers.

What license does hermes-nexus-memory use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is hermes-nexus-memory to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hermes-nexus-memory for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.