NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3278 most downloaded on PyPI
DEPRECATED: LangChain integration is now included in the main braintrust package. Install braintrust instead.
Latest stable
0.3.0
Last release 7 months ago
01 Apr 2026
Release timing varies
gaps range from 9 days to 5 months
Most releases are documented
notes for 9 of 14 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
14 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Added OpenTelemetry compatibility mode for seamless integration between Braintrust and OTEL tracing
Added OpenTelemetry compatibility mode for seamless integration between Braintrust and OTEL tracing
Added setup_claude_agent_sdk for automatic tracing of Claude Agent SDK applications
Improved Anthropic wrapper to log consistent input/output format
Added strict parameter to Prompt.build for strict schema validation
Added SpanComponentsV4 support
Fix langchain-py integration tracing when users use a @traced method
Fix langchain-py integration tracing when users use a @traced method
Wrap OpenAI responses.parse
Add @traced support for generator functions
Autoevals PY (version 0.0.130)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
When running multiple trials per input ( trial_count > 1 ), you can now access the current trial index (0-based) via hooks.trialIndex in your task fun
When running multiple trials per input ( trial_count > 1 ), you can now access the current trial index (0-based) via hooks.trialIndex in your task function
Added BraintrustExporter in addition to BraintrustSpanProcessor
Bound max ancestors in git to 1,000
The SDK’s under-the-hood log queue will not block when full and has a default size of 25000 logs
The SDK’s under-the-hood log queue will not block when full and has a default size of 25000 logs
You can configure the max size by setting BRAINTRUST_LOG_QUEUE_MAX_SIZE in your environment
Improvements to the logging of parallel tool calls
Attachments are now converted to base64 data URLs, making it easier to work with image attachments in prompts
October 2025
Enabled editing and resending Loop chat messages
Document how to integrate Apollo GraphQL and Braintrust for automatic tracing
Add support for Grok 4 Fast (Reasoning & Non-Reasoning)
Add support for Groq gwen/gwen3-32 & moonshotai/kimi-k2-instruct-0905
Deprecate Anthropic Claude 3.5 models as they are no longer supported by Anthropic
Modify Apply filter button in btql tool to be more prominent
Added AI-assisted generation to run data box in scorer details page
Added message queuing to Loop
Added a button to extract filter clause from a btql query in filter btql editor
Start a Loop conversation from the CMD-K menu
Move Loop button to the bottom right of the screen
Use case examples when creating a playground
Java SDK
Scope collapse state for span fields by the span type
Collapse/expand all button for LLM data view
By default, collapse all messages in LLM data view besides the last turn
Generate scorer spans when applying scores to logs
Added support for scoring experiment rows
Added AI-assisted generation in tools form, btql filter form and online scoring form
Increased default maximum agentic tool use roundtrips from 5 to 100
Added support for Gemini tracing
Added support for Claude 4.5 Haiku
Added Loop to the prompt and scorer detail pages
Refreshed OpenAI Realtime Audio proxy support - Updated AI proxy to support the latest OpenAI SDK (v6.0+) for realtime audio interactions
Added support for both OpenAIRealtimeWebSocket (browser/Cloudflare Workers) and OpenAIRealtimeWS (Node.js with ws library)
Updated event types to match the current OpenAI Realtime API specification ( response.output_audio.delta , response.output_text.delta , etc.)
Added header-based authentication and logging with x-bt-parent and x-bt-compress-audio headers
Improved audio logging with automatic format detection and optional MP3 compression for reduced storage costs
Added “Pretty” span field display option that optimizes for object value readability and renders object values in markdown
The Pretty display option replaces the Markdown option since Pretty renders markdown by default
Added support for viewing spans in the table on the logs page
Added GPT-5 Pro support
Added Review page to see spans marked for review in logs, experiments and datasets across a project
Fixed Loop prompt optimization of remote evals
Fix issue with thinking events coming from Mistral
Added Toplist and Big number monitor chart types
Support for JSON attachments
Improve “Raw span data” and new buttons to download a span or entire trace as JSON from the trace viewer
Add project.publish() to directly push prompts to Braintrust (without running braintrust push )
Add project.publish() to directly push prompts to Braintrust (without running braintrust push )
@traced now works correctly with async generator functions
The OpenAI and Anthropic wrappers set provider metadata
Improve retry logic in the control plane connection (used to create new experiments and datasets)
May 2025
The “Faster tables” flag is now the default. You should notice experiments, datasets, and the logs page load much faster
Add Claude 4 models in Bedrock and Vertex to the AI proxy and playground
Braintrust now incorporates cached tokens into the cost calculations for experiments and logs
The monitor page also now includes separate lines so you can track costs and counts for uncached, cached, and cache creation tokens
Native support for thinking parameters in the playground
Improved playground prompt editor stability and performance
Capture cached tokens from OpenAI and Anthropic models in a unified format and surface them in the UI
Create experiments from the experiments list page using saved prompts/agents
New BTQL sandbox page and editor with autocomplete
Fullscreen-able monitor charts
Added a ‘Copy page’ button to the top of every docs page
Brainstore now supports vacuuming data from object storage to reclaim space
Organization owners can manage API keys for all users in their organization in the UI
Add endpoint for admins to list all ACLs within an org
Collapsible sidebar navigation
Command bar (CMD/CTRL+K) to quickly navigate and between pages and projects
View monitor page logs across all projects in an organization
Added Mistral Medium 3 and Gemini 2.5 Pro Preview to the AI proxy and playground
Self-hosted builds now log in a structured JSON format that is easier to parse
Added support for metadata and tags arguments to invoke
Added support for metadata and tags arguments to invoke
The SDK now gracefully handles OpenAI’s NotGiven parameter
Added span.link() to synchronously generate permalinks
Added BraintrustSpanProcessor to simplify integration with OpenTelemetry
Fix a bug where large experiments would drop spans if they could not flush data fast enough
Fix a bug where large experiments would drop spans if they could not flush data fast enough
Fix bug in attachment uploading in evals executed with npx braintrust eval
Upgrading zod dependency from ^3.22.4 to ^3.25.3
Added support for loading prompts by ID via the loadPrompt function
Fix a bug where large experiments would drop spans if they could not flush data fast enough
Fix bug in attachment uploading in evals executed with npx braintrust eval
Upgrading zod dependency from ^3.22.4 to ^3.25.3
Added support for loading prompts by ID via the loadPrompt function
June 2025
Time range filters on the logs page
Add support for multi-factor authentication
Fix a bug with Vertex AI calls when the request includes the anthropic-beta header
Add Zapier integration to trigger Zaps when there’s a new automation event or a new project
Add OpenAI’s o3-pro model to the playground and AI proxy
View parameters are now present in the url when viewing a default view
Experiments charting controls have been added into views
Experiment objects now support tags through the API and on the experiments view
Add support for Gemini 2.5 Pro, Gemini 2.5 Flash, and Gemini 2.5 Flash Lite
Correctly propagate expected and metadata values to function calls when running invoke
Chat-like thread layout that simplifies thread display to LLM and score data
Enable all agent nodes to access dataset variables with the mustache variable {{dataset}}
Improve reliability of online scoring when logging high volumes of data to a project
Tags can now be sorted in the project configuration page which will change their display order in other parts of the UI
System-only messages are now supported in Anthropic and Bedrock models
Logs page UI can now filter nested data fields in metadata , input , output , and expected
Support reasoning params and reasoning tokens in streaming and non-streaming responses in the AI proxy and across the product
New braintrust-proxy Python library to help developers integrate with their IDEs to support new reasoning input and output types
New @braintrust/proxy/types module to augment OpenAI libraries with reasoning input and output types
New streaming protocol between Brainstore and the API server speeds up queries
Time brushing interaction enabled on Monitor page charts
Can create user-defined views in the monitoring page
Live updating time mode added to the monitoring page
The anthropic package is now included by default in Python functions
Audit log queries must now specify an id filter for the set of rows to fetch
(Beta) continuously export logs, experiments, and datasets to S3
Enable passing metadata and expected as arguments to the first agent prompt node
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.