Skip to main content

memnos-sdk

Lightweight Python client for memnos — governed, vendor-neutral backend memory for AI agents. Use it directly, or as a LangChain retriever, a LangGraph long-term-memory store, or a LlamaIndex retriever.

httpx-only (no server deps). Talks to a running memnos server over REST.

Add it to your project with uv (or plain pip — it's an importable library, not a CLI app):

uv pip install memnos-sdk                  # core client   (or: pip install memnos-sdk)
uv pip install 'memnos-sdk[langchain]'     # + LangChain retriever
uv pip install 'memnos-sdk[langgraph]'     # + LangGraph BaseStore
uv pip install 'memnos-sdk[llamaindex]'    # + LlamaIndex retriever
uv pip install 'memnos-sdk[all]'           # everything

Core client (sync + async)

from memnos_sdk import MemnosClient

with MemnosClient(base_url="http://127.0.0.1:8900", token="mnk_...", namespace="org:acme") as mem:
    mem.remember("We chose PostgreSQL + pgvector for the memory store")
    ctx = mem.context("what database did we choose?")   # ready-to-inject; no LLM at query time
    rows = mem.recall("database decision")["memories"]   # ranked memories w/ scores + dates
from memnos_sdk import AsyncMemnosClient

async with AsyncMemnosClient(token="mnk_...", namespace="org:acme") as mem:
    await mem.remember("...")
    print(await mem.context("..."))

A token + namespace come from your memnos admin (memnos token <principal>, memnos grant <principal> <namespace>). Every call is namespace-scoped and audited server-side.

LangChain

from memnos_sdk import MemnosClient
from memnos_sdk.integrations.langchain import MemnosRetriever

retriever = MemnosRetriever(client=MemnosClient(token="mnk_...", namespace="org:acme"))
docs = retriever.invoke("auth token expiry policy")     # drop into any RAG chain
retriever.save("JWT tokens expire after 15 minutes in prod")

LangGraph (long-term memory)

from memnos_sdk import MemnosClient
from memnos_sdk.integrations.langgraph import MemnosStore

store = MemnosStore(MemnosClient(token="mnk_..."))
graph = builder.compile(store=store)
# in a node:  store.search(("org","acme"), query="...")  ·  store.put(("org","acme"), key, {"text": "..."})

memnos is semantic memory: put→remember, search→hybrid+reranked recall. Exact-key get is best-effort (use search).

LlamaIndex

from memnos_sdk import MemnosClient
from memnos_sdk.integrations.llamaindex import MemnosRetriever

retriever = MemnosRetriever(client=MemnosClient(token="mnk_...", namespace="org:acme"))
nodes = retriever.retrieve("auth token expiry policy")   # NodeWithScore[]; drop into a query engine
retriever.save("JWT tokens expire after 15 minutes in prod")

API surface

remember(text) · recall(query) -> {memories, context} · context(query) -> str · consolidate() · feedback(query, helpful) · healthy(). Async mirror on AsyncMemnosClient.

Apache-2.0.

Metadata

Release files for memnos-sdk 0.1.50

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for memnos-sdk 0.1.50
File Size Uploaded Provenance Actions
memnos_sdk-0.1.50.tar.gz 20.5 kB With provenance Details for memnos_sdk-0.1.50.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for memnos-sdk 0.1.50
File Interpreter ABI Platform Actions
memnos_sdk-0.1.50-py3-none-any.whl Python 3 none any Details for memnos_sdk-0.1.50-py3-none-any.whl

Total release size: 36.5 kB

Release files / memnos_sdk-0.1.50.tar.gz

Download URL memnos_sdk-0.1.50.tar.gz
Size 20.5 kB
Tags Source
SHA-256 checksum
How to use checksums
0f1e7616e86b8a918a7609dca1f070fec36f537fba7c39cb5aee173493f56c3e
BLAKE2b-256 checksum
How to use checksums
ccc4e0d047060212922745aa3335bd60479b998d01f7f6dd63ea898300846b63
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 15, 2026.

Transparency log

Release files / memnos_sdk-0.1.50-py3-none-any.whl

Download URL memnos_sdk-0.1.50-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
771a9bde45d6ad8398392d3fb2bb4b2e5bc089c5e59bd54f593ecc4c86107f24
BLAKE2b-256 checksum
How to use checksums
b650a9b6f6d9625c21fdfd018fd3aa07b4e17ae936fa6ab5ceda6fb4aa7b3c78
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 15, 2026.

Transparency log

Security for memnos-sdk 0.1.50

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.

Select from 2 files

Attestation for memnos_sdk-0.1.50.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 Nov 15, 2026.

Transparency log

A 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.

Release history Release notifications | RSS feed

This release

0.1.50 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page