ebbmem-client

Python client for the Ebb memory HTTP API. Version 0.2.0. Homepage: https://ebbmem.ai.

The import name is ebbmem_client. The in-process engine wheel already owns the ebbmem import.

This package is not yet published. When it is, install it from the package registry:

pip install ebbmem-client

Quickstart

from ebbmem_client import EbbmemClient

client = EbbmemClient()  # reads EBBMEM_ORIGIN and EBBMEM_TOKEN
stored = client.memory.remember("the harbor light is cobalt")
found = client.memory.recall("harbor light")

AsyncEbbmemClient is a native async client. It uses httpx for HTTP and the generated models for request and response bodies.

Auth

EBBMEM_ORIGIN is required. There is no default origin. EBBMEM_TOKEN is sent as Authorization: Bearer. EBBMEM_API_KEY is sent as X-API-Key. EBBMEM_NAMESPACE is sent as X-Ebb-Namespace. An explicit argument overrides the matching environment variable. The token is omitted from repr.

Methods

client.memory exposes remember, remember_batch, recall, recall_federated, get, list, update, forget, reinforce, reflect, why_not, and status. client.tasks exposes get, list, and cancel. client.events.stream reads the SSE event stream. client.health calls the health endpoint.

Errors and retries

Failures raise EbbmemError with status, code (EBB-… from the error envelope), message, details, and request_id. Subclasses are AuthError (401/403), NotFoundError (404), ValidationError (400/422), RateLimitError (429, retry_after), ServerError (5xx), and ConnectionError.

The client retries connection errors, 429 (honoring Retry-After), and 502/503/504. Retries apply to idempotent methods, and to remember / remember_batch when an idempotency key is set. max_retries defaults to 2. timeout defaults to 30 seconds. The user agent is ebbmem-client-python/0.2.0.

Pagination

memory.list() follows next_cursor until has_more is false and yields each row.

Events

client.events.stream() yields parsed SSE data objects. Pass token only when the stream must authenticate with the query parameter.

Raw API

client.raw is the generated client (memory, tasks, events, health).

License

Proprietary, (c) Spectrayan.