bentolabs-sdk 0.2.0

Official BentoLabs Python SDK. Drop-in OpenTelemetry span processor that ships traces to the BentoLabs ingest API over OTLP/HTTP+JSON.

bentolabs-sdk

Official BentoLabs Python SDK. A drop-in OpenTelemetry span processor that ships traces to the BentoLabs ingest API over OTLP/HTTP+JSON.

Status: 0.2.0. Stable surface for api_key / base_url resolution and OTel ingest, plus the higher-level analytics convenience layer.

Two layers

This package ships two surfaces. Pick whichever fits:

• Analytics convenience layer (bentolabs_sdk.analytics) — Raindrop-shaped functions (init, track_ai, flush, shutdown). You don't manage the OTel pipeline yourself; just call bento.track_ai(...) and data lands in your dashboard. Start here: INTEGRATION.md — one-pager covering every kwarg, the dashboard feature it powers, and common mistakes.
• OTel transport (BentoLabsSpanProcessor, BentoLabsTraceExporter) — wire the SDK into your existing OpenTelemetry pipeline. The rest of this README covers it.

Install

pip install bentolabs-sdk opentelemetry-api opentelemetry-sdk

Usage

from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider

from bentolabs_sdk import BentoLabsSpanProcessor

provider = TracerProvider()
provider.add_span_processor(BentoLabsSpanProcessor())
trace.set_tracer_provider(provider)

tracer = trace.get_tracer("example")
with tracer.start_as_current_span("agent.run") as span:
    span.set_attribute("input.value", "Summarize the incident")
    span.set_attribute("output.value", "The incident is resolved.")

provider.force_flush()
provider.shutdown()

The processor batches spans with OpenTelemetry defaults and POSTs them to ${base_url}/v1/traces with Authorization: Bearer bl_pk_.... The bl_pk_ prefix is validated up front.

Configuration

from bentolabs_sdk import resolve_options

cfg = resolve_options()

Field	Resolution order
api_key	explicit argument -> BENTOLABS_API_KEY -> raises BentoAuthError
base_url	explicit argument -> BENTOLABS_BASE_URL -> https://api.bentolabs.ai

from bentolabs_sdk import BentoAuthError, BentoLabsSpanProcessor

try:
    processor = BentoLabsSpanProcessor(base_url="http://localhost:8080")
except BentoAuthError as exc:
    if exc.code == "missing_api_key":
        # telemetry disabled or misconfigured
        pass
    raise

Requirements

• Python 3.10+

License

Proprietary. Copyright (c) 2026 BentoLabs, Inc. All rights reserved. Use is governed by your written agreement with BentoLabs, Inc.