Braintrust | Respan Docs

Set up Respan

Sign up — Create an account at platform.respan.ai
Create an API key — Generate one on the API keys page
Add credits or a provider key — Add credits on the Credits page or connect your own provider key on the Integrations page

Use AI

Add the Docs MCP to your AI coding tool to get help building with Respan. No API key needed.

1 {
2   "mcpServers": {
3     "respan-docs": {
4       "url": "https://mcp.respan.ai/mcp/docs"
5     }
6   }
7 }

What is Braintrust?

Braintrust is an AI evaluation and observability platform. The Respan exporter registers as Braintrust’s background logger to mirror experiment and logging data to Respan.

Setup

Install packages

$ pip install braintrust respan-exporter-braintrust openai

Set environment variables

$ export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"
$ export BRAINTRUST_API_KEY="YOUR_BRAINTRUST_API_KEY"
$ export OPENAI_API_KEY="YOUR_OPENAI_API_KEY"

Initialize and run

1 import braintrust
2 from openai import OpenAI
3 from respan_exporter_braintrust import RespanBraintrustExporter
4 
5 client = OpenAI()
6 
7 with RespanBraintrustExporter():
8     @braintrust.traced
9     def generate_joke():
10         response = client.chat.completions.create(
11             model="gpt-4o-mini",
12             messages=[{"role": "user", "content": "Tell me a joke about AI"}],
13         )
14         return response.choices[0].message.content
15 
16     @braintrust.traced
17     def joke_pipeline():
18         return generate_joke()
19 
20     result = joke_pipeline()
21     print(result)

View your trace

Open the Traces page to see your Braintrust traces in Respan.

Configuration

Parameter	Type	Default	Description
`api_key`	`str`	`RESPAN_API_KEY` env var	Respan API key.
`base_url`	`str \| None`	`None`	API base URL.

See the Braintrust Exporter SDK reference for the full API.