Python SDK

pip install anona

from anona import AnonaClient

client = AnonaClient(api_key="anona_live_YOUR_KEY")

client.record(space_id="customer-support-bot", content="Alice is a senior engineer at Google")

results = client.retrieve(space_id="customer-support-bot", query="Where does Alice work?")
print(results)

client = AnonaClient(
    api_key="anona_live_YOUR_KEY",
    base_url="https://api.anonalabs.com",  # optional, this is the default
)

import os

client = AnonaClient(api_key=os.environ["ANONA_API_KEY"])

with AnonaClient(api_key="anona_live_YOUR_KEY") as client:
    client.record(space_id="customer-support-bot", content="...")

memory = client.record(
    space_id="customer-support-bot",
    content="Alice works at Google and specializes in distributed systems",
    user_id="alice_123",
    tags=["work"],
    metadata={"source": "crm"},
)
print(memory["memory_id"])

results = client.retrieve(
    space_id="customer-support-bot",
    query="Where does Alice work?",
    limit=10,
    user_id="alice_123",   # only Alice's memories
)
for r in results:
    print(r["content"], r["relevance_score"])

res = client.retrieve_receipt(
    space_id="customer-support-bot",
    query="who is on call for billing?",
    receipt_detail="full",
)
for row in res.memories:
    print(row["content"])

receipt = client.get_receipt(res.receipt_id)
for cut in receipt["excluded"]:
    print(cut["reason"], cut["detail"])

verdict = client.explain(res.receipt_id, "mem_abc123")
verdict["outcome"]   # "included" | "excluded" | "not_retrieved"
verdict["stage"]     # "retrieval" | "fusion" | "rerank", when excluded
verdict["arms"]      # {"semantic": 812, "keyword": None, ...}

answer = client.reason(
    space_id="customer-support-bot",
    query="What have we learned about Alice's career?",
)
print(answer)

profile = client.get_user_profile("customer-support-bot", "alice_123")
print(profile["memory_count"], profile["last_active"])

# Prompt-ready instead of a list
block = client.get_user_profile(
    "customer-support-bot", "alice_123", format="block", context_max_tokens=500
)
print(block["context"])

answer = client.ask_about_user(
    "customer-support-bot", "alice_123", "How does she prefer to be contacted?"
)
print(answer["insights"], answer["model"])

spaces = client.list_spaces()
for s in spaces:
    print(s["space_id"], s["name"])

job = client.upload_file(
    space_id="customer-support-bot",
    file="handbook.pdf",
    tags=["hr", "policy"],
)
print(job["job_ids"])

docs = client.list_documents(space_id="customer-support-bot")
for d in docs:
    print(d["document_id"], d["memory_count"])

client.delete_document(space_id="customer-support-bot", document_id="file_9c2f1a")

import asyncio
from anona import AnonaClient

async def main():
    client = AnonaClient(api_key="anona_live_YOUR_KEY")

    await client.async_record(space_id="customer-support-bot", content="Alice works at Google")
    results = await client.async_retrieve(
        space_id="customer-support-bot", query="Where does Alice work?"
    )
    print(results)

    await client.aclose()

asyncio.run(main())

from anona import AnonaClient, AnonaError

client = AnonaClient(api_key="anona_live_YOUR_KEY")

try:
    results = client.retrieve(space_id="customer-support-bot", query="Where does Alice work?")
except AnonaError as e:
    print(e.status_code)  # int
    print(e.detail)       # parsed error body (dict), or raw text

from anona.integrations import MemoryBridge

bridge = MemoryBridge(
    api_key="anona_live_YOUR_KEY",
    space_id="customer-support-bot",
    user_id="customer-42",   # optional scope: this user's memories only
)