Skip to main content
Pre-release

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

acta-sdk

Python client for Acta — 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 acta-sdk
# optional extras:
pip install "acta-sdk[sign]"       # faster Ed25519 via `cryptography`
pip install "acta-sdk[langchain]"  # LangChain retriever adapter

Quickstart

from acta_sdk import ActaClient

o = ActaClient("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 = ActaClient("https://acta.example.com", api_key="acta_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 = ActaClient(url, api_key="acta_sk_…", signing_key=my_seed)
o.set_authorship_key(o.authorship_public_hex)

LangChain

from acta_sdk.langchain import acta_retriever
retriever = acta_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 acta-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 acta-sdk 1.0.0rc1
File Size Uploaded Provenance Actions
acta_sdk-1.0.0rc1.tar.gz 9.4 kB Without provenance Details for acta_sdk-1.0.0rc1.tar.gz

Built distribution (wheel)

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

Total release size: 19.5 kB

Release files / acta_sdk-1.0.0rc1.tar.gz

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

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

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

Security for acta-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