# OpenMemory — Self-Hosted Cognitive Memory Engine for AI Agents

> A self-hosted memory engine that gives AI agents persistent long-term memory with multi-sector storage, temporal reasoning, and explainable recall beyond simple RAG.

## Install

Save in your project root:

# OpenMemory — Self-Hosted Cognitive Memory Engine for AI Agents

## Quick Use
```bash
git clone https://github.com/CaviraOSS/OpenMemory.git
cd OpenMemory
docker compose up -d
# API available at http://localhost:8000
```

## Introduction
OpenMemory is a self-hosted cognitive memory engine designed to give AI agents real long-term memory. It goes beyond traditional RAG and vector databases by implementing multi-sector memory storage, temporal reasoning, and explainable recall mechanisms.

## What OpenMemory Does
- Stores and retrieves memories across multiple semantic sectors
- Provides temporal reasoning so agents recall when events happened
- Returns explainable recall paths showing why a memory was retrieved
- Supports memory consolidation to merge related fragments over time
- Exposes a REST API for integration with any AI agent framework

## Architecture Overview
OpenMemory organizes memories into sectors (episodic, semantic, procedural) inspired by cognitive science models. Each memory is stored with vector embeddings, temporal metadata, and relational links. On recall, the engine scores candidates by relevance, recency, and importance, then returns results with explanation traces. A background consolidation process periodically merges and reinforces related memories.

## Self-Hosting & Configuration
- Deploy with Docker Compose for a single-command setup
- Requires a vector store backend (built-in or external like Qdrant)
- Configure memory sectors and retention policies via environment variables
- API key authentication protects the REST endpoints
- Supports multiple agent profiles with isolated memory spaces

## Key Features
- Multi-sector memory inspired by human cognitive architecture
- Temporal awareness with decay and reinforcement over time
- Explainable recall showing retrieval reasoning chains
- Memory consolidation to prevent fragmentation and redundancy
- Agent-scoped memory isolation for multi-tenant deployments

## Comparison with Similar Tools
- **Mem0** — memory layer for LLMs; OpenMemory adds temporal reasoning and multi-sector architecture
- **Zep** — session-based memory; OpenMemory focuses on long-term cognitive persistence
- **LangChain Memory** — in-process memory modules; OpenMemory is a standalone service with its own API
- **ChromaDB / Qdrant** — vector databases for retrieval; OpenMemory adds cognitive memory semantics on top

## FAQ
**Q: How is this different from a vector database?**
A: Vector databases store and retrieve embeddings. OpenMemory adds memory sectors, temporal reasoning, importance scoring, and consolidation on top of vector storage.

**Q: Can I use it with any AI framework?**
A: Yes. The REST API works with LangChain, CrewAI, AutoGen, or any framework that can make HTTP calls.

**Q: Does it support multiple agents?**
A: Yes. Each agent can have its own memory space with isolated recall and storage.

**Q: What happens to old memories?**
A: Memories decay over time unless reinforced. The consolidation process merges related memories to keep the store efficient.

## Sources
- https://github.com/CaviraOSS/OpenMemory
- https://github.com/CaviraOSS/OpenMemory/blob/main/README.md

---
Source: https://tokrepo.com/en/workflows/asset-a633c1ac
Author: AI Open Source