whatisgithub

What is hermes-llm-wiki-provider?

bjb2/hermes-llm-wiki-provider — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A memory plugin for the hermes-agent AI framework that turns conversation history into a curated, cross-linked markdown wiki for long-term recall.

Mindmap

mindmap
  root((repo))
    What it does
      Long-term memory
      Wiki compilation
    Tech stack
      Python
      OpenAI-compatible API
    Use cases
      Persistent agent memory
      Knowledge retrieval
    Audience
      AI agent developers
      Researchers

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

Add persistent, cross-session memory to a hermes-agent deployment.

USE CASE 2

Let an AI agent search and read a self-maintaining wiki of things it has learned.

USE CASE 3

Run background wiki compilation on a cheap language model while using a stronger model for live conversation.

What is it built with?

PythonpytestOpenAI-compatible API

How does it compare?

bjb2/hermes-llm-wiki-provider0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity4/54/51/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing hermes-agent setup and an OpenAI-compatible endpoint for the compile model.

Free to use, modify, and distribute, even commercially, as long as you keep the original copyright and license notice.

So what is it?

hermes-llm-wiki-provider is a memory plugin for hermes-agent, an AI assistant framework. It gives the agent a form of long-term memory by maintaining a structured wiki on disk, a collection of interconnected markdown pages where each page covers a specific concept or entity that has come up in conversations. The approach keeps raw conversation history in an append-only source folder, then uses a background process to periodically have a language model distill that material into cleaner, curated wiki pages with cross-links between related concepts. This means each new conversation turn is saved instantly with no AI involvement, while the heavier work of organizing knowledge happens separately in the background. When the agent needs to recall something, it searches the wiki using a keyword index and expands outward through link relationships between pages, without an AI call for retrieval. The agent can also explicitly ask the memory system to store a specific fact, which gets folded into the wiki on the next compilation pass. The plugin exposes four tools to the agent: searching the wiki by query, reading a specific page in full, exploring the links around a page, and explicitly storing a fact. Configuration lets you point the compilation step at any language model with an OpenAI-compatible API, keeping it independent of the main agent's model, so compilation can run on a cheaper or separate endpoint. You would use this if you are building or extending a hermes-agent setup and want it to accumulate knowledge across sessions rather than starting fresh each time. The plugin is written in Python, has an offline test suite that runs without a live language model, and is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how the sources folder and the compiled wiki folder relate to each other in this plugin.
Prompt 2
Walk me through configuring the compile model endpoint using environment variables.
Prompt 3
Help me use the wiki_search and wiki_remember tools from within a hermes-agent session.
Prompt 4
Show me how to install this plugin into a hermes-agent HERMES_HOME directory.

Frequently asked questions

What is hermes-llm-wiki-provider?

A memory plugin for the hermes-agent AI framework that turns conversation history into a curated, cross-linked markdown wiki for long-term recall.

What language is hermes-llm-wiki-provider written in?

Mainly Python. The stack also includes Python, pytest, OpenAI-compatible API.

What license does hermes-llm-wiki-provider use?

Free to use, modify, and distribute, even commercially, as long as you keep the original copyright and license notice.

How hard is hermes-llm-wiki-provider to set up?

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

Who is hermes-llm-wiki-provider for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.