Skip to content

Commit f170ca3

Browse files
Restructure Overview: introduction, features, concepts, why KERNEL
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 15413ce commit f170ca3

9 files changed

Lines changed: 285 additions & 68 deletions

File tree

‎docs.json‎

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,10 @@
119119
{
120120
"group": "Overview",
121121
"pages": [
122-
"index"
122+
"index",
123+
"overview/products",
124+
"overview/concepts",
125+
"overview/why-kernel"
123126
]
124127
},
125128
{
@@ -305,13 +308,6 @@
305308
]
306309
}
307310
]
308-
},
309-
{
310-
"group": "Info",
311-
"pages": [
312-
"info/concepts",
313-
"info/unikernels"
314-
]
315311
}
316312
]
317313
},

‎images/overview/agent-stack.svg‎

Lines changed: 49 additions & 0 deletions
Loading

‎images/overview/cookbooks.svg‎

Lines changed: 17 additions & 0 deletions
Loading

‎images/overview/quickstart.svg‎

Lines changed: 15 additions & 0 deletions
Loading

‎index.mdx‎

Lines changed: 33 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -5,74 +5,47 @@ description: ""
55
mode: "wide"
66
---
77

8-
We build crazy fast, open source infra for AI agents to access the internet. Trusted by Cash App, Framer, and 11,000 teams.
8+
KERNEL is the internet runtime for agents. we provide crazy fast, open source browser infra for your agents to access and act on the internet. each chromium browser is pre-configured with anti-detection defaults, runs in its own vm with isolated resources, and can be driven with browser automation frameworks, computer controls, or cdp and webdriver bidi directly. beyond browsers, KERNEL provides a platform of infrastructure primitives so your agents have what they need on real websites: stealth and proxies, authentication, payments, live view, replays, and more.
99

