Python SDKExporters (Legacy)

Braintrust Exporter

Installation

pip install respan-exporter-braintrust

Classes

RespanBraintrustExporter

Exports Braintrust logs to Respan by registering as Braintrust’s background logger.

from respan_exporter_braintrust import RespanBraintrustExporter
ParameterTypeDefaultDescription
api_keystr | NoneNoneRespan API key. Falls back to RESPAN_API_KEY env var.
base_urlstr | NoneNoneAPI base URL. Falls back to RESPAN_BASE_URL.

Methods

MethodDescription
install()Register as Braintrust’s background logger.
uninstall()Unregister from Braintrust.
log(*args)Log items to buffer.
flush(batch_size)Flush buffered items to Respan.

Context manager

The exporter supports context manager usage for automatic install/uninstall:

with RespanBraintrustExporter(api_key="your-api-key") as exporter:
    # Braintrust logs are automatically sent to Respan
    pass

Usage

import braintrust
from respan_exporter_braintrust import RespanBraintrustExporter
# Install as background logger
with RespanBraintrustExporter(api_key="your-api-key"):
    # Use Braintrust normally
    experiment = braintrust.init(project="my-project")
    experiment.log(
        input="Tell me a joke",
        output="Why did the AI cross the road?",
        scores={"humor": 0.8},
    )

Internal

  • Buffers records and flushes in batches
  • Converts Braintrust record format to Respan span format
  • Handles both root spans and child spans