Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Providers

Choose where agent browser sessions run — local Chromium or a managed cloud provider.
A provider implements BrowserProvider: it creates a CDP endpoint for each session and tears it down on close. Pass any provider into createBrowserTools, createAiSdkBrowserTools, or createPiBrowserTools.
This is the SDK surface. For Libretto CLI open / run provider config, see Alternative providers.

Built-in providers

ProviderImportRequired env
Locallibretto-browser-tools(Chromium via npx playwright install chromium)
Libretto Cloudlibretto-browser-tools/libretto-cloudLIBRETTO_API_KEY
Kernellibretto-browser-tools/kernelKERNEL_API_KEY
Browserbaselibretto-browser-tools/browserbaseBROWSERBASE_API_KEY
Browser Uselibretto-browser-tools/browser-useBROWSER_USE_API_KEY
Steellibretto-browser-tools/steelSTEEL_API_KEY
Customimplement BrowserProvider(your credentials)
Cloud providers attach over CDP and do not need a local Chromium download. Only Local requires npx playwright install chromium.

Usage

import { createAiSdkBrowserTools } from "libretto-browser-tools/ai-sdk";
import { KernelBrowserProvider } from "libretto-browser-tools/kernel";

const { tools, dispose } = createAiSdkBrowserTools(
  new KernelBrowserProvider(), // reads KERNEL_API_KEY from the environment
);
Missing API keys throw from the provider constructor (host-level errors), not as { ok: false } tool results.
Libretto
Powered byHolocron