trufo 0.3.1

Trufo SDK for content provenance API services.

Trufo

Open-source library to simplify interactions with the Trufo Provenance Service (TPS).

The library is currently in an alpha release state. Please be advised that until the library enters a beta release state, there may be drift in the library schema.

The Trufo Provenance Platform is under active beta development, with new provenance features and product workflows being added regularly. If you are building against the platform and have questions about the right integration path, please contact [e-mail]. We are happy to help.

Optional Provenance Support

Install C2PA/provenance support with the provenance extra:

pip install "trufo[provenance]"

For trufo version 0.3.1, this resolves to the trufo-provenance 0.1.x implementation package. The relevant first fixed build is trufo-provenance==0.1.1. That build bundles the native C2PA bridge for Linux only; macOS and Windows wheels are not published yet.

Workflow Examples (Quickstart)

There are a number of documents to get you started quickly with specific use cases:

Use case	Trufo Product	Quickstart
Auth Setup	—	docs/quickstart/0_auth.md
C2PA Signing Certificate CSRs	C2PA Signing Certificates	docs/quickstart/1_c2pa_cert.md
AI Labeling	C2PA & CAWG Signing API	docs/quickstart/2_ai_labeling.md
Organization Stamping & Assertions	C2PA & CAWG Signing API	docs/quickstart/3_cawg_publish.md

Reference Documentation

The full reference documentation is spread across the following files:

Service	Document	Description
Auth	docs/api/api_auth.md	Headers, access tokens, sessions
TPS	docs/api/api_c2pa.md	C2PA signing endpoints
TCA	docs/api/tca_ca.md	Certificate Authority — enrollment, revocation, timestamping
TCA	docs/api/tca_ra.md	Registration Authority — instances, credentials, CSR JWTs
CLI	docs/cli.md	Credential management (dev tool; use the Python API in prod)