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.

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.

1. Install the Kernel SDK

uv add kernel

2. Initialize Kernel and create a browser

Import the libraries and create a cloud browser session:

from kernel import Kernel
from browser_use import Browser, Agent

# Initialize Kernel client
kernel = Kernel()

# Create a Kernel browser session
kernel_browser = kernel.browsers.create()

3. Update your Browser definition

Replace your existing Browser initialization to use Kernel's CDP URL and display settings:

# Update your Browser definition to use Kernel's CDP URL
browser = Browser(
    cdp_url=kernel_browser.cdp_ws_url,
    headless=False,
    window_size={'width': 1920, 'height': 1080},
    viewport={'width': 1920, 'height': 1080},
    device_scale_factor=1.0
)

Browser Use supports a wide range of browser configuration parameters. See the full list in the Browser Use docs. When running on Kernel, remember that browsers must use one of Kernel's supported viewport sizes and refresh rates. See Viewports for the supported configurations.

4. Create and run your agent

Use your existing Agent setup with the Kernel-powered browser:

# Use with your existing Agent setup
agent = Agent(
    task="Your automation task",
    llm=your_llm_instance,
    browser_session=browser
)

# Run your automation
result = agent.run()

# Clean up
kernel.browsers.delete_by_id(kernel_browser.session_id)

If you're using Browser Use versions < 0.7.9, you may need to use a custom resize class to correct viewport sizing for the browser session. Here's how to use it:

agent = Agent(
    task="Your automation task",
    llm=your_llm_instance,
    browser_session=BrowserSessionCustomResize(cdp_url=kernel_browser.cdp_ws_url)
)

Quick setup with our Browser Use example app

Alternatively, you can use our Kernel app template that includes a pre-configured Browser Use integration:

kernel create --name my-browser-use-app --language python --template browser-use

Then follow the deploy and invoke guides to deploy and run your Browser Use automation on Kernel's infrastructure.

Benefits of using Kernel with Browser Use

No local browser management: Run automations without installing or maintaining browsers locally
Scalability: Launch multiple browser sessions in parallel
Stealth mode: Built-in anti-detection features for web scraping
Session state: Maintain browser state across runs via Profiles
Live view: Debug your automations with real-time browser viewing

Next steps

Check out live view for debugging your automations
Learn about stealth mode for avoiding detection
Learn how to properly terminate browser sessions
Learn how to deploy your Browser Use app to Kernel

On this page