Skip to main content

artemis-provenance-sdk

Thin Python client for the Artemis Provenance data plane — mark and verify AI-generated media (image · video · audio) for EU AI Act Article 50(2) compliance. The SDK contains no marking logic; it serializes calls to the data-plane container the customer runs in their own network, so content never leaves the VPC.

pip install artemis-provenance-sdk

Usage

from artemis_provenance_sdk import Client, MarkingUnavailableError

pv = Client(endpoint="http://provenance-dp.internal:8080", api_key="...")

# Mark an asset at the end of your generation pipeline.
try:
    marked = pv.mark_image(image_bytes, app_id="avatar-studio",
                           context={"title": "Generated avatar"})
    # marked.bytes  -> the marked output to ship
    # marked.event_id, marked.payload_id, marked.sha256, marked.marks
except MarkingUnavailableError:
    # Decide fail-open (ship unmarked — a compliance gap) vs fail-closed.
    ...

# Verify locally — content never leaves your network; only the id is resolved.
result = pv.verify(image_bytes, content_type="image")
# result["result"] == "matched" | "no-match", result["event"], result["checks"], result["local"]

There is also a file convenience wrapper:

marked = pv.mark_image_file("out/hero.png", app_id="avatar-studio")

Fail modes

MarkingUnavailableError is catchable so your pipeline chooses fail-open vs fail-closed consciously — document the compliance implications of each.

Typing

The package ships a py.typed marker; Client, MarkedAsset and VerifyResult are fully typed for editor/mypy support.

Releasing (maintainers)

See SETUP.md for the one-time PyPI Trusted Publishing setup and the per-release flow.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

artemis_provenance_sdk-0.1.0.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

artemis_provenance_sdk-0.1.0-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file artemis_provenance_sdk-0.1.0.tar.gz.

File metadata

  • Download URL: artemis_provenance_sdk-0.1.0.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for artemis_provenance_sdk-0.1.0.tar.gz
Algorithm Hash digest
SHA256 280d0f2908699203f41cedcffe57e352bd0f6c289a7cd4125b93e39ae9aa0abb
MD5 0b73b5df69a6ac1cf7161f1f7a44fdba
BLAKE2b-256 354fe6638f172e836e113b35b09aef7fedb403f53487c729c35e4e85c45ee6ff

See more details on using hashes here.

Provenance

The following attestation bundles were made for artemis_provenance_sdk-0.1.0.tar.gz:

Publisher: publish.yml on Star-48/artemis-provenance-sdk-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artemis_provenance_sdk-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for artemis_provenance_sdk-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 46c85806f992f0add206b39b1fca2f61cb21597b57b8d4e70174097926cab9bb
MD5 6af9790532f7f1775e3136688f556869
BLAKE2b-256 6c947edd0c81c8f147b3d34337ddce179ed71573edfea0ba224e4bcf8e2cccc1

See more details on using hashes here.

Provenance

The following attestation bundles were made for artemis_provenance_sdk-0.1.0-py3-none-any.whl:

Publisher: publish.yml on Star-48/artemis-provenance-sdk-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page