mentedb-langchain
MenteDB helpers for LangChain and LangGraph: a conversation memory, a retriever, and a chat history, each backed by a local MenteDB database.
Installation
pip install mentedb-langchain
Status
MenteDBMemory, MenteDBRetriever and MenteDBChatHistory follow the method
names of LangChain's memory, retriever and chat history interfaces, but they do
not subclass LangChain's base classes. LangChain rejects them when they are
passed directly to chains such as ConversationChain(memory=...) or
RetrievalQA.from_chain_type(retriever=...) (checked with LangChain 0.3).
Call their methods from your own code or graph nodes, as shown below.
Only one MenteDB instance can open a data directory at a time. Give each
component its own data_dir, or share one object. agent_id, when set, must
be a UUID string.
Components
MenteDBMemory
Stores each turn as an episodic memory and loads the most similar stored memories (top 10 by similarity search) for the next input.
from mentedb_langchain import MenteDBMemory
memory = MenteDBMemory(data_dir="./agent-memory")
memory.save_context(
inputs={"input": "What database should I use for time series data?"},
outputs={"output": "TimescaleDB is a good fit."},
)
context = memory.load_memory_variables({"input": "Tell me more about that database"})
# -> {"history": "User: ...\nAssistant: ..."}
MenteDBRetriever
Similarity search with an optional tag filter (all listed tags must match). Results are dicts shaped like LangChain documents.
from mentedb_langchain import MenteDBRetriever
retriever = MenteDBRetriever(data_dir="./docs-memory", k=10, tags=["backend"])
docs = retriever.get_relevant_documents("database migration decisions")
# -> [{"page_content": ..., "metadata": {"id", "score", "memory_type", "tags"}}]
MenteDBChatHistory
Stores every message in MenteDB as an episodic memory tagged with the session
id. messages returns the messages added through this object as
{"role", "content"} dicts; it does not reload earlier sessions from disk.
from mentedb_langchain import MenteDBChatHistory
history = MenteDBChatHistory(session_id="session-123", data_dir="./chat-memory")
history.add_user_message("What database should I use?")
history.add_ai_message("I recommend PostgreSQL for your use case.")
messages = history.messages
Usage with LangGraph
Use MenteDBMemory as a context source inside graph nodes:
from mentedb_langchain import MenteDBMemory
memory = MenteDBMemory(data_dir="./graph-memory")
def plan_node(state):
context = memory.load_memory_variables({"input": state["task"]})
return {**state, "context": context}
def reflect_node(state):
memory.save_context(
inputs={"input": state["task"]},
outputs={"output": state["result"]},
)
return state
Configuration
| Parameter | Default | Description |
|---|---|---|
data_dir |
./mentedb-data |
Path to the MenteDB data directory |
agent_id |
None |
Optional agent UUID stored as the memory owner (not used to filter searches) |
token_budget |
4096 |
Accepted by MenteDBMemory but currently not applied |
k |
10 |
Number of results to return (MenteDBRetriever) |
tags |
None |
Tag filter for retrieval (MenteDBRetriever) |
License
Apache 2.0
1 maintainer
Metadata
1 maintainer
Release files for mentedb-langchain 0.42.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 | |
|---|---|---|---|
| mentedb_langchain-0.42.0.tar.gz | 3.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mentedb_langchain-0.42.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.3 kB
Release files / mentedb_langchain-0.42.0.tar.gz
| Download URL | mentedb_langchain-0.42.0.tar.gz |
|---|---|
| Size | 3.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e12f0ace0e100620f929542020b783e4832faf49c05fdb17e98d64417121c898
|
|
BLAKE2b-256 checksum How to use checksums |
f4daa4ea9a999f03dc7c9936871019e4eb5fee4b1fe48addcb868eee13c5c535
|
| 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 19, 2026.
Transparency logRelease files / mentedb_langchain-0.42.0-py3-none-any.whl
| Download URL | mentedb_langchain-0.42.0-py3-none-any.whl |
|---|---|
| Size | 5.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a5d35188ceb0c8629793a20c3cc8bf07d3a8128f10d167599a501b5ac9243300
|
|
BLAKE2b-256 checksum How to use checksums |
b20e77fb28676dde08f959312a6ae19288adff2882214a1c5e9f1846cdcaed21
|
| 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 19, 2026.
Transparency log
