llamaindex-openttt

TTTPS Proof-of-Time callback handler for LlamaIndex. Attaches a cryptographic audit-trail timestamp (a signed Proof-of-Time receipt) to ChatResponse.additional_kwargs / CompletionResponse.additional_kwargs on every LLM event, sealed against the public self-serve KPP Provenance API.

This attaches a cryptographic audit-trail timestamp and integrity hash. It does not certify legal or regulatory compliance (EU AI Act, FDA, and so on). Treat it as an audit-trail timestamp, not a compliance claim.

Install

pip install llamaindex-openttt

Usage

from llama_index.core.callbacks import CallbackManager
from llamaindex_openttt import TTTPSTimestampCallbackHandlerKPPLive

Settings.callback_manager = CallbackManager([TTTPSTimestampCallbackHandlerKPPLive()])

resp = llm.complete("hi")
print(resp.additional_kwargs["tttps_receipt"])
# {"status": "ok", "receipt_id": "...", "receipt": "...", "time": "...", ...}

Set KPP_API_KEY (mint one for free via POST https://kpp.kenosian.com/v1/keys) and optionally KPP_BASE / KPP_TIMEOUT_S as environment variables.

Fail-open: any network/upstream error degrades the receipt to {"status": "degraded", ...}. It never raises out of on_event_end, and the generated text itself is never touched.

License

MIT