Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

BrowserSession -> Browser

Gregor Žuniče1c418179d09
diff --git a/browser_use/actor/README.md b/browser_use/actor/README.md
index 327cae3d7..b30c94bd1 100644
--- a/browser_use/actor/README.md
+++ b/browser_use/actor/README.md
@@ -4,7 +4,7 @@ Browser Actor is a web automation library built on CDP (Chrome DevTools Protocol
## Usage
-### Integrated with BrowserSession (Recommended)
+### Integrated with Browser (Recommended)
```python
from browser_use import Browser # Alias for BrowserSession
diff --git a/docs/customize/actor/basics.mdx b/docs/customize/actor/basics.mdx
index 616409061..cb8069897 100644
--- a/docs/customize/actor/basics.mdx
+++ b/docs/customize/actor/basics.mdx
@@ -9,7 +9,7 @@ mode: "wide"
```mermaid
graph TD
- A[BrowserSession] --> B[Page]
+ A[Browser] --> B[Page]
B --> C[Element]
B --> D[Mouse]
B --> E[AI Features]
@@ -20,7 +20,7 @@ graph TD
### Core Classes
-- **BrowserSession** (alias: **Browser**): Main session manager
+- **Browser** (alias: **BrowserSession**): Main session manager
- **Page**: Represents a browser tab/iframe
- **Element**: Individual DOM element operations
- **Mouse**: Coordinate-based mouse operations
@@ -31,20 +31,21 @@ graph TD
from browser_use import Browser, Agent
from browser_use.llm.openai import ChatOpenAI
-llm = ChatOpenAI(api_key="your-api-key")
-browser = Browser()
-await browser.start()
+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")
+ # 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")
+ # 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()
+ await browser.stop()
```
## Important Notes