Live View

Humans-in-the-loop can access the live view of Kernel browsers in real-time to resolve errors or take unscripted actions. To access the live view, visit the browser_live_view_url provided when you create a Kernel browser:

import Kernel from '@onkernel/sdk';

const kernel = new Kernel();

const browser = await kernel.browsers.create();
console.log(browser.browser_live_view_url);

from kernel import Kernel

kernel = Kernel()

browser = kernel.browsers.create()
print(browser.browser_live_view_url)

package main

import (
	"context"
	"fmt"

	"github.com/kernel/kernel-go-sdk"
)

func main() {
	ctx := context.Background()
	client := kernel.NewClient()

	browser, err := client.Browsers.New(ctx, kernel.BrowserNewParams{})
	if err != nil {
		panic(err)
	}

	fmt.Println(browser.BrowserLiveViewURL)
}

Query parameters

The browser_live_view_url supports additional query parameters to customize the live view:

readOnly (bool): when set to true, the view will be non-interactive.

Example:

https://api.onkernel.com/browser/live/<TOKEN>?readOnly=true

Embedding in an iframe

The live view URL can be embedded in an iframe to integrate the browser view into your own application or dashboard. If your environment restricts outbound traffic, allow the Live View domains and ports before you embed it.

<iframe src={browser.browser_live_view_url}></iframe>

Embedded third-party iframes like live view must have focus to receive keyboard events. On Safari, focus requires a user-initiated event — calling .focus() on the iframe element within a user-initiated event handler is recommended.To enable clipboard sharing, add allow="autoplay; clipboard-read; clipboard-write" to the iframe element.If your application uses a Content Security Policy (CSP), you must add the following directives to allow the live view iframe and its WebSocket connection. See Network access for the complete firewall and CSP requirements.

frame-src https://*.onkernel.com:8443
          https://*.kernel.sh:8443;
connect-src https://*.onkernel.com:8443
            wss://*.onkernel.com:8443
            https://*.kernel.sh:8443
            wss://*.kernel.sh:8443;

Kiosk mode

Kiosk mode provides a fullscreen live view experience without browser UI elements like the address bar and tabs. You can enable kiosk mode when creating a browser by setting the kiosk_mode parameter to true.

Kiosk mode triggers a Chromium restart, which can take several seconds. Use browser pools to access kiosk mode browsers faster.

const browser = await kernel.browsers.create({
    kiosk_mode: true
});

kernel_browser = kernel.browsers.create(
    kiosk_mode=True
)

browser, err := client.Browsers.New(ctx, kernel.BrowserNewParams{
	KioskMode: kernel.Bool(true),
})
if err != nil {
	panic(err)
}
_ = browser

URL lifetime

browser_live_view_url becomes invalid once the browser is deleted manually or via timeout.

Overview

Working with your browser

Integrations

Migrations

deploying your agent

Agent Skills

Community

Info

Query parameters

Embedding in an iframe

Kiosk mode

URL lifetime

​Query parameters

​Embedding in an iframe

​Kiosk mode

​URL lifetime

Query parameters

Embedding in an iframe

Kiosk mode

URL lifetime