Memorius
Universal memory vault for any AI agent.
Works with Claude Code, Codex CLI, Gemini CLI, OpenClaude, OpenCode, Pi, OpenClaw, and any MCP-compatible agent.
📚 Documentation: https://dream-pixels-forge.github.io/memorius/ — install, CLI reference, MCP server, hooks, REST API, architecture, and the memory engine, all on the site.
If you find this project useful, leaving a star ⭐ on the repository is the best way to support my work!
Memorius is a self-contained, agent-agnostic memory system with hierarchical knowledge organization, pluggable embeddings, and neuroscience-inspired consolidation. One vault, many frontends — CLI, MCP, REST, and auto-detecting agent hooks. No cloud, no API keys, no lock-in.
Install
pip install memorius
All features — vector search, cross-encoder reranker, REST API server, SQLite-vec backend, OpenAI embeddings, knowledge graph, and the agent skill — are included out of the box. No extra install flags needed.
Verify:
memorius --version
memorius init # creates ~/.memorius/config.yaml + storage dir
CLI Reference
memorius stats
Show vault + memory + graph statistics --json Output as JSON
memorius status
Show vault status --json Output as JSON
For development
pip install "memorius[dev]" # adds pytest + pytest-asyncio
Quick start
# Initialize a vault
memorius init
# Store a memory
memorius store "The sky is blue because Rayleigh scattering scatters shorter wavelengths more" \
--vault main --shelf science --folder physics
# Semantic search
memorius search "why is the sky blue"
# Mine memories from a conversation
memorius mine transcript.txt --vault conversations
# Check status
memorius status
That's the whole loop: store → embed → search. Read the Getting Started guide for the vault hierarchy, the agent skill, and a recommended first-week flow.
Documentation
The full docs live on the site — each concern on its own page:
| Page | What's on it |
|---|---|
| Getting Started | Install, init, first memory, the Vault→Shelf→Folder→Note hierarchy, agent skill |
| CLI Reference | Every subcommand and flag (incl. repair and --json) |
| MCP Server | All 29 tools + per-agent client config snippets |
| Agent Hooks | Auto-detecting lifecycle hooks, 10 actions, normalizers, security |
| REST API | Full endpoint table, auth, rate limits, daemon mode, TLS |
| Architecture | Search pipeline, embeddings, vector backends, graph, configuration |
| Agent Compatibility | Which agents, detection priority, how to plug in your own |
| Memory Engine | Decay, consolidation, pruning, fact-checking, reranking, doctor, repair |
Command cheat sheet (details on the CLI reference)
memorius store "text" [--vault/--shelf/--folder/--note/--ttl]
memorius search "query" [--n/--expand-graph/--rerank/--web/--tag]
memorius mine file.txt [--vault/--text]
memorius extract file.txt [--backend openai|ollama|regex]
memorius diary "session" [--title/--summary]
memorius ls [vault]
memorius consolidate [--threshold/--dry-run]
memorius factcheck "stmt" [--web]
memorius profile "session"
memorius prune [--threshold/--dry-run/--delete]
memorius graph [view|export-html|stats|json]
memorius learn "text" --category bug_fix
memorius recall "query"
memorius obsidian [list|import|export]
memorius export ./backup [--format json|markdown]
memorius import ./backup.json [--replace]
memorius doctor # 6 health checks
memorius repair [--reindex/--dry-run] # fix vector/meta drift (v0.8.6)
memorius stats [--json] # vault + memory + graph + doctor summary
memorius status [--json] # vault + embeddings + recent diaries
memorius serve # MCP server (stdio)
memorius serve-rest [--daemon/--stop] # FastAPI server
License
MIT · Full release history in CHANGELOG.md.
1 maintainer
Metadata
1 maintainer
Release files for memorius 0.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| memorius-0.9.0.tar.gz | 237.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| memorius-0.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 422.0 kB
Release files / memorius-0.9.0.tar.gz
| Download URL | memorius-0.9.0.tar.gz |
|---|---|
| Size | 237.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40fbd345fff12801244341179cee5b8e49d95cad9a4b12162fb9edd05e25f371
|
|
BLAKE2b-256 checksum How to use checksums |
974e6a85ea0012b04215abec2c24bd6e08493e1fa6e130397bd8a5968375c461
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / memorius-0.9.0-py3-none-any.whl
| Download URL | memorius-0.9.0-py3-none-any.whl |
|---|---|
| Size | 184.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6254a65685503b26dd9eb72aa1bacd4b4e9b5590e973a09ca80f0457393bd8c3
|
|
BLAKE2b-256 checksum How to use checksums |
383c81bcd3443cb8ff4293f4ed94df4c054c5ff10aaf4ec02620c2153b5a366c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency log
