agenticmemoryai

Official Python SDK for Agentic Memory. Give your AI agents persistent memory in one line.

Install

pip install agenticmemory-sdk

Quick Start

from agenticmemoryai import AgenticMemory

memory = AgenticMemory(api_key="amk_your_key")

# Store a message
memory.store("your-space-id", role="user", content="Hello!")

# Recall recent messages
messages = memory.recall("your-space-id", limit=20)

# Search by meaning (Pro plan)
results = memory.search("your-space-id", "pricing discussion")

Features

• Short-term memory — instant recall, sub-millisecond reads
• Medium-term memory — search past conversations by meaning
• Long-term memory — auto-summarised knowledge across months
• End-to-end encryption — zero-knowledge spaces where only you hold the key

End-to-end encryption (zero-knowledge)

Create a space the server can never read. Encryption and decryption happen inside the SDK — the API only ever sees ciphertext.

pip install "agenticmemory-sdk[e2e]"   # pulls in the cryptography package

from agenticmemoryai import AgenticMemory, SearchUnavailableError, generate_key

# Generate a key once and store it somewhere safe (it is NOT recoverable).
encryption_key = generate_key()

memory = AgenticMemory(api_key="amk_your_key", encryption_key=encryption_key)
space = memory.create_space("Private", "private", {"encryption": "e2e"})

# Everything below is encrypted before it leaves your process:
memory.store(space_id, role="user", content="my secret")
messages = memory.recall(space_id)          # transparently decrypted

memory.verify_key(space_id)                 # True / False — right key for this space?

# Or derive the key from a passphrase instead of storing one:
memory2 = AgenticMemory(api_key="amk_your_key", passphrase="long secret phrase")

Notes:

• Semantic search is impossible on zero-knowledge spaces by design — search() raises SearchUnavailableError.
• Prefer encrypted at rest instead? Create the space with {"encryption": "managed"} — the server encrypts your data at rest and every feature (search, summaries) keeps working. No SDK key needed.
• Losing the key or passphrase means the data is unrecoverable. That's the point.

API

• store(space_id, role, content) — append a message
• recall(space_id, limit) — get recent messages
• search(space_id, query, scope, tags) — semantic search
• set_context(space_id, key, value) — set key-value context
• get_context(space_id, key) — get context value
• add_entry(space_id, type, title, content, tags) — append entry
• bootstrap(space_id, ...) — load full context in one call
• set_shared(space_id, key, value) — shared world memory
• create_space(name, slug) — create a memory space

Get an API key

Sign up free at agenticmemory.ai. 1,000 messages/month on the free tier.

Links

• Quick Start Guide
• API Docs
• Pricing

Acknowledgements

The structured memory architecture was influenced by work from the h-network community by Halil Baysal.

License

Proprietary — Tyga.Cloud Ltd. See LICENSE file.