remember

Official Python SDK for the remember.dev managed memory service.

This distribution provides:

• remember.Client (D65): The primary ergonomic client for memory operations. Connects directly to your dedicated tenant deployment ingress with a single deployment API token (umc_dp_…).
• remember.CloudClient (D53): The control-plane client for checking deployment readiness, credit balances, and spend gates using a control-plane token (umc_cp_…).
• remember-status: CLI tool for quick control-plane status checks.

Install

pip install remember

This automatically installs rememberstack (which provides the remember CLI tool on PATH).

Quickstart: Memory Operations (Client)

Mint an API Token (umc_dp_…) from your dashboard at Settings → API Tokens, then initialize Client:

import remember

# Client accepts a bare secret (umc_dp_...) or a full Bearer string,
# and converts string file paths automatically:
with remember.Client(
    api_key="umc_dp_…",
    base_url="https://<deployment-id>.dp.remember.dev",
) as memory:
    landed = memory.ingest("notes/project.md")
    print("Ingested version:", landed.version_id)

    # Search claims or chunks
    claims = memory.search_claims(query="architecture decisions")

Environment Variables

For zero-config agent setups, set REMEMBER_API_KEY and REMEMBER_API_URL:

export REMEMBER_API_URL="https://<deployment-id>.dp.remember.dev"
export REMEMBER_API_KEY="umc_dp_…"

import remember

with remember.Client.from_env() as memory:
    landed = memory.ingest("notes/project.md")

Client also automatically falls back to REMEMBERSTACK_API_AUTHORIZATION and REMEMBERSTACK_API_URL for seamless compatibility.

Quickstart: Status & Balances (CloudClient)

To check billing balance and deployment readiness in CI or monitoring bots, use CloudClient with an organisation-scoped control-plane token (umc_cp_…).

Control tokens are read-only, expiring status credentials (D53/D65). Because they are an API-only operational surface, mint one via the control-plane endpoint while authenticated with an owner session:

• Endpoint: POST /app/api/v1/orgs/{org_id}/control-tokens (or POST /v1/orgs/{org_id}/control-tokens against the direct control-plane URL).
• Body: {"label": "ci-monitor", "expires_in_days": 90} (accepts label and optional expires_in_days up to 90).

export REMEMBER_CLOUD_TOKEN='umc_cp_…'
export REMEMBER_CLOUD_ORG='your-organisation-id'

from remember import CloudClient

with CloudClient.from_env() as cloud:
    if cloud.is_ready():
        print("Balance:", cloud.billing_status().balance)

You can also run the status CLI:

$ remember-status
deployment  active     bb81063d-6b7b-41d0-a1df-dc57d4f1fe87
endpoint    live       bb81063d-6b7b-41d0-a1df-dc57d4f1fe87.dp.remember.dev
billing     active     balance 42.10
spend       allow