An isomorphic JS library for logging data to Braintrust.

Version information

1.x is the current stable release with improved ESM support. OpenTelemetry integration is available via the separate @braintrust/otel package.

Upgrading from 0.x

If you're on version 0.4.10 or earlier, we recommend upgrading to 1.x. See the TypeScript SDK upgrade guide for migration instructions.

Quickstart

Install the library with npm (or yarn).

npm install braintrust

Then, run a simple experiment with the following code (replace YOUR_API_KEY with your Braintrust API key):

import * as braintrust from "braintrust";

async function main() {
  const experiment = await braintrust.init("NodeTest", {
    apiKey: "YOUR_API_KEY",
  });
  experiment.log({
    input: { test: 1 },
    output: "foo",
    expected: "bar",
    scores: {
      n: 0.5,
    },
    metadata: {
      id: 1,
    },
  });
  console.log(await experiment.summarize());
}

main().catch(console.error);