Browserbase
Run agent browser sessions on Browserbase.
Import from
libretto-browser-tools/browserbase. For Libretto CLI open / run on Browserbase, see Alternative providers: Browserbase.Configure
1234BROWSERBASE_API_KEY=<browserbase-api-key> BROWSERBASE_PROJECT_ID=<browserbase-project-id> # optional # BROWSERBASE_ENDPOINT=https://api.browserbase.com
Provider options
Constructor / env settings for the provider itself:
| Option | Env | Default | Description |
apiKey | BROWSERBASE_API_KEY | (required) | API key |
projectId | BROWSERBASE_PROJECT_ID | — | Browserbase project id (recommended) |
endpoint | BROWSERBASE_ENDPOINT | https://api.browserbase.com | API base URL |
proxies | — | — | Enable Browserbase proxies when true |
solveCaptchas | — | — | Enable captcha solving when true |
timeoutSeconds | — | — | Session timeout in seconds |
Session create options
Pass these to
provider.createSession({ ... }) (or via browser_open({ url }) for startUrl):| Option | Description |
viewport | { width, height } via Browserbase browserSettings.viewport |
startUrl | Accepted for API symmetry; Browserbase cannot preload it — browser_open navigates after connect |
Example
123456789101112import { createAiSdkBrowserTools } from "libretto-browser-tools/ai-sdk"; import { BrowserbaseBrowserProvider } from "libretto-browser-tools/browserbase"; const { tools, dispose } = createAiSdkBrowserTools( new BrowserbaseBrowserProvider({ proxies: true }), ); try { // agent loop using tools… } finally { await dispose(); }