senzu-sdk 0.5.2

Python SDK for the Senzu AI observability platform

senzu-sdk

Python SDK for the Senzu AI observability platform.

Installation

pip install senzu-sdk                    # core
pip install "senzu-sdk[anthropic]"       # + Anthropic auto-tracking
pip install "senzu-sdk[openai]"          # + OpenAI auto-tracking
pip install "senzu-sdk[langchain]"       # + LangChain callback handler
pip install "senzu-sdk[all]"             # everything

Quick start

import senzu

client = senzu.SenzuClient({
    "api_key": "your-api-key",
    "agent_id": "your-agent-id",
    "org_id": "your-org-id",
})

# High-level API with automatic context propagation
async def handle_request():
    async with client.run({"session_id": "abc"}) as run:
        step = run.start_step({"name": "fetch", "step_type": "tool"})
        result = await step.track_tool({"tool_name": "search", "fn": search})
        await step.end()

# Anthropic auto-tracking
from anthropic import AsyncAnthropic
from senzu.integrations.anthropic import WrapAnthropicOptions, wrap_anthropic

anthropic = wrap_anthropic(
    AsyncAnthropic(),
    WrapAnthropicOptions(client=client),
)

async def chat():
    async with client.run({}) as run:
        # messages.create() is tracked automatically
        return await anthropic.messages.create(
            model="claude-sonnet-4-6",
            max_tokens=1024,
            messages=[{"role": "user", "content": "Hello"}],
        )

Environment variables

Variable	Description
SENZU_API_KEY	API key
SENZU_BASE_URL	API base URL (default: http://localhost:3001)
SENZU_AGENT_ID	Agent ID
SENZU_ORG_ID	Organisation ID

Use from_env=True to load from environment:

client = senzu.SenzuClient({"from_env": True})

License

MIT