The Python SDK is a small client over the Loom API. You configure it once with the base URL and your API key, then call methods instead of crafting HTTP requests.
pip install loom-sdk
from loom_sdk import Loom

mem = Loom(
    org_id="lab",
    user_id="alice",
    base_url="https://api.loom.getmetacognition.com",
    api_key="lk_live_...",
)

Constructing the client

Loom(
    *,
    org_id: str,
    user_id: str = "",
    base_url: str,
    api_key: str = "",
    http_client: Any = None,
)
org_id
str
required
The workspace this client operates in.
user_id
str
default:"\"\""
User within the workspace. Required for per-user memory; optional otherwise.
base_url
str
required
The Loom API base URL — https://api.loom.getmetacognition.com.
api_key
str
Your API key (or a session token), sent as a bearer credential.
http_client
Any
default:"None"
An optional custom httpx.Client-like object — useful for shared connection pools, retries, or testing.
Keep your key out of source — read it from an environment variable: api_key=os.environ["LOOM_API_KEY"].

Sub-API namespaces

Beyond the top-level methods, the client groups capabilities into namespaces:
NamespaceCovers
mem.userPer-user memory
mem.graphGraph & sessions
mem.insightsCross-session insights & directions
mem.accountAccount & billing
mem.workspacesWorkspaces
mem.browsePaginated sessions & claims
mem.authSignup / login
mem.adminFounder admin

A first call

mem.ingest_paper("10.1/astro", title="Astrocyte Ca2+",
                 text="astrocyte calcium " * 30, oa=True)

spans = mem.recall("calcium signalling", budget_tokens=8000)
assert spans[0]["provenance"]["paper_doi"] == "10.1/astro"

Start with memory

Recall, papers, analyses, and claims.