diff --git a/changelog.mdx b/changelog.mdx index c1190c7e..55697ead 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -225,7 +225,7 @@ For API library updates, see the [Node SDK](https://github.com/onkernel/kernel-n ## Product updates -- Released the [Kernel × Claude Managed Agents cookbook](https://github.com/kernel/claude-managed-agents-kernel), a public recipe for running parallel computer-use agent swarms with [Claude Managed Agents](/integrations/claude/claude-managed-agents) on Kernel cloud browsers, with API keys secured via Vaults. +- Released the [Kernel × Claude Managed Agents cookbook](https://github.com/kernel/cookbooks/tree/main/integrations/claude-managed-agents), a public recipe for running parallel computer-use agent swarms with [Claude Managed Agents](/integrations/claude/claude-managed-agents) on Kernel cloud browsers, with API keys secured via Vaults. - Shipped a `kernel-browser-harness` [skill](https://github.com/kernel/skills) for setting up Kernel browser sessions inside Claude Code with persistent session IDs across calls. - Extended `kernel browsers acquire` in the [CLI](https://github.com/kernel/cli) with `name` and `tags` parameters, so pooled browsers can be labeled at acquisition time alongside `browsers create`. - Made browser [telemetry](/browsers/telemetry) categories opt-in. The `--telemetry` flag (and `telemetry` request config) now records only the categories you list; enabling telemetry without specifying categories ships a small default set instead of every category. diff --git a/cookbooks.mdx b/cookbooks.mdx new file mode 100644 index 00000000..8f8fab12 --- /dev/null +++ b/cookbooks.mdx @@ -0,0 +1,62 @@ +--- +title: "cookbooks" +description: "end-to-end recipes to teach agents to use the internet" +mode: "wide" +--- + +Self-contained cookbooks to clone and run. Use as 1-click starts for your agents or as templates for your own build. + +import { CookbookSearch } from '/snippets/cookbook-search.jsx'; + + + + + +
common patterns
+ Enable Payments in a Browser Agent + + +
harnesses & models
+ Browser automation with the Vercel AI SDK and Kernel's Playwright execution API. + + +
harnesses & models
+ RL training for computer use agents, using Tinker. + + +
harnesses & models
+ Human-in-the-loop web task assistant with memory, built on Mastra. + + +
harnesses & models
+ Run parallel computer-use agent swarms, with API keys secured via Vaults. + + +
harnesses & models
+ QA your PR previews with Claude computer use on Modal, recorded with Replays. + + +
harnesses & models
+ Run the Browser Use bu-1.0 model on Kernel browser infrastructure. + + +
common patterns
+ Using Playwright with Computer Use Fallback + + +
harnesses & models
+ Computer use agent with Google's Gemini 2.5 and Stagehand. + + +
harnesses & models
+ Vibium browser automation over WebDriver BiDi. + + +
harnesses & models
+ Minimal implementation of Anthropic's computer use loop. + + +
harnesses & models
+ Scrape JS-rendered pages behind a login, on Modal with a Kernel headful browser. + + diff --git a/cookbooks/ai-sdk-agent.mdx b/cookbooks/ai-sdk-agent.mdx new file mode 100644 index 00000000..13b1108c --- /dev/null +++ b/cookbooks/ai-sdk-agent.mdx @@ -0,0 +1,4 @@ +--- +title: "AI SDK Agent" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/ai-sdk-agent" +--- diff --git a/cookbooks/browser-use-model.mdx b/cookbooks/browser-use-model.mdx new file mode 100644 index 00000000..ca3eb39d --- /dev/null +++ b/cookbooks/browser-use-model.mdx @@ -0,0 +1,4 @@ +--- +title: "Browser Use Model" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/browser-use-model" +--- diff --git a/cookbooks/claude-computer-use-loop.mdx b/cookbooks/claude-computer-use-loop.mdx new file mode 100644 index 00000000..d4ed8cfd --- /dev/null +++ b/cookbooks/claude-computer-use-loop.mdx @@ -0,0 +1,4 @@ +--- +title: "Claude Computer Use Loop" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/claude-computer-use-loop" +--- diff --git a/cookbooks/claude-managed-agents.mdx b/cookbooks/claude-managed-agents.mdx new file mode 100644 index 00000000..b8146a13 --- /dev/null +++ b/cookbooks/claude-managed-agents.mdx @@ -0,0 +1,4 @@ +--- +title: "Claude Managed Agents" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/claude-managed-agents" +--- diff --git a/cookbooks/mastra-web-task-assistant.mdx b/cookbooks/mastra-web-task-assistant.mdx new file mode 100644 index 00000000..4e2cc0b6 --- /dev/null +++ b/cookbooks/mastra-web-task-assistant.mdx @@ -0,0 +1,4 @@ +--- +title: "Mastra Web Task Assistant" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/mastra-web-task-assistant" +--- diff --git a/cookbooks/modal-pr-qa-agent.mdx b/cookbooks/modal-pr-qa-agent.mdx new file mode 100644 index 00000000..2131cb96 --- /dev/null +++ b/cookbooks/modal-pr-qa-agent.mdx @@ -0,0 +1,4 @@ +--- +title: "Modal PR QA Agent" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/modal-pr-qa-agent" +--- diff --git a/cookbooks/modal-web-scraper.mdx b/cookbooks/modal-web-scraper.mdx new file mode 100644 index 00000000..413c1bad --- /dev/null +++ b/cookbooks/modal-web-scraper.mdx @@ -0,0 +1,4 @@ +--- +title: "Modal Web Scraper" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/modal-web-scraper" +--- diff --git a/cookbooks/stagehand-google-cua-agent.mdx b/cookbooks/stagehand-google-cua-agent.mdx new file mode 100644 index 00000000..69671b6f --- /dev/null +++ b/cookbooks/stagehand-google-cua-agent.mdx @@ -0,0 +1,4 @@ +--- +title: "Stagehand Google CUA Agent" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/stagehand-google-cua-agent" +--- diff --git a/cookbooks/tinker-rl.mdx b/cookbooks/tinker-rl.mdx new file mode 100644 index 00000000..073a2c16 --- /dev/null +++ b/cookbooks/tinker-rl.mdx @@ -0,0 +1,4 @@ +--- +title: "Tinker RL" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/tinker-rl" +--- diff --git a/cookbooks/vibium.mdx b/cookbooks/vibium.mdx new file mode 100644 index 00000000..13f7cbd2 --- /dev/null +++ b/cookbooks/vibium.mdx @@ -0,0 +1,4 @@ +--- +title: "Vibium" +url: "https://github.com/kernel/cookbooks/tree/main/integrations/vibium" +--- diff --git a/docs.json b/docs.json index 8ab3f210..27419466 100644 --- a/docs.json +++ b/docs.json @@ -137,9 +137,7 @@ "browsers/curl", "browsers/ssh", "browsers/computer-controls", - "browsers/playwright-execution", - "browsers/playwright-computer-use-fallback", - "browsers/enable-payments-in-browser-agent" + "browsers/playwright-execution" ] }, { @@ -308,6 +306,34 @@ "tab": "API Reference", "openapi": "https://api.onkernel.com/spec.json" }, + { + "tab": "Cookbooks", + "pages": [ + "cookbooks", + { + "group": "Common Patterns", + "pages": [ + "browsers/playwright-computer-use-fallback", + "browsers/enable-payments-in-browser-agent" + ] + }, + { + "group": "Harnesses & Models", + "pages": [ + "cookbooks/modal-web-scraper", + "cookbooks/modal-pr-qa-agent", + "cookbooks/claude-managed-agents", + "cookbooks/claude-computer-use-loop", + "cookbooks/ai-sdk-agent", + "cookbooks/stagehand-google-cua-agent", + "cookbooks/browser-use-model", + "cookbooks/mastra-web-task-assistant", + "cookbooks/vibium", + "cookbooks/tinker-rl" + ] + } + ] + }, { "tab": "CLI", "groups": [ diff --git a/images/cookbooks/browser-use.png b/images/cookbooks/browser-use.png new file mode 100644 index 00000000..5fbfac49 Binary files /dev/null and b/images/cookbooks/browser-use.png differ diff --git a/images/cookbooks/claude.png b/images/cookbooks/claude.png new file mode 100644 index 00000000..86742041 Binary files /dev/null and b/images/cookbooks/claude.png differ diff --git a/images/cookbooks/mastra.png b/images/cookbooks/mastra.png new file mode 100644 index 00000000..9e636118 Binary files /dev/null and b/images/cookbooks/mastra.png differ diff --git a/images/cookbooks/modal.png b/images/cookbooks/modal.png new file mode 100644 index 00000000..731bb584 Binary files /dev/null and b/images/cookbooks/modal.png differ diff --git a/images/cookbooks/payments.png b/images/cookbooks/payments.png new file mode 100644 index 00000000..877c0f11 Binary files /dev/null and b/images/cookbooks/payments.png differ diff --git a/images/cookbooks/playwright.png b/images/cookbooks/playwright.png new file mode 100644 index 00000000..b222648c Binary files /dev/null and b/images/cookbooks/playwright.png differ diff --git a/images/cookbooks/stagehand.png b/images/cookbooks/stagehand.png new file mode 100644 index 00000000..9ab5e583 Binary files /dev/null and b/images/cookbooks/stagehand.png differ diff --git a/images/cookbooks/tinker.png b/images/cookbooks/tinker.png new file mode 100644 index 00000000..c2e70364 Binary files /dev/null and b/images/cookbooks/tinker.png differ diff --git a/images/cookbooks/vercel.png b/images/cookbooks/vercel.png new file mode 100644 index 00000000..2de502ab Binary files /dev/null and b/images/cookbooks/vercel.png differ diff --git a/images/cookbooks/vibium.png b/images/cookbooks/vibium.png new file mode 100644 index 00000000..10be5c2a Binary files /dev/null and b/images/cookbooks/vibium.png differ diff --git a/integrations/browser-use.mdx b/integrations/browser-use.mdx index 406dca95..bcfb50d1 100644 --- a/integrations/browser-use.mdx +++ b/integrations/browser-use.mdx @@ -5,6 +5,10 @@ icon: "/images/integration-icons/browser-use-logo-transparent.svg" [Browser Use](https://github.com/browser-use/browser-use) is the AI browser agent that empowers anyone to automate repetitive online tasks, no code required. By integrating with Kernel, you can run Browser Use Agents and automations with cloud-hosted browsers. + +A complete, runnable example that drives the Browser Use bu-1.0 model on Kernel browsers lives in the [Browser Use + Kernel cookbook](https://github.com/kernel/cookbooks/tree/main/integrations/browser-use-model). + + ## Adding Kernel to existing Browser Use implementations If you already have a Browser Use implementation, you can easily switch to using Kernel's cloud browsers by updating your Browser definition. diff --git a/integrations/claude/claude-managed-agents.mdx b/integrations/claude/claude-managed-agents.mdx index e3e15e73..e1e78a89 100644 --- a/integrations/claude/claude-managed-agents.mdx +++ b/integrations/claude/claude-managed-agents.mdx @@ -58,7 +58,7 @@ The example code below is TypeScript. The same API is exposed through the Anthro ## Quickstart -The complete, runnable version of this quickstart lives in the [Claude Managed Agents + Kernel cookbook](https://github.com/kernel/claude-managed-agents-kernel), alongside more recipes for parallel computer-use agent swarms. +The complete, runnable version of this quickstart lives in the [Claude Managed Agents + Kernel cookbook](https://github.com/kernel/cookbooks/tree/main/integrations/claude-managed-agents), alongside more recipes for parallel computer-use agent swarms. diff --git a/integrations/computer-use/anthropic.mdx b/integrations/computer-use/anthropic.mdx index b6c5467b..2f283605 100644 --- a/integrations/computer-use/anthropic.mdx +++ b/integrations/computer-use/anthropic.mdx @@ -6,6 +6,10 @@ title: "Anthropic" By integrating Computer Use with Kernel, you can run these AI-powered browser automations on cloud-hosted infrastructure, eliminating the need for local browser management and enabling scalable, reliable AI agents. + +A minimal, runnable implementation of Anthropic's computer use loop lives in the [Claude computer use loop cookbook](https://github.com/kernel/cookbooks/tree/main/integrations/claude-computer-use-loop). + + ## Quick setup with Computer Use Get started with Computer Use and Kernel using our pre-configured app template: diff --git a/integrations/stagehand.mdx b/integrations/stagehand.mdx index 90314317..304e20f3 100644 --- a/integrations/stagehand.mdx +++ b/integrations/stagehand.mdx @@ -9,6 +9,10 @@ icon: "/images/integration-icons/stagehand-logo-transparent.svg" This guide covers both Stagehand SDK v4 and v3. v4 runs as a Chrome extension alongside the browser rather than driving it purely over CDP, so a remote Kernel browser needs the extension loaded into it — the version tabs below show each setup. To move between versions, see the [Stagehand migration guide](https://docs.stagehand.dev). The CLI template uses v4. + +A complete, runnable computer use agent built with Stagehand and Google's Gemini 2.5 lives in the [Stagehand + Kernel cookbook](https://github.com/kernel/cookbooks/tree/main/integrations/stagehand-google-cua-agent). + + ## Quick start with the Stagehand template The fastest way to run Stagehand on Kernel is our app template, which comes pre-wired for v4: diff --git a/integrations/vercel/ai-sdk.mdx b/integrations/vercel/ai-sdk.mdx index 5f0a464f..8a50ac04 100644 --- a/integrations/vercel/ai-sdk.mdx +++ b/integrations/vercel/ai-sdk.mdx @@ -9,6 +9,10 @@ The `@onkernel/ai-sdk` package provides Vercel AI SDK-compatible tools for brows With this tool, AI agents can execute Playwright code on Kernel's remote browsers, enabling powerful browser automation capabilities in your AI-powered applications. + +A complete, runnable agent built on this tool lives in the [AI SDK + Kernel cookbook](https://github.com/kernel/cookbooks/tree/main/integrations/ai-sdk-agent). + + ## Installation Install the package along with its peer dependencies: diff --git a/integrations/vibium.mdx b/integrations/vibium.mdx index eaeae647..bb22e719 100644 --- a/integrations/vibium.mdx +++ b/integrations/vibium.mdx @@ -5,6 +5,10 @@ icon: "/images/integration-icons/vibium.svg" [Vibium](https://github.com/VibiumDev/vibium) is a brand-new browser automation framework for AI agents that is built on WebDriver BiDi, a W3C standard. As of [v26.3.9](https://github.com/VibiumDev/vibium/releases/tag/v26.3.9), any agent can now use Vibium to connect to Kernel cloud browsers to navigate pages, fill forms, click buttons, and take screenshots. We're really excited to keep working with Jason Huggins and to keep supporting open web standards. + +A complete, runnable version of this integration lives in the [Vibium + Kernel cookbook](https://github.com/kernel/cookbooks/tree/main/integrations/vibium). + + ## Adding Kernel to existing Vibium implementations If you already have a Vibium implementation, you can switch to using Kernel's cloud browsers by creating a Kernel browser session and connecting Vibium to the returned `webdriver_ws_url`. diff --git a/snippets/cookbook-search.jsx b/snippets/cookbook-search.jsx new file mode 100644 index 00000000..eb00f2fa --- /dev/null +++ b/snippets/cookbook-search.jsx @@ -0,0 +1,51 @@ +const { useState, useCallback } = React; + +export const CookbookSearch = () => { + const [matches, setMatches] = useState(null); + + const getCards = () => { + const anchors = Array.from( + document.querySelectorAll('a[href^="https://github.com/kernel/cookbooks/tree/main/"]') + ).filter((a) => !a.closest('nav') && !a.closest('aside')); + const cards = anchors.map((a) => a.closest('.card') || a); + return Array.from(new Set(cards)); + }; + + const handleInput = useCallback((e) => { + const q = e.target.value.trim().toLowerCase(); + const cards = getCards(); + let count = 0; + cards.forEach((card) => { + const hit = q === '' || card.textContent.toLowerCase().includes(q); + card.style.display = hit ? '' : 'none'; + if (hit) count++; + }); + setMatches(q === '' ? null : count); + }, []); + + return ( +
+ + {matches === 0 && ( +

+ no cookbooks match your search. +

+ )} +
+ ); +}; diff --git a/style.css b/style.css index 8c7fcc8d..c25c912e 100644 --- a/style.css +++ b/style.css @@ -312,3 +312,23 @@ html.dark .callout[class*="yellow"] svg { html.dark #navigation-items img[src*="/images/integration-icons/"] { filter: invert(1); } + +/* cookbooks: sidebar entries under /cookbooks/ are external GitHub links (url frontmatter), + so hide pagination that would point at them */ +#pagination a[href^="/cookbooks/"] { + display: none; +} + +/* cookbooks card category label — matches the site eyebrow/type setup in the reference */ +.cookbook-tag { + display: block; + font-size: 0.6875rem; + font-weight: 400; + letter-spacing: -0.015em; + opacity: 0.72; + margin-bottom: 0.5rem; +} + +html.dark .cookbook-tag { + color: rgba(237, 238, 240, 0.7); +}