This project has been archived by its maintainers, and is no longer receiving any updates.
langchain-perseus-vault
📦 Package rename history. This distribution replaced the archived
langchain-mimirproject. Installlangchain-perseus-vaultfor the current Perseus Vault integration.
Persistent, local-first, encrypted memory for LangChain, backed by Perseus Vault — an open-source (MIT) memory engine with FTS5 + dense hybrid search and optional AES-256-GCM encryption, exposed over the Model Context Protocol (MCP) stdio transport.
It gives a LangChain agent durable memory that survives across runs and processes, stored in a single local SQLite file you control — no external service, no cloud.
What you get
This package wraps Perseus Vault using the modern langchain-core interfaces:
create_perseus_vault_tools(client)— a pair ofStructuredTools (perseus_vault_remember/perseus_vault_recall) you give to an agent so it can manage its own long-term memory via tool calls. This is the current-recommended LangChain pattern (the legacyMemory/ConversationBufferMemoryclasses are deprecated).PerseusVaultRetriever— aBaseRetrieverreturningDocuments, for drop-in use in RAG chains and anywhere LangChain accepts a retriever (.invoke(query)).PerseusVaultClient— the low-level MCP stdio client, if you want direct access.
Prerequisite: the perseus-vault binary
This package talks to a local perseus-vault executable via JSON-RPC over
stdio. You must have it installed:
- Download a release from
https://github.com/Perseus-Computing-LLC/perseus-vault/releases, or build from source
(
cargo build --release), and putperseus-vaulton your$PATH. - Or pass an absolute path:
PerseusVaultClient(perseus_vault_binary="/path/to/perseus-vault").
On Windows the binary may be named perseus-vault.exe; ensure its directory is
on PATH, or pass the full path. perseus-vault is the canonical executable name.
Install
pip install langchain-perseus-vault
Usage
As agent tools
from langchain_perseus_vault import PerseusVaultClient, create_perseus_vault_tools
client = PerseusVaultClient(db_path="~/.langchain/perseus-vault.db")
tools = create_perseus_vault_tools(client) # [perseus_vault_remember, perseus_vault_recall]
# Bind to any tool-calling model / agent:
from langchain.chat_models import init_chat_model
llm = init_chat_model("anthropic:claude-sonnet-4-5")
llm_with_memory = llm.bind_tools(tools)
resp = llm_with_memory.invoke("Remember that my favorite language is Rust.")
# ... the model will call perseus_vault_remember; execute the tool call as usual.
As a retriever
from langchain_perseus_vault import PerseusVaultClient, PerseusVaultRetriever
client = PerseusVaultClient(db_path="~/.langchain/perseus-vault.db")
client.remember("The capital of France is Paris.")
retriever = PerseusVaultRetriever(client=client, k=5)
docs = retriever.invoke("What is the capital of France?")
print(docs[0].page_content) # -> "The capital of France is Paris."
Direct client
from langchain_perseus_vault import PerseusVaultClient
client = PerseusVaultClient(db_path="~/.langchain/perseus-vault.db")
client.remember("Project deadline is July 15.", tags=["project", "deadline"])
items = client.recall("when is the deadline")
print(items[0]["text"])
How it works
PerseusVaultClient spawns perseus-vault --db <path> as a subprocess and
speaks JSON-RPC 2.0 (MCP) over its stdin/stdout. A background reader thread and
a lock make calls thread-safe and timeout-bounded. Memories are stored via
perseus_vault_remember and retrieved via perseus_vault_recall.
License
MIT © 2026 Perseus Computing LLC
Metadata
Release files for langchain-perseus-vault 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| langchain_perseus_vault-0.1.1.tar.gz | 12.4 kB | With provenance | Details for langchain_perseus_vault-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| langchain_perseus_vault-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for langchain_perseus_vault-0.1.1-py3-none-any.whl |
Total release size: 23.5 kB
Release files / langchain_perseus_vault-0.1.1.tar.gz
| Download URL | langchain_perseus_vault-0.1.1.tar.gz |
|---|---|
| Size | 12.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4525dde0f08a6f6ca9a6a9cd0da9f98c92f17651cd86f123193a0438ac0913d2
|
|
BLAKE2b-256 checksum How to use checksums |
d2181f35834eb1e19e47c7587de90f1504c98466fca6818b16a4d5168c3f2d8b
|
| 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 Aug 1, 2026.
Transparency logRelease files / langchain_perseus_vault-0.1.1-py3-none-any.whl
| Download URL | langchain_perseus_vault-0.1.1-py3-none-any.whl |
|---|---|
| Size | 11.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
07489a9d21e1ce4fca8c907e7a8ff519f45248385fb3a114e79706b79ac45952
|
|
BLAKE2b-256 checksum How to use checksums |
b3eb3388bc20fa83267e2813a494b169afcd1de30940a2c06000b0ad872d948a
|
| 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 Aug 1, 2026.
Transparency logSecurity for langchain-perseus-vault 0.1.1
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for langchain_perseus_vault-0.1.1.tar.gz
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 Aug 1, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.