Basics (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'.

The Actor API (Page, Element, Mouse) is removed in browser-use 1.0: the agent drives the page with Python and raw CDP itself. For scripted steps in 1.0, use Playwright on the agent’s browser: Combine with Playwright.

Core Architecture

Core Classes

Browser (alias: BrowserSession): Main session manager
Page: Represents a browser tab/iframe
Element: Individual DOM element operations
Mouse: Coordinate-based mouse operations

Basic Usage

from browser_use import Browser, Agent
from browser_use.llm.openai.chat import ChatOpenAI

async def main():
    llm = ChatOpenAI(api_key="your-api-key")
    browser = Browser()
    await browser.start()

    # 1. Actor: Precise navigation and element interactions
    page = await browser.new_page("https://github.com/login")
    email_input = await page.must_get_element_by_prompt("username field", llm=llm)
    await email_input.fill("your-username")

    # 2. Agent: AI-driven complex tasks
    agent = Agent(browser=browser, llm=llm)
    await agent.run("Complete login and navigate to my repositories")

    await browser.stop()

Important Notes

Not Playwright: Actor is built on CDP, not Playwright. The API resembles Playwright as much as possible for easy migration, but is a subset.
Immediate Returns: get_elements_by_css_selector() doesn’t wait for visibility
Manual Timing: You handle navigation timing and waiting
JavaScript Format: evaluate() requires arrow function format: () => {}

⌘I

Get Started

Core

Safety

Features

Integrations

Reference

Core Architecture

Core Classes

Basic Usage

Important Notes

​Core Architecture

​Core Classes

​Basic Usage

​Important Notes

Core Architecture

Core Classes

Basic Usage

Important Notes