Quickstart (0.x)

This page is for browser-use 0.x. Current docs: Introduction. Upgrading: Migrating to 1.0. To stay on 0.x, pin it: pip install 'browser-use<1'.

@sandbox is removed in browser-use 1.0. In 1.0, run the agent anywhere with a cloud browser (Browser(), the default; see Browsers), or have Browser Use host the whole agent with the Cloud API.

Sandboxes are the easiest way to run Browser-Use in production. We handle agents, browsers, persistence, auth, cookies, and LLMs. It is also the fastest way to deploy - the agent runs right next to the browser, so latency is minimal.

Get your API key at cloud.browser-use.com/new-api-key — eligible new accounts receive $1 in one-time credits.

Basic Example

Wrap your function with @sandbox():

from browser_use import Browser, sandbox, ChatBrowserUse
from browser_use.agent.service import Agent

@sandbox()
async def my_task(browser: Browser):
    agent = Agent(task="Find the top HN post", browser=browser, llm=ChatBrowserUse())
    await agent.run()

await my_task()

With Cloud Parameters

@sandbox(
    cloud_profile_id='your-profile-id',      # Use saved cookies/auth
    cloud_proxy_country_code='us',           # Bypass captchas, cloudflare, geo-restrictions
    cloud_timeout=60,                        # Max session time (minutes)
)
async def task(browser: Browser, url: str):
    agent = Agent(task=f"Visit {url}", browser=browser, llm=ChatBrowserUse())
    await agent.run()

await task(url="https://example.com")

What each does:

cloud_profile_id - Use saved cookies/authentication from your cloud profile
cloud_proxy_country_code - Route through country-specific proxy for stealth (bypass captchas, Cloudflare, geo-blocks)
cloud_timeout - Maximum time browser stays open in minutes

For more parameters and events, see the other tabs in this section.

⌘I

Get Started

Core

Safety

Features

Integrations

Reference

Basic Example

With Cloud Parameters

​Basic Example

​With Cloud Parameters

Basic Example

With Cloud Parameters