Metadata-Version: 2.5
Name: remember
Version: 0.2.0
Summary: Control-plane client for the remember.dev managed memory service.
Project-URL: Homepage, https://remember.dev
Project-URL: Documentation, https://remember.dev/docs
Project-URL: Source, https://github.com/writeitai/ultimate-memory-cloud
Author-email: "WriteIt.ai s.r.o." <info@writeit.ai>
License: Apache-2.0
Keywords: agents,memory,remember.dev,rememberstack
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27
Requires-Dist: rememberstack>=0.8.1
Description-Content-Type: text/markdown

# remember

Control-plane client for the [remember.dev](https://remember.dev) managed memory service.

`rememberstack` answers *memory* questions — ingest a document, search claims, run an assured
operation. This package answers the questions an operator of that memory also has:

- is my deployment ready?
- what is my balance, and what did that ingest cost?
- has spend safety parked my work?

```python
from remember import CloudClient

with CloudClient.from_env() as cloud:
    if cloud.is_ready():
        print(cloud.billing_status().balance)
```

```console
$ 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
```

## Install

```console
pip install remember
```

This installs `rememberstack` too. The `remember` **command** comes from that package and is
unaffected by this one; this distribution adds only `remember-status`.

## Credentials

This client authenticates with a **control-plane token** (`umc_cp_…`) — the D53 credential kind.
It is not the same thing as a deployment API token (`umc_dp_…`): that one authenticates *memory*
calls at the deployment's ingress and will be rejected here.

Mint one with `POST /v1/orgs/<org>/control-tokens` while signed in to the app. There is no button
for this yet — the API landed before the interface did — so today it is a call, not a click:

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

The secret is shown once. The credential is organisation-scoped, **read-only**, expires (90 days by
default), and can be surrendered by its holder at any time.

## What it will not do

No memory verbs, no second ingest or search contract. To *use* the memory, use `rememberstack`
pointed at your deployment; this package tells you what that memory costs and whether it is ready.
