This release is a pre-release and may not be stable for production use.
contextdb-cloud-client (Python)
Remote client for the ContextDB Cloud data plane. The hosted API and this package are alpha and do not carry a production availability commitment.
from contextdb_cloud_client import CloudClient
async with CloudClient("https://api.contextdb.ai", api_key="cdb_…") as cdb:
saved = await cdb.remember(
"caller-1", "Thursday works", source="user_stated",
confidence=0.9, idempotency_key="call-456-preference-v1",
)
context = await cdb.recall(
"caller-1",
"when can they come in?",
min_memory_version=saved.memory_version,
min_primary_wal_lsn=saved.primary_wal_lsn,
)
decision = await cdb.evaluate_action("caller-1", "book the visit")
if decision.outcome == "act":
# Execute in your host, then close the Action Ledger.
await cdb.report_execution(
"caller-1", decision.decision_id, "appointment.book", "succeeded",
idempotency_key=f"receipt-{decision.decision_id}",
external_ref="appt-8842",
)
pending = await cdb.pending_confirmations("caller-1")
LocalClient wraps the in-process memory calls for offline development.
Cloud-only control-plane features such as durable action decisions and
execution receipts require CloudClient.
The API key is a project-wide server credential (cdb_…). Keep it in your
server's secret store; never in a browser or client-side code.
Pass a stable idempotency_key when retrying remember, remember_many,
confirm, or extract_memories(..., mode="commit"). Reuse the key only for
the exact same logical request.
Delete one bad memory with forget(user_id, memory_id=...). Whole-partition
erasure is deliberately harder: pass erase_partition=True,
confirmation=user_id, and an idempotency_key; Cloud deletes the partition
and verifies that no memory rows or vector-index IDs remain.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file contextdb_cloud_client-0.1.0a1.tar.gz.
File metadata
- Download URL: contextdb_cloud_client-0.1.0a1.tar.gz
- Upload date:
- Size: 13.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ae6762a2b326c83a0f7c6772e7b5afbfbebcc648aff97b9da2ecefcbfd28691c
|
|
| MD5 |
4acfe26364a08f5914cd4a0a64cbe630
|
|
| BLAKE2b-256 |
ed098a672d2fc7bf788d4bf658bc18a85900831590b2d36aea54c7c9b04d7f0a
|
Provenance
The following attestation bundles were made for contextdb_cloud_client-0.1.0a1.tar.gz:
Publisher:
publish-python.yml on atomsai/contextdb-clients
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
contextdb_cloud_client-0.1.0a1.tar.gz -
Subject digest:
ae6762a2b326c83a0f7c6772e7b5afbfbebcc648aff97b9da2ecefcbfd28691c - Sigstore transparency entry: 2532443130
- Sigstore integration time:
-
Permalink:
atomsai/contextdb-clients@a4fc24fe34ac80eba19a2b107f1e69ffd9c73803 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/atomsai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-python.yml@a4fc24fe34ac80eba19a2b107f1e69ffd9c73803 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file contextdb_cloud_client-0.1.0a1-py3-none-any.whl.
File metadata
- Download URL: contextdb_cloud_client-0.1.0a1-py3-none-any.whl
- Upload date:
- Size: 14.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
efe9cbef1c9e410cd3275f69ecec2588daa0bd731dbd405c56c89206f6f7c479
|
|
| MD5 |
5b986094bc2a56862c192d892a2b2568
|
|
| BLAKE2b-256 |
4d6535e0c4aa116c9a5819e311e25dab402bbc3c5caafa890669286bfa8648d0
|
Provenance
The following attestation bundles were made for contextdb_cloud_client-0.1.0a1-py3-none-any.whl:
Publisher:
publish-python.yml on atomsai/contextdb-clients
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
contextdb_cloud_client-0.1.0a1-py3-none-any.whl -
Subject digest:
efe9cbef1c9e410cd3275f69ecec2588daa0bd731dbd405c56c89206f6f7c479 - Sigstore transparency entry: 2532443576
- Sigstore integration time:
-
Permalink:
atomsai/contextdb-clients@a4fc24fe34ac80eba19a2b107f1e69ffd9c73803 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/atomsai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-python.yml@a4fc24fe34ac80eba19a2b107f1e69ffd9c73803 -
Trigger Event:
workflow_dispatch
-
Statement type:
