oracle-sdk 1.0.0rc1

Python client for the Oracle verifiable-memory REST API

oracle-sdk

Python client for Oracle — verifiable, structured, portable agent memory built on a signed, per-tenant ledger. Stdlib-only (no required runtime dependencies); optional Ed25519 signing and a LangChain retriever.

Install

pip install oracle-sdk
# optional extras:
pip install "oracle-sdk[sign]"       # faster Ed25519 via `cryptography`
pip install "oracle-sdk[langchain]"  # LangChain retriever adapter

Quickstart

from oracle_sdk import OracleClient

o = OracleClient("http://127.0.0.1:8088", tenant="t1")
o.write_intent(owner="u1", goal="keep acme renewal on track",
               scope=["business"], priority=95)

bundle = o.read_context(task="draft acme renewal email", scope=["business"])
# bundle carries a state_root + aea_id — proof of exactly what context was used

With authentication enabled on the server, pass the account API key (the tenant is then taken from the key):

o = OracleClient("https://oracle.example.com", api_key="oracle_sk_…")

Signed writes (client-held trust root)

Construct with a signing key so each write is Ed25519-signed by your key, and bind it to your account so the server enforces it:

o = OracleClient(url, api_key="oracle_sk_…", signing_key=my_seed)
o.set_authorship_key(o.authorship_public_hex)

LangChain

from oracle_sdk.langchain import oracle_retriever
retriever = oracle_retriever(o, scope=["business"])
docs = retriever.invoke("draft the acme renewal email")
# each Document carries the bundle's aea_id + state_root, so retrieval stays auditable

License

MIT OR Apache-2.0