> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryumem.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ryumem

> Open-source bi-temporal knowledge graph memory for AI agents.

# Knowledge Graph Memory for AI Agents

Ryumem is an **open-source bi-temporal knowledge graph memory system** that gives your AI agents intelligent, long-term memory with automatic tool tracking and query augmentation.

<CardGroup cols={2}>
  <Card title="5-Minute Quickstart" icon="rocket" href="/quickstart">
    Build your first memory-enabled agent
  </Card>

  <Card title="Self-Hosted Setup" icon="server" href="/setup">
    Deploy Ryumem with Docker Compose
  </Card>

  <Card title="MCP Server" icon="plug" href="/integrations/mcp-server">
    Add memory to Claude Desktop and coding agents
  </Card>

  <Card title="Core Concepts" icon="brain" href="/core-concepts/episodes">
    Understand how Ryumem works
  </Card>
</CardGroup>

<Note>
  **Open Source**: Ryumem is open source under the AGPL-3.0 license. Self-host it on your own infrastructure or contribute on [GitHub](https://github.com/predictable-labs/ryumem).
</Note>

**Components:**

* **API Server** - FastAPI backend with REST API
* **Dashboard** - Next.js web UI for visualization
* **MCP Server** - Model Context Protocol server for AI agents
* **Python SDK** - Client library for Python applications

## Key Features

<CardGroup cols={3}>
  <Card title="Episode-Based Storage" icon="layer-group">
    Store conversations and facts as episodes that get automatically parsed into knowledge graphs
  </Card>

  <Card title="Smart Retrieval" icon="magnifying-glass">
    Semantic + keyword + graph traversal search with temporal decay scoring
  </Card>

  <Card title="Auto-Deduplication" icon="fingerprint">
    Embedding-based entity resolution prevents duplicate memories
  </Card>

  <Card title="Contradiction Handling" icon="code-compare">
    Automatically detects and resolves conflicting facts
  </Card>

  <Card title="Memory Pruning" icon="broom">
    Removes expired and obsolete information automatically
  </Card>

  <Card title="Web Dashboard" icon="chart-line">
    Modern Next.js UI with graph visualization and analytics
  </Card>
</CardGroup>

## Quick Links

<CardGroup cols={2}>
  <Card title="GitHub Repository" icon="github" href="https://github.com/predictable-labs/ryumem">
    Star the repo, report issues, contribute
  </Card>

  <Card title="Python SDK on PyPI" icon="python" href="https://pypi.org/project/ryumem/">
    Install with pip install ryumem
  </Card>
</CardGroup>
