Browserbase

Run Libretto sessions on Browserbase's managed browser infrastructure.

Browserbase is a managed browser provider. Use it when you want Libretto's local CLI and workflow runtime, but want Browserbase to host the browser session.

Configure Browserbase

Create a Browserbase API key and project, then add both values to the repo root .env file. Libretto loads .env automatically before running CLI commands.

123# inside .env
BROWSERBASE_API_KEY=<browserbase-api-key>
BROWSERBASE_PROJECT_ID=<browserbase-project-id>

BROWSERBASE_ENDPOINT is only needed if Browserbase gives you a custom API endpoint.

Then set Browserbase as the workspace's default browser provider in .libretto/config.json:

1234{
  "version": 1,
  "provider": "browserbase"
}

You can also use --provider browserbase on a single command instead of changing the config file.

Open a session

Open a page with the configured Browserbase provider:

1npx libretto open https://example.com --session browserbase-demo

If you did not set provider in .libretto/config.json, pass it for this command instead:

1npx libretto open https://example.com --provider browserbase --session browserbase-demo

After the session is open, use the normal Libretto commands:

123npx libretto snapshot --session browserbase-demo
npx libretto exec --session browserbase-demo "await page.title()"
npx libretto close --session browserbase-demo

Run a workflow

Run workflows normally when provider is set in .libretto/config.json:

1npx libretto run ./workflow.ts --headless

Or pass the provider for a single run:

1npx libretto run ./workflow.ts --provider browserbase --headless

The workflow code does not need to change. Libretto creates the Browserbase browser session, connects to it over CDP, runs the workflow, and releases the provider session when the run finishes.

When to use Browserbase

Choose Browserbase when you want a managed browser runtime and already use Browserbase for browser sessions. If you need to own the container runtime, scheduler, network, and secrets layer yourself, use GCP or AWS instead.