Braintrust Python SDK
The official Python SDK for logging, tracing, and evaluating AI applications with Braintrust.
Installation
Install the SDK:
pip install braintrust
Quickstart
Run a simple evaluation:
from braintrust import Eval
def is_equal(expected, output):
return expected == output
Eval(
"Say Hi Bot",
data=lambda: [
{"input": "Foo", "expected": "Hi Foo"},
{"input": "Bar", "expected": "Hello Bar"},
],
task=lambda input: "Hi " + input,
scores=[is_equal],
)
Then run:
BRAINTRUST_API_KEY=<YOUR_API_KEY> braintrust eval tutorial_eval.py
Optional Extras
Install extras as needed for specific workflows:
pip install "braintrust[cli]"
pip install "braintrust[openai-agents]"
pip install "braintrust[otel]"
pip install "braintrust[temporal]"
pip install "braintrust[all]"
Available extras:
performance: installsorjsonfor faster JSON serializationcli: installs optional dependencies used by the Braintrust CLIopenai-agents: installs OpenAI Agents integration supportotel: installs OpenTelemetry integration dependenciestemporal: installs Temporal integration dependenciesall: installs all optional extras
Documentation
- Python SDK docs: https://www.braintrust.dev/docs/reference/sdks/python
- Braintrust docs: https://www.braintrust.dev/docs
- Repo publishing guide: https://github.com/braintrustdata/braintrust-sdk-python/blob/main/docs/publishing.md
- Source code: https://github.com/braintrustdata/braintrust-sdk-python/tree/main/py
License
Apache-2.0
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file braintrust-0.31.1.tar.gz.
File metadata
- Download URL: braintrust-0.31.1.tar.gz
- Upload date:
- Size: 699.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aab8fb47bff734d65c75344c8c9194378e7d3d226069acaeaea10896aa870b33
|
|
| MD5 |
5bc228edecd7f099e7c85c0e6905b04d
|
|
| BLAKE2b-256 |
0d7e04da2c3adc0acaf0d3e11e11aeba45ae89aea58fd89c6822f51639cdbd87
|
Provenance
The following attestation bundles were made for braintrust-0.31.1.tar.gz:
Publisher:
publish-py-sdk.yaml on braintrustdata/braintrust-sdk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
braintrust-0.31.1.tar.gz -
Subject digest:
aab8fb47bff734d65c75344c8c9194378e7d3d226069acaeaea10896aa870b33 - Sigstore transparency entry: 2341254184
- Sigstore integration time:
-
Permalink:
braintrustdata/braintrust-sdk-python@8f264c78c36fea290fe43d5692150717532d9a80 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/braintrustdata
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-py-sdk.yaml@8f264c78c36fea290fe43d5692150717532d9a80 -
Trigger Event:
pull_request
-
Statement type:
File details
Details for the file braintrust-0.31.1-py3-none-any.whl.
File metadata
- Download URL: braintrust-0.31.1-py3-none-any.whl
- Upload date:
- Size: 814.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4ccb2ff9c5061ff148282792eb1b7059f25eb668d4c2504869dc9a1f079c4108
|
|
| MD5 |
74980ba5364f6b49b1be7b8eb7d9f75e
|
|
| BLAKE2b-256 |
88b93804d16e6f8ecae8a6623f4f165e0eb720949f032bc3118aa26c6b521f2e
|
Provenance
The following attestation bundles were made for braintrust-0.31.1-py3-none-any.whl:
Publisher:
publish-py-sdk.yaml on braintrustdata/braintrust-sdk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
braintrust-0.31.1-py3-none-any.whl -
Subject digest:
4ccb2ff9c5061ff148282792eb1b7059f25eb668d4c2504869dc9a1f079c4108 - Sigstore transparency entry: 2341254189
- Sigstore integration time:
-
Permalink:
braintrustdata/braintrust-sdk-python@8f264c78c36fea290fe43d5692150717532d9a80 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/braintrustdata
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-py-sdk.yaml@8f264c78c36fea290fe43d5692150717532d9a80 -
Trigger Event:
pull_request
-
Statement type:
