explaingit

hermes-labs-ai/zer0dex

Analysis updated 2026-05-18

52PythonAudience · developerComplexity · 4/5Setup · hard

TLDR

A local, two layer memory system that gives AI agents long term recall by pairing a compressed index with automatic vector search.

Mindmap

mindmap
  root((zer0dex))
    What it does
      Stores agent memory locally
      Combines index and vector search
      Auto injects context per message
    Tech stack
      Python
      Ollama
      mem0
      chromadb
    Use cases
      Persistent AI agent memory
      Cross project context recall
      Local alternative to hosted memory
    Audience
      Developers
      AI 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 long running AI agent persistent memory across sessions without a hosted service.

USE CASE 2

Let an agent connect facts across different projects or topics automatically.

USE CASE 3

Replace a single flat memory file with a structured, queryable local memory layer.

What is it built with?

PythonOllamamem0chromadb

How does it compare?

hermes-labs-ai/zer0dexamaravijayalakshmi216-collab/crop-recommendation-systemitssaisathan/screenshot-search-engine
Stars525252
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity4/52/52/5
Audiencedeveloperresearchergeneral

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Python 3.11+, Ollama, an embedding model, an extraction model, and 8GB+ RAM before it runs.

License is referenced via a badge in the README but the specific terms are not stated in the source, so usage terms are unknown.

In plain English

zer0dex is a local memory system for AI agents that need to remember information across many conversations or sessions. The problem it addresses is that AI agents typically start each session with a blank slate, or they store everything in one giant text file and still struggle to find the right information at the right moment, or they rely on a vector search that finds isolated facts without understanding how those facts relate to each other. The system works in two layers. The first is a compressed, human readable markdown index file that stays loaded in the agent's context at all times, acting like a table of contents that tells the agent what categories of knowledge exist without storing every detail. The second layer is a local vector store, built on mem0 and chromadb, that holds extracted facts from logs, conversations, and notes, and is searched by meaning rather than exact keywords. A lightweight local server keeps this vector store warm and automatically runs a query before every message the agent receives, injecting the top matching memories into its context without anyone having to decide manually what is relevant. According to the project's own benchmark of 97 test cases, this two layer approach reached 91.2% recall, compared to 52.2% for a flat memory file and 80.3% for vector search alone. The gap was largest on cross reference questions, ones that require connecting facts from two different topics, where the combined approach scored 80% against 37.5% for vector search by itself. The whole system runs locally with no ongoing hosting cost. You would use this if you are building or running a persistent AI agent that needs to remember past conversations, project details, or user preferences over long periods, without paying for a hosted memory service. It is written in Python, installed with pip, and requires Ollama, a tool for running AI models locally, along with an embedding model and an extraction model pulled through it.

Copy-paste prompts

Prompt 1
Help me install zer0dex and set up Ollama with the required embedding and extraction models.
Prompt 2
Walk me through creating a MEMORY.md index file and seeding it into zer0dex.
Prompt 3
Explain how zer0dex's two layer memory architecture compares to plain vector search.
Prompt 4
Help me connect my AI agent to the zer0dex HTTP API so it queries memory before each message.

Frequently asked questions

What is zer0dex?

A local, two layer memory system that gives AI agents long term recall by pairing a compressed index with automatic vector search.

What language is zer0dex written in?

Mainly Python. The stack also includes Python, Ollama, mem0.

What license does zer0dex use?

License is referenced via a badge in the README but the specific terms are not stated in the source, so usage terms are unknown.

How hard is zer0dex to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is zer0dex for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.