🧠 Episemic

Brain-inspired memory system for AI agents

Python 3.11+ Async/Await Brain-Inspired Production Ready

📚 Table of Contents

🎯 For Users: Start with the Simple API Documentation below. The internal architecture is completely hidden from you - just use episemic.remember() and episemic.recall()!

🚀 Quick Start

Get started with Episemic in just a few lines of code:

import asyncio from episemic import Episemic async def main(): async with Episemic() as episemic: # Store a memory memory = await episemic.remember( "Python is great for AI development", tags=["programming", "python"] ) # Search memories results = await episemic.recall("python programming") print(f"Found {len(results)} memories") asyncio.run(main())

For non-async code:

from episemic import EpistemicSync episemic = EpistemicSync() episemic.start() memory = episemic.remember("Important info", tags=["work"]) results = episemic.recall("important")

👤 User API Documentation

These are the only classes and methods you need to know as a user:

🧠 Episemic (Main Class)

The main async interface for storing and retrieving memories. Use this for modern async Python code.

View Documentation

🔄 EpistemicSync

Synchronous wrapper for traditional Python code that doesn't use async/await.

View Documentation

💭 Memory

Simple memory object with properties like .text, .title, .tags, .created_at, and .metadata.

View Documentation

🔍 SearchResult

Search result containing a Memory object and relevance score (0.0 to 1.0).

View Documentation

📋 API Methods

⚙️ Internal API Documentation

Advanced documentation for developers who want to understand or extend the internal architecture:

🔧 Configuration

Internal configuration management system for databases and services.

View Documentation

🏗️ Data Models

Internal Pydantic models for memory objects, search queries, and system state.

View Documentation

🎯 High-Level API

The EpistemicAPI class that the simple interface uses internally.

View Documentation

⚡ Hippocampus

Fast vector storage using Qdrant and Redis for recent memories.

View Documentation

🏛️ Cortex

Long-term relational storage using PostgreSQL for persistent memories.

View Documentation

🔄 Consolidation

Memory consolidation engine that transfers memories from fast to persistent storage.

View Documentation

🎯 Retrieval

Multi-path retrieval engine using vector similarity, tags, and graph traversal.

View Documentation

💻 CLI

Command-line interface built with Typer and Rich for terminal usage.

View Documentation

🏗️ Architecture Documentation

💡 Examples & Guides

🚀 Getting Started Checklist

  1. Install dependencies: poetry install
  2. Set up databases (PostgreSQL, Qdrant, Redis)
  3. Try the simple API: from episemic import Episemic
  4. Store your first memory: await episemic.remember("Hello world!")
  5. Search for it: await episemic.recall("hello")