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.

Kernel

Run agent browser sessions on Kernel.
Import from libretto-browser-tools/kernel. For Libretto CLI open / run on Kernel, see Alternative providers: Kernel.

Configure

KERNEL_API_KEY=<kernel-api-key>
# optional
# KERNEL_HEADLESS=true
# KERNEL_STEALTH=false
# KERNEL_TIMEOUT_SECONDS=300
# KERNEL_PROXY_ID=
# KERNEL_ENABLE_RECORDING=false
# KERNEL_API_ENDPOINT=https://api.onkernel.com

Provider options

Constructor / env settings for the provider itself:
OptionEnvDefaultDescription
apiKeyKERNEL_API_KEY(required)API key
headlessKERNEL_HEADLESStrueHeadless browser
stealthKERNEL_STEALTHfalseKernel stealth mode
proxyIdKERNEL_PROXY_ID—Optional Kernel proxy id
timeoutSecondsKERNEL_TIMEOUT_SECONDS300Session timeout in seconds
enableRecordingKERNEL_ENABLE_RECORDINGfalseStart a replay; requires headless: false
Created sessions may include liveViewUrl and, when recording is enabled, recordingUrl. Closing returns replayUrl when a replay was started.

Session create options

Pass these to provider.createSession({ ... }) (or via browser_open({ url }) for startUrl):
OptionDescription
startUrlURL Kernel opens before CDP attach
gpuEnable Kernel GPU acceleration
viewport{ width, height } window size
Pass startUrl when the site blocks Playwright attach followed by page.goto(). Kernel navigates during browser create, before CDP is available, and returns startUrlPreloaded: true so callers skip a second navigation.

Example

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

const { tools, dispose } = createAiSdkBrowserTools(
  new KernelBrowserProvider({ stealth: true }),
);

try {
  // Prefer browser_open({ url }) so Kernel can preload startUrl.
  // agent loop using tools…
} finally {
  await dispose();
}
Powered byHolocron