SDK

PUVINOISE SDK for AI agents

Independent OpenTelemetry SDK with tracing and observability for Anthropic Claude, OpenAI, Ollama, and other LLM providers — plus optional decision telemetry for behaviour intelligence.

View quickstart Documentation

Overview

The puvinoise-sdk package instruments agent runs and exports OTLP traces to your PUVINOISE™ collector. It is designed for multi-tenant production: telemetry carries tenant and agent identity. Optional decision APIs add richer decision telemetry.

Reference document

Install and quickstart

From the SDK README. Configure via environment variables, then wrap agent work in a traced run.

Install

pip install puvinoise-sdk — optional extras [anthropic], [openai], or [all].

Bootstrap

bootstrap() reads PUVINOISE_* and CUST_LLM_PROVIDER from the environment.

Trace

run_with_trace creates an agent.run span and exports on the batch schedule.

Migrate

SDK upgrades stay backward compatible — see the migration notes.

# Install the PUVINOISE SDK
pip install puvinoise-sdk
 
# Optional provider extras
pip install puvinoise-sdk[anthropic]
pip install puvinoise-sdk[openai]
pip install puvinoise-sdk[all]

Related resources