# CraniMem

CraniMem is a robust memory system for LLM agents. It combines episodic memory with a knowledge graph, and applies gating, pruning, and prioritized replay to keep context relevant across long conversations.

## Install

```bash
pip install cranimem
```

## Quickstart

```python
from cranimem.agent.workflow import build_agent

agent = build_agent()

# Use your agent with your preferred LLM provider configured via environment variables.
```

## Configuration

CraniMem uses environment variables for provider and Neo4j settings. See `example.env` for all available options.

## Architecture (High Level)

- Collection phase with gating and utility tagging
- Consolidation phase with pruning and prioritized replay
- Dual memory store: episodic buffer + knowledge graph

