mentedb-langchain
MenteDB integration for LangChain and LangGraph. Gives your agents persistent, cognitive memory that goes beyond simple vector retrieval.
Installation
pip install mentedb-langchain
Components
MenteDBMemory
A LangChain compatible memory backend that stores conversation context in MenteDB. Unlike buffer or summary memory, MenteDBMemory uses hybrid search (vector similarity, tag filtering, temporal decay) to assemble the most relevant context for each turn.
from mentedb_langchain import MenteDBMemory
from langchain.chains import ConversationChain
from langchain_openai import ChatOpenAI
memory = MenteDBMemory(
data_dir="./agent-memory",
agent_id="my-agent",
token_budget=4096,
)
chain = ConversationChain(
llm=ChatOpenAI(),
memory=memory,
)
chain.predict(input="What database should I use for time series data?")
chain.predict(input="Tell me more about that recommendation")
MenteDBRetriever
A LangChain compatible retriever that uses MenteDB hybrid search. Supports optional tag filtering and agent scoping to narrow results.
from mentedb_langchain import MenteDBRetriever
from langchain.chains import RetrievalQA
from langchain_openai import ChatOpenAI
retriever = MenteDBRetriever(
data_dir="./agent-memory",
k=10,
tags=["backend", "architecture"],
)
chain = RetrievalQA.from_chain_type(
llm=ChatOpenAI(),
retriever=retriever,
)
chain.invoke("What were the key decisions about our database migration?")
MenteDBChatHistory
Persistent chat history with cognitive tracking. MenteDB stores messages alongside reasoning trajectories, knowledge gaps, and contradiction signals so the agent's memory improves over time.
from mentedb_langchain import MenteDBChatHistory
history = MenteDBChatHistory(
session_id="session-123",
data_dir="./agent-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
MenteDB works naturally with LangGraph. Use MenteDBMemory as a checkpointer or context source within graph nodes:
from mentedb_langchain import MenteDBMemory
memory = MenteDBMemory(data_dir="./graph-memory", agent_id="planner")
def plan_node(state):
context = memory.load_memory_variables({"input": state["task"]})
# Use context to inform planning
return {**state, "context": context}
def reflect_node(state):
memory.save_context(
inputs={"input": state["task"]},
outputs={"output": state["result"]},
)
return state
Configuration
All components accept data_dir to specify where MenteDB stores its data. For multi agent setups, use agent_id to isolate each agent's memory space.
| Parameter | Default | Description |
|---|---|---|
data_dir |
./mentedb-data |
Path to the MenteDB data directory |
agent_id |
None |
Optional agent identifier for memory isolation |
token_budget |
4096 |
Maximum tokens for assembled context (MenteDBMemory) |
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.38.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.38.0.tar.gz | 3.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mentedb_langchain-0.38.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.1 kB
Release files / mentedb_langchain-0.38.0.tar.gz
| Download URL | mentedb_langchain-0.38.0.tar.gz |
|---|---|
| Size | 3.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
12e482c869ab0a5d1c37b3ea995792203c19967e4f76c24996da66ecfcdb3dd2
|
|
BLAKE2b-256 checksum How to use checksums |
c3733e50ea450767be3dd9be3fcbda7a5448de9802582545e9b73b1c4ff87bf6
|
| 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 / mentedb_langchain-0.38.0-py3-none-any.whl
| Download URL | mentedb_langchain-0.38.0-py3-none-any.whl |
|---|---|
| Size | 5.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cef63df70de3c7b003a7767ef9c0976b705b15e65710eab58b9eadd48b5d490e
|
|
BLAKE2b-256 checksum How to use checksums |
d11d3d676bbd0cd394257bcc803db49ada1868332dfbd774849bef37a1f7d5eb
|
| 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