10-
<Columns className="responsive-columns" cols={4}>
11-
<Card title="Sandboxed Chromium" img="/images/chromium.svg" href="/introduction/create">
12-
We spin up cloud browsers in &lt;30ms with GPU acceleration when needed.
13-
</Card>
14-
<Card title="Auth" img="/images/auth.svg" href="/auth/overview">
15-
choose Managed Auth or Fill from Vault for browser agents.
10+
## why we built it this way
11+
12+
most browser infrastructure runs chromium in containers orchestrated by kubernetes, with warm pools to hide slow starts. we [pioneered](https://www.kernel.sh/blog/scale) a different approach: running chromium on unikernels, single-purpose vms that carry only what the browser needs.
13+
14+
a unikernel carries the browser and nothing else, so there's little to boot or keep running. running every browser this way has many benefits, including:
15+
16+
- **lifecycle actions are fast.** a browser is created in about 30ms at p50 and 105ms at p99 ([benchmarks](https://www.kernel.sh/benchmarks)), so you can create one per task instead of keeping a warm pool alive to hide start-up time.
17+
- **code on the vm is safe to hand an agent.** every browser is its own vm, isolated at the hypervisor rather than sharing a host kernel with other tenants, so the [browser repl](/browsers/repl), [process execution](/browsers/process-execution), and root access over [ssh](/browsers/ssh) stay contained to that session.
18+
- **idle browsers go into standby.** five seconds after the last client disconnects, a browser enters [standby](/browsers/standby): it keeps its state and stops accruing usage cost until a client reconnects.
19+
20+
## open source
21+
22+
we value open source and transparency, so we publish the browser image and the vm runtime behind KERNEL browsers on github. you can read exactly what runs your agent's browser, run it yourself, or contribute.
23+
24+
<Columns className="responsive-columns" cols={3}>
25+
<Card title="kernel-images" icon="github" href="https://github.com/kernel/kernel-images">
26+
the chromium images behind KERNEL browsers.
1627
</Card>
17-
<Card title="Stealth Mode" img="/images/stealth.svg" href="/browsers/bot-detection/overview">
18-
We solve CAPTCHAs and manage residential proxies to help you see fewer of them.
28+
<Card title="hypeman" icon="github" href="https://github.com/kernel/hypeman">
29+
the vm runtime we built to run browsers.
1930
</Card>
20-
<Card title="o11y" img="/images/o11y.svg" href="/introduction/observe">
21-
You can view sessions live and record them as MP4s for debugging.
31+
<Card title="cloud-hypervisor" icon="github" href="https://github.com/kernel/cloud-hypervisor">
32+
our fork of the cloud hypervisor virtual machine monitor.
2233
</Card>
2334
</Columns>
2435

25-
## start here
36+
<span id="start-here" />
37+
<span id="prod-setup" />
38+
<span id="scaling" />
39+
## get started
2640

27-
<Columns cols={3}>
28-
<Card title="Create" href="/introduction/create">
29-
Spin up a browser and pick the shape — headless, stealth, GPU, profiles.
41+
<Columns className="responsive-columns" cols={3}>
42+
<Card title="see all features" img="/images/chromium.svg" href="/overview/products">
43+
browsers, stealth, proxies, auth, payments, and everything else, each linking to its docs.
3044
</Card>
31-
<Card title="Control" href="/introduction/control">
32-
Drive it with computer use, playwright execution, CDP, or WebDriver BiDi.
45+
<Card title="quickstart" img="/images/overview/quickstart.svg" href="/start/quickstart">
46+
hand setup to your coding agent with one prompt, or create your first browser yourself.
3347
</Card>
34-
<Card title="Observe" href="/introduction/observe">
35-
Watch it live, record replays, and capture screenshots.
48+
<Card title="cookbooks" img="/images/overview/cookbooks.svg" href="/cookbooks">
49+
end-to-end recipes you can clone and run, from computer use fallbacks to agentic payments.
3650
</Card>
3751
</Columns>
38-
39-
import { CopyPromptButton } from '/snippets/copy-prompt-button.jsx';
40-
41-
<div className="tinker-box">
42-
<h3 style={{ margin: 0, fontSize: '1.5rem', fontWeight: 600 }}>fast setup</h3>
43-
<div className="tinker-box-row">
44-
<div style={{ flexShrink: 0 }}>
45-
<img src="/images/tinker-bot.svg" alt="" className="block dark:hidden" style={{ width: '146px', height: 'auto' }} />
46-
<img src="/images/tinker-bot-dark.svg" alt="" className="hidden dark:block" style={{ width: '146px', height: 'auto' }} />
47-
</div>
48-
<div className="tinker-box-content">
49-
<p style={{ margin: 0, fontSize: '0.9375rem', lineHeight: 1.6, opacity: 0.8 }}>
50-
copy and paste this into your AI coding agent (Cursor, Claude, Windsurf, etc.). it installs the Kernel CLI and skills, authenticates you, and opens a live browser session that you or your agent can interact with.
51-
</p>
52-
<div>
53-
<CopyPromptButton />
54-
</div>
55-
</div>
56-
</div>
57-
</div>
58-
59-
## prod setup
60-
61-
Our [app platform](/apps/develop) is a serverless compute service for running agent loops triggered on demand or by scheduled events without having to provision or manage sandboxes. Your agent runs co-located with its browser to minimize network latency.
62-
63-
Scaffold a project from a template:
64-
65-
```bash
66-
kernel create --template computer-use
67-
```
68-
69-
Deploy and invoke it on demand:
70-
71-
```bash
72-
kernel deploy agent.ts
73-
kernel invoke my-agent my-task --payload '{"url": "https://example.com"}'
74-
```
75-
76-
### scaling
77-
78-
[browser pools](/browsers/pools) keep browsers ready to use and pre-configured, so you skip start-up latency on every task and idle browsers aren't billed. reach for them once you're running the same workload repeatedly, need low-latency acquisition, or are scaling steady, high-frequency traffic — on-demand `browsers.create()` stays the right call for occasional, bursty, or one-off work.

‎integrations/overview.mdx‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ mode: "wide"
77

88
Kernel browsers work with any tool that speaks the Chrome DevTools Protocol or WebDriver BiDi. The guides below cover the integrations with first-class support. For anything else, see [how you drive the browser](/introduction/control). For every integration from one vendor on one page, see [Claude](/integrations/claude/overview) and [Vercel](/integrations/vercel/overview).
99

10+
Sections follow the pieces of a browser agent described in [important concepts](/overview/concepts).
11+
1012
<span id="popular-framework-integrations" />
1113
<span id="custom-integrations" />
1214
<span id="universal-cdp-compatibility" />

0 commit comments

Comments
 (0)