git404hub

what is zer0dex fr?

hermes-labs-ai/zer0dex — explained in plain English

Analysis updated 2026-05-18

52PythonAudience · developerComplexity · 4/5Setup · hard

tl;dr

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

vibe map

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 make with this?

VIBE 1

Give a long running AI agent persistent memory across sessions without a hosted service.

VIBE 2

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

VIBE 3

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

what's the stack?

PythonOllamamem0chromadb

how it stacks up fr

hermes-labs-ai/zer0dexamaravijayalakshmi216-collab/crop-recommendation-systembiansy000/mda
Stars525252
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity4/52/55/5
Audiencedeveloperresearcherresearcher

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

how do i run it?

Difficulty · hard time til it works · 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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.