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

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.61
File Size Uploaded Provenance Actions
memnos_sdk-0.1.61.tar.gz 20.5 kB With provenance Details for memnos_sdk-0.1.61.tar.gz

Built distribution (wheel)

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

Total release size: 36.5 kB

Release files / memnos_sdk-0.1.61.tar.gz

Download URL memnos_sdk-0.1.61.tar.gz
Size 20.5 kB
Tags Source
SHA-256 checksum
How to use checksums
cf3fe9a200a75ed0bd8d1b2b4bb9d1f3e66c488638c9d45fea8f6578354db830
BLAKE2b-256 checksum
How to use checksums
1f379acbe4619ac4e768fee6a228e7d023b7bad35b68b518b82b9bc1fec55c78
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.61-py3-none-any.whl

Download URL memnos_sdk-0.1.61-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cb99bfa06cce126e95089da1fb33296c673560869e6d38d6fee80c66a12e9146
BLAKE2b-256 checksum
How to use checksums
17c1ebadf89ef38a072c3c49735d5678754ec6f647d927fb49f98bc9282b1cc1
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.61

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