Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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

Metadata

Release files for oracle-sdk 1.0.0rc1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oracle-sdk 1.0.0rc1
File Size Uploaded Provenance Actions
oracle_sdk-1.0.0rc1.tar.gz 9.4 kB Without provenance Details for oracle_sdk-1.0.0rc1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for oracle-sdk 1.0.0rc1
File Interpreter ABI Platform Actions
oracle_sdk-1.0.0rc1-py3-none-any.whl Python 3 none any Details for oracle_sdk-1.0.0rc1-py3-none-any.whl

Total release size: 19.5 kB

Release files / oracle_sdk-1.0.0rc1.tar.gz

Download URL oracle_sdk-1.0.0rc1.tar.gz
Size 9.4 kB
Tags Source
SHA-256 checksum
How to use checksums
2ff5e35cfe08225d8a630e89f543683650a92bee9afcffaf016482713c37f4f3
BLAKE2b-256 checksum
How to use checksums
a3221990f3de991b2469d341ee48b662b34268882211659435576a6ded2870eb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release files / oracle_sdk-1.0.0rc1-py3-none-any.whl

Download URL oracle_sdk-1.0.0rc1-py3-none-any.whl
Size 10.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e7fb3f53a5d1d023192881cc1972f93875bab3b5c7b25c309eb1b3bb45c8790f
BLAKE2b-256 checksum
How to use checksums
6dd774713b9af60abfbb7929d08017294763ae2c62f17808fe53b8b954f115ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Security for oracle-sdk 1.0.0rc1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page