NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #1460 most downloaded on PyPI
SDK for integrating Braintrust
Latest stable
0.49.3
Last release 8 days ago
06 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Rarely documented
notes for 10 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
3 years old
299 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Improved LangChain integrations with simplified parsing for both TypeScript and Python
Improved LangChain integrations with simplified parsing for both TypeScript and Python
Added JSON attachment SDK support
Add OpenTelemetry compatibility mode for TypeScript. This allows OTel spans to work with Evals
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added Google GenAI wrapper support
Added Google GenAI wrapper support
Updated Mastra wrapper methods from generateVNext / streamVNext to generate / stream
Moved langchain-js braintrust dependency to peer dependencies
Fixed handling of attachments for Anthropic to avoid large base64 strings in UI
Fixed preservation of result object when returning from wrappedStreamObject in AI SDK
Fixed LanguageModelV1#supportsUrl being a function, not a property
Added wrapClaudeAgentSDK for automatic tracing of Claude Agent SDK applications
Added wrapClaudeAgentSDK for automatic tracing of Claude Agent SDK applications
Improved Anthropic wrapper to log consistent input/output format
Fixed AI SDK model detection in wrapGenerate callback
Added SpanComponentsV4 support
Added wrapClaudeAgentSDK for automatic tracing of Claude Agent SDK applications
Improved Anthropic wrapper to log consistent input/output format
Fixed AI SDK model detection in wrapGenerate callback
Added SpanComponentsV4 support
August 2025
Traces in the trace viewer on the logs page can now show all associated traces based on a metadata field or tag
Monitor page layout changed to be more responsive to screen size
Various UX improvements to prompt dialog
Improved onboarding experience
Trace timeline layout improvements
Pro plan organizations can now downgrade to the Starter plan via the settings page without contacting support
Prevent read-only users from downloading data from the UI
@mention team members in comments to notify them via email. To mention someone, type ”@” and a team member’s name or email in any comment input
You can now assign users to rows in experiments, logs, and datasets. Once assigned, you can filter rows by a specific user or a group of users
View configuration has been changed to no longer auto-save changes. It now shows a dirty state and you have the option of saving or resetting those changes back to the base view
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
Nothing published for this version
Nothing published for this version
Fixes logging very deep objects or with circular recursion
Added time to first token for Anthropic wrapper
Added time to first token for Anthropic wrapper
Fixes nesting for OpenAI agents wrapper
Fixed remote evals bug where experiments were not properly marked as completed on the backend
Fixed remote evals bug where experiments were not properly marked as completed on the backend
Fixed dataset _internal_btql parameter to properly override default BTQL settings (e.g., custom limit values)
Added DSPy integration with wrap_dspy wrapper for automatic tracing of DSPy applications
Added DSPy integration with wrap_dspy wrapper for automatic tracing of DSPy applications
Added OpenTelemetry distributed tracing helpers ( context_from_span_export() and span_context_from_span_export() ) for seamless trace propagation between Braintrust and OpenTelemetry across service boundaries
Added support for GEMINI_API_KEY environment variable
Ensure experiments use SpanComponentsV3 by default
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
Nothing published for this version
Nothing published for this version
Nothing published for this version
Python SDK now correctly nests spans logged from inside tool calls in OpenAI Agents
Support data masking (see docs )
Support data masking (see docs )
Remote evals in Python SDK
Support tags in Eval hooks
Validate attachment file readability at creation time
Allow non-batch span processors in BraintrustSpanProcessor
Fix openai-agents to inherit the right tracing context
Added environment parameter to load_prompt
Added environment parameter to load_prompt
The Otel SpanProcessor now keeps traceloop.* spans by default
Experiments can now be run without sending results to the server
Span creation is significantly faster in Python
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)
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
Added BraintrustSpanProcessor to simplify Braintrust’s integration with OpenTelemetry
Added support for loading prompts by ID via the load_prompt function. You can now load prompts directly by their unique identifier
Nothing published for this version
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
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
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
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
Nothing published for this version
Nothing published for this version
One column per quarter.