sigillum-sdk 1.0.0

Sigillum passive observability SDK (Python). Fire-and-forget; never blocks or alters the host application.

sigillum-sdk

Passive observability SDK for the Sigillum AI governance platform (Python, server-side).

SigillumClient.observe(...) enqueues an observation and returns immediately. A daemon worker delivers it to the Sigillum ingestion endpoint with a per-request timeout, bounded retry and a circuit breaker. A bounded drop-oldest queue guarantees that a slow or unreachable Sigillum can never grow memory or block the host application. Fire-and-forget by design: it never blocks, alters or delays the host application's flow.

Quick start

from sigillum_sdk import SigillumClient, SigillumOptions

sigillum = SigillumClient(SigillumOptions(
    ingest_url="https://api.sigillum.com.tr/ingest/v1/observation",
    tenant_id="<your-tenant-id>",
    api_key="<your-ingest-key>",
    default_ai_asset_slug="my-ai-asset",
))

sigillum.observe(
    operation="chat.answer",
    model={
        "provider": "openai",
        "model": "gpt-4o-mini",
        "inputTokens": input_tokens,
        "outputTokens": output_tokens,
    },
)

observe(...) accepts keyword arguments for each observation facet (transaction, pii, model, agentic, drift, review and more). Call close() on shutdown to drain the queue.