Metadata-Version: 2.4
Name: sigillum-sdk
Version: 1.0.0
Summary: Sigillum passive observability SDK (Python). Fire-and-forget; never blocks or alters the host application.
Author: sigillum
Project-URL: Homepage, https://sigillum.com.tr
Keywords: sigillum,observability,ai-governance,telemetry,audit
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 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

```python
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.
