puvinoise-sdk 0.2.3

Independent OpenTelemetry SDK for AI agents (Anthropic, OpenAI, Ollama)

puvinoise-sdk

Independent OpenTelemetry SDK for AI agents. Supports Anthropic Claude, OpenAI, Ollama, and other LLM providers with tracing and observability.

Install

pip install puvinoise-sdk

Optional provider extras:

pip install puvinoise-sdk[anthropic]
pip install puvinoise-sdk[openai]
pip install puvinoise-sdk[all]

Quick start

from puvinoise import bootstrap, run_with_trace

bootstrap()  # Configure via env: CUST_AGENT_NAME, CUST_LLM_PROVIDER, PUVINOISE_TENANTID, PUVINOISE_AGENTACCESSKEY, PUVINOISE_END_POINT_URL

with run_with_trace("my-agent-run"):
    # Your agent / LLM calls
    pass

Environment

The SDK reads these variables from the environment (e.g. from a .env file):

Variable	Description
CUST_AGENT_NAME	Agent/service name (e.g. my-agent-system). Internally the SDK uses the variable puvicustagentname for this value to avoid name conflicts with customer agent code.
CUST_LLM_PROVIDER	Connected integration / LLM provider (e.g. openai, anthropic, ollama); mapped from your tenant’s connected integration
PUVINOISE_TENANTID	Tenant ID for multi-tenant isolation (from your PUViNoise organization)
PUVINOISE_AGENTACCESSKEY	Agent access key for authenticating with the OTLP endpoint (sent as Bearer token)
PUVINOISE_END_POINT_URL	OTLP collector URL (e.g. http://host:4318; /v1/traces is appended if missing)

Example .env:

CUST_AGENT_NAME=my-agent-system
CUST_LLM_PROVIDER=openai
PUVINOISE_TENANTID=your-tenant-id
PUVINOISE_AGENTACCESSKEY=your_agent_access_key
PUVINOISE_END_POINT_URL=http://localhost:4318

Telemetry emitted

The SDK sends all env-derived parameters to the collector so the dashboard can display and filter by them:

• Resource attributes (on every span): service.name (from CUST_AGENT_NAME), tenant.id (from PUVINOISE_TENANTID), puvinoise.llm_provider (from CUST_LLM_PROVIDER).
• Span attributes on agent.run: agent.name, agent.run_id, tenant.id, puvinoise.llm_provider, llm.provider.

The backend and dashboard use these to scope traces by tenant, filter by agent name and LLM provider, and show tenant ID and provider in the trace list and detail views.

License

Proprietary – PUVI LABS PRIVATE LIMITED