SDKs

Python SDK

Installation

pip install databaset

Requirements

  • Python 3.10+
  • DATABASET_API_KEY environment variable

Initialize

from databaset import Memory

memory = Memory()  # or Memory(api_key="db_...", app_id="my-app")

Store, recall, forget, list

# Store
memory.store(user_id="user_123", text="User likes dark mode")

# Recall (returns context string)
context = memory.recall(user_id="user_123", query="preferences")

# Recall raw matches
matches = memory.recall_raw(user_id="user_123", query="preferences")

# Forget one memory by short id
memory.forget("mem_abc12345")

# Forget all memories for a user
memory.forget_user(user_id="user_123", app_id="my-app")

# Bulk forget
memory.forget_bulk(["mem_abc12345", "mem_def67890"])

# List
result = memory.list(user_id="user_123", page=0, page_size=20)

Error handling

from databaset import DatabasetError, ValidationError, ApiError

try:
    memory.store(user_id="user_123", text="...")
except ValidationError as e:
    print("Invalid input:", e)
except ApiError as e:
    print(f"API error {e.status}: {e}")
except DatabasetError as e:
    print("Error:", e)