Skip to content

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

Browser import works

Magnus Müller505a103aa3de
diff --git a/browser_use/__init__.py b/browser_use/__init__.py
index 2a3c6dbac..9bc489531 100644
--- a/browser_use/__init__.py
+++ b/browser_use/__init__.py
@@ -49,6 +49,7 @@ if TYPE_CHECKING:
from browser_use.agent.service import Agent
from browser_use.agent.views import ActionModel, ActionResult, AgentHistoryList
from browser_use.browser import BrowserProfile, BrowserSession
+ from browser_use.browser import BrowserSession as Browser
from browser_use.controller.service import Controller
from browser_use.dom.service import DomService
from browser_use.llm.anthropic.chat import ChatAnthropic
@@ -71,6 +72,7 @@ _LAZY_IMPORTS = {
'AgentHistoryList': ('browser_use.agent.views', 'AgentHistoryList'),
# Browser components (heavy due to playwright/patchright)
'BrowserSession': ('browser_use.browser', 'BrowserSession'),
+ 'Browser': ('browser_use.browser', 'BrowserSession'), # Alias for BrowserSession
'BrowserProfile': ('browser_use.browser', 'BrowserProfile'),
# Controller (moderate weight)
'Controller': ('browser_use.controller.service', 'Controller'),
@@ -107,6 +109,7 @@ def __getattr__(name: str):
__all__ = [
'Agent',
'BrowserSession',
+ 'Browser', # Alias for BrowserSession
'BrowserProfile',
'Controller',
'DomService',
diff --git a/browser_use/browser/__init__.py b/browser_use/browser/__init__.py
index 48d852010..4ef9bf93b 100644
--- a/browser_use/browser/__init__.py
+++ b/browser_use/browser/__init__.py
@@ -5,6 +5,7 @@ if TYPE_CHECKING:
from .profile import BrowserProfile, ProxySettings
from .session import BrowserSession
+
# Lazy imports mapping for heavy browser components
_LAZY_IMPORTS = {
'ProxySettings': ('.profile', 'ProxySettings'),
diff --git a/browser_use/browser/session.py b/browser_use/browser/session.py
index 6f022c90c..6c7c9858e 100644
--- a/browser_use/browser/session.py
+++ b/browser_use/browser/session.py
@@ -2081,29 +2081,3 @@ class BrowserSession(BaseModel):
self.logger.debug(f'Failed to get CDP client for target {node.target_id}: {e}, using main session')
return await self.get_or_create_cdp_session()
-
-
-# # Fix Pydantic circular dependency for all watchdogs
-# # This must be called after BrowserSession class is fully defined
-# _watchdog_modules = [
-# 'browser_use.browser.crash_watchdog.CrashWatchdog',
-# 'browser_use.browser.downloads_watchdog.DownloadsWatchdog',
-# 'browser_use.browser.local_browser_watchdog.LocalBrowserWatchdog',
-# 'browser_use.browser.storage_state_watchdog.StorageStateWatchdog',
-# 'browser_use.browser.security_watchdog.SecurityWatchdog',
-# 'browser_use.browser.aboutblank_watchdog.AboutBlankWatchdog',
-# 'browser_use.browser.popups_watchdog.PopupsWatchdog',
-# 'browser_use.browser.permissions_watchdog.PermissionsWatchdog',
-# 'browser_use.browser.default_action_watchdog.DefaultActionWatchdog',
-# 'browser_use.browser.dom_watchdog.DOMWatchdog',
-# 'browser_use.browser.screenshot_watchdog.ScreenshotWatchdog',
-# ]
-
-# for module_path in _watchdog_modules:
-# try:
-# module_name, class_name = module_path.rsplit('.', 1)
-# module = __import__(module_name, fromlist=[class_name])
-# watchdog_class = getattr(module, class_name)
-# watchdog_class.model_rebuild()
-# except Exception:
-# pass # Ignore if watchdog can't be imported or rebuilt
diff --git a/docs/customize/browser-basic.mdx b/docs/customize/browser-basic.mdx
index d87aae556..f279ca91f 100644
--- a/docs/customize/browser-basic.mdx
+++ b/docs/customize/browser-basic.mdx
@@ -1,148 +1,28 @@
---
title: "Browser Quickstart"
-description: "Get started with Browser Use browser management - launch browsers and configure basic settings"
+description: ""
icon: "globe"
-mode: "wide"
---
-Browser Use manages real browsers for your AI agents using either local browser instances or remote connections. This guide shows you how to get started with browser configuration.
---
-## Quick Start
-
-The simplest way to start is with a basic `BrowserSession`:
-
-```python
-from browser_use import Agent, BrowserSession
-
-# Simple local browser (headless by default if no display)
-session = BrowserSession()
-agent = Agent(task="Search for Browser Use on Google", browser_session=session)
-await agent.run()
-```
-
-## Basic Configuration
-
-Pass configuration directly to `BrowserSession`:
-
```python
-from browser_use import BrowserSession, Agent
+from browser_use import Agent, Browser, ChatOpenAI
-session = BrowserSession(
- headless=False, # Show browser window
- user_data_dir="./my-profile", # Persistent profile
- viewport={'width': 1280, 'height': 1100}
+# Browser is an alias for BrowserSession - use whichever you prefer
+session = Browser(
+ headless=False, # Show browser window
+ window_size={'width': 1000, 'height': 700}, # Set window size
)
-agent = Agent(task="Fill out the form", browser_session=session)
-await agent.run()
-```
-
-## Using Browser Profiles
-
-For reusable configurations, use `BrowserProfile`:
-
-```python
-from browser_use.browser import BrowserProfile, BrowserSession
-
-# Create a reusable profile
-profile = BrowserProfile(
- headless=False,
- user_data_dir="./chrome-profile",
- stealth=True,
- viewport={'width': 1920, 'height': 1080},
- allowed_domains=['*.example.com']
+agent = Agent(
+ task='Search for Browser Use',
+ browser_session=session,
+ llm=ChatOpenAI(model='gpt-4.1-mini'),
)
-# Use the profile for multiple sessions
-session1 = BrowserSession(browser_profile=profile)
-session2 = BrowserSession(browser_profile=profile, headless=True) # Override specific settings
-```
-
-## Session vs Profile
-- **`BrowserSession`**: Manages the active browser connection and runtime state
-- **`BrowserProfile`**: Reusable configuration template for browser settings
-
-```python
-# Direct configuration
-session = BrowserSession(headless=True, stealth=False)
-
-# Using profile with overrides
-profile = BrowserProfile(headless=False, stealth=True)
-session = BrowserSession(browser_profile=profile, headless=True) # headless=True overrides profile
+async def main():
+ await agent.run()
```
-
-## Essential Settings
-
-### Display Mode
-```python
-session = BrowserSession(
- headless=False, # Show browser window
- window_size={'width': 1920, 'height': 1080}
-)
-```
-
-### User Data Directory
-```python
-session = BrowserSession(
- user_data_dir="./my-profile", # Persistent browser profile
- # user_data_dir=None, # Incognito/temporary profile
-)
-```
-
-### Stealth Mode
-```python
-session = BrowserSession(
- stealth=True, # Use stealth techniques to avoid detection
-)
-```
-
-### Domain Restrictions
-```python
-session = BrowserSession(
- allowed_domains=['*.google.com', 'https://docs.google.com'], # Restrict navigation
-)
-```
-
-## Common Patterns
-
-### Development Setup
-```python
-# Best for development - visible browser with dev tools
-dev_session = BrowserSession(
- headless=False,
- devtools=True,
- user_data_dir="./dev-profile"
-)
-```
-
-### Production Setup
-```python
-# Best for production - headless with stealth
-prod_session = BrowserSession(
- headless=True,
- stealth=True,
- user_data_dir=None, # Don't persist data
- viewport={'width': 1920, 'height': 1080}
-)
-```
-
-### Authenticated Sessions
-```python
-# Reuse login sessions
-auth_session = BrowserSession(
- user_data_dir="./auth-profile",
- storage_state="./cookies.json", # Load saved authentication
- keep_alive=True # Keep browser open after task
-)
-```
-
-## Next Steps
-
-- Learn about [browser parameters](/customize/browser-parameters) for advanced configuration
-- Set up [real browser connections](/customize/browser-real-browser) for existing browsers
-- Configure [remote browser connections](/customize/browser-remote) for cloud setups
-
----
diff --git a/docs/customize/browser-keep-open.mdx b/docs/customize/browser-keep-open.mdx
new file mode 100644
index 000000000..51e231611
--- /dev/null
+++ b/docs/customize/browser-keep-open.mdx
@@ -0,0 +1,33 @@
+---
+title: "Chain Agents in one browser"
+description: ""
+icon: "window-restore"
+mode: "wide"
+---
+
+```python
+from browser_use import Agent, Browser
+
+# Create browser and keep it alive
+browser = Browser(
+ headless=False,
+ keep_alive=True, # Don't close browser after each agent
+)
+
+
+async def main():
+ # Run multiple agents with the same browser
+ agent1 = Agent(task='Search for Browser Use', browser_session=browser)
+ await agent1.run()
+
+ agent2 = Agent(task='Click on the first link', browser_session=browser)
+ await agent2.run()
+
+ agent3 = Agent(task='Find the social media page', browser_session=browser)
+ await agent3.run()
+
+ # Close browser when completely done
+ await browser.stop()
+
+```
+
diff --git a/docs/customize/browser-parameters.mdx b/docs/customize/browser-parameters.mdx
index 985064856..cfe4d24af 100644
--- a/docs/customize/browser-parameters.mdx
+++ b/docs/customize/browser-parameters.mdx
@@ -1,517 +1,84 @@
---
-title: "Browser Parameters"
-description: "Complete reference for all Browser Use browser configuration parameters"
+title: "All Parameters"
+description: "Complete reference for all browser configuration options"
icon: "sliders"
mode: "wide"
---
-Complete reference for configuring browsers in Browser Use. All parameters can be passed to `BrowserSession(...)` directly or stored in a `BrowserProfile(...)` template.
-
----
-
-## Session vs Profile Parameters
-
-### Session-Specific (BrowserSession only)
-These parameters control the browser connection and cannot be stored in a `BrowserProfile`:
-
-- `id` - Session identifier
-- `browser_profile` - BrowserProfile template to use
-
-### Shared Parameters
-All other parameters can be used in both `BrowserSession(...)` and `BrowserProfile(...)`.
-
----
-
-## Browser-Use Specific Parameters
-
-Enhanced functionality provided by Browser Use on top of standard browser features.
-
-### `stealth`
-```python
-stealth: bool = False
-```
-Use stealth techniques to avoid bot detection. Uses advanced browser fingerprint masking.
-
-### `disable_security`
-```python
-disable_security: bool = False
-```
-<Warning>⚠️ NOT RECOMMENDED. Disables all browser security features - only use for debugging isolated environments.</Warning>
-
-### `deterministic_rendering`
-```python
-deterministic_rendering: bool = False
-```
-<Warning>⚠️ NOT RECOMMENDED. Forces consistent rendering across OS platforms but reduces performance and increases bot detection risk.</Warning>
-
-### `allowed_domains`
-```python
-allowed_domains: list[str] | None = None
-```
-Restrict agent navigation to specific domains. Supports glob patterns:
-- `['example.com']` - Only https://example.com/*
-- `['*.example.com']` - All subdomains of example.com
-- `['https://docs.example.com', '*.api.example.com']` - Mixed patterns
-
-```python
-session = BrowserSession(
- allowed_domains=['*.google.com', 'https://stackoverflow.com']
-)
-```
-
-### `keep_alive`
-```python
-keep_alive: bool | None = None
-```
-Keep browser running after agent completes. Default behavior:
-- `None` - Close browser if launched by Browser Use, keep open if connected to existing
-- `True` - Always keep browser running
-- `False` - Always close browser
-
-### `enable_default_extensions`
-```python
-enable_default_extensions: bool = True
-```
-Load automation-optimized extensions:
-- uBlock Origin (ad blocking)
-- I still don't care about cookies (cookie handling)
-- ClearURLs (URL cleaning)
-
-### `cross_origin_iframes`
-```python
-cross_origin_iframes: bool = False
-```
-Enable cross-origin iframe support. When False (default), only same-origin frames are processed to avoid complexity.
-
----
-
-## Connection Parameters
-
-### `cdp_url`
-```python
-cdp_url: str | None = None
-```
-CDP URL for connecting to existing browser instance (e.g., `http://localhost:9222`).
-
-### `is_local`
-```python
-is_local: bool = True
-```
-Whether this is a local browser instance. Set to `False` when connecting to remote browsers.
-
----
-
-## Display & Viewport
-
-### `headless`
-```python
-headless: bool | None = None
-```
-Run browser without visible UI. If `None`, auto-detects based on display availability.
-
-### `window_size`
-```python
-window_size: dict | None = None
-```
-Browser window size for headful mode:
-```python
-window_size={'width': 1920, 'height': 1080}
-```
-
-### `window_position`
-```python
-window_position: dict | None = {'width': 0, 'height': 0}
-```
-Window position from top-left corner:
-```python
-window_position={'width': 100, 'height': 50}
-```
-
-### `viewport`
-```python
-viewport: dict | None = None
-```
-Content area size (used in headless mode):
-```python
-viewport={'width': 1280, 'height': 720}
-```
-
-### `no_viewport`
-```python
-no_viewport: bool | None = None
-```
-Disable fixed viewport - content resizes with window. Auto-configured based on `headless` setting.
-
-### `device_scale_factor`
-```python
-device_scale_factor: float | None = None
-```
-Device scale factor (DPI). Useful for high-resolution screenshots (set to 2 or 3).
-
-### `screen`
-```python
-screen: dict | None = None
-```
-Screen size available to browser. Auto-detected if not specified.
-
----
-
-## Browser Launch Options
-
-### `executable_path`
-```python
-executable_path: str | Path | None = None
-```
-Path to browser executable for custom installations.
-
-### `channel`
-```python
-channel: BrowserChannel | None = None
-```
-Browser channel: `'chromium'`, `'chrome'`, `'chrome-beta'`, `'chrome-dev'`, `'chrome-canary'`, `'msedge'`, etc.
-
-### `args`
-```python
-args: list[str] = []
-```
-Additional command-line arguments for the browser. See [Chrome command line switches](https://peter.sh/experiments/chromium-command-line-switches/).
-
-### `ignore_default_args`
-```python
-ignore_default_args: list[str] | Literal[True] = [...]
-```
-Default CLI args to exclude. Set to `True` to disable all defaults (not recommended).
-
-### `env`
-```python
-env: dict[str, str | float | bool] | None = None
-```
-Environment variables for browser process:
-```python
-env={'DISPLAY': ':1'} # Use specific X11 display
-```
-
-### `chromium_sandbox`
-```python
-chromium_sandbox: bool = True # False in Docker
-```
-Enable Chromium sandboxing. Automatically disabled in Docker environments.
-
-### `devtools`
-```python
-devtools: bool = False
-```
-Open DevTools panel automatically (requires `headless=False`).
-
----
-
-## User Data & Profiles
-
-### `user_data_dir`
-```python
-user_data_dir: str | Path | None = '~/.config/browseruse/profiles/default'
-```
-Directory for browser profile data. Set to `None` for incognito/temporary profile.
-
-<Warning>
-Multiple browsers cannot share the same `user_data_dir` simultaneously. Use unique directories or `None` for parallel browsers.
-</Warning>
-
-### `profile_directory`
-```python
-profile_directory: str = 'Default'
-```
-Chrome profile subdirectory name (e.g., `'Default'`, `'Profile 1'`, `'Work'`).
-
-### `storage_state`
-```python
-storage_state: str | Path | dict[str, Any] | None = None
-```
-Browser storage state (cookies, localStorage). Can be file path or dict:
-
-```python
-# From file
-storage_state='./auth.json'
-
-# From dict
-storage_state={
- 'cookies': [...],
- 'origins': [...]
-}
-```
-
----
-
-## Network & Security
-
-### `proxy`
-```python
-proxy: ProxySettings | None = None
-```
-Proxy configuration:
-```python
-from browser_use.browser.profile import ProxySettings
-
-proxy=ProxySettings(
- server="http://proxy.com:8080",
- username="user",
- password="pass",
- bypass="localhost,127.0.0.1"
-)
-```
-
-### `permissions`
-```python
-permissions: list[str] = ['clipboardReadWrite', 'notifications']
-```
-Browser permissions to grant. Default includes clipboard access and notifications.
-
-### `bypass_csp`
-```python
-bypass_csp: bool = False
-```
-<Warning>⚠️ Increases security risk and bot fingerprinting. Only use when necessary for specific CSP-restricted sites.</Warning>
-
-### `ignore_https_errors`
-```python
-ignore_https_errors: bool = False
-```
-Ignore HTTPS certificate errors.
-
-### `java_script_enabled`
-```python
-java_script_enabled: bool = True
-```
-<Warning>⚠️ Not recommended. Disabling JavaScript will break most modern websites and Browser Use functionality.</Warning>
-
-### `extra_http_headers`
-```python
-extra_http_headers: dict[str, str] = {}
-```
-Additional HTTP headers sent with every request:
-```python
-extra_http_headers={'User-Agent': 'Custom Agent'}
-```
-
----
-
-## Page Behavior & Timing
-
-### `default_timeout`
-```python
-default_timeout: float | None = None
-```
-Default timeout for browser operations in milliseconds:
-```python
-default_timeout=30000 # 30 seconds
-```
-
-### `default_navigation_timeout`
-```python
-default_navigation_timeout: float | None = None
-```
-Default timeout for page navigation in milliseconds.
-
-### `minimum_wait_page_load_time`
-```python
-minimum_wait_page_load_time: float = 0.25
-```
-Minimum time to wait before capturing page state for AI analysis.
-
-### `wait_for_network_idle_page_load_time`
-```python
-wait_for_network_idle_page_load_time: float = 0.5
-```
-Time to wait for network activity to cease. Increase to 3-5s for slower websites.
-
-### `maximum_wait_page_load_time`
-```python
-maximum_wait_page_load_time: float = 5.0
-```
-Maximum time to wait for page load before proceeding.
-
-### `wait_between_actions`
-```python
-wait_between_actions: float = 0.5
-```
-Time to wait between agent actions.
-
-### `slow_mo`
-```python
-slow_mo: float = 0.0
-```
-Slow down actions by this many milliseconds.
-
----
-
-## AI Integration
-
-### `highlight_elements`
-```python
-highlight_elements: bool = True
-```
-Highlight interactive elements with colored bounding boxes for AI vision.
-
-### `viewport_expansion`
-```python
-viewport_expansion: int = 500
-```
-Viewport expansion in pixels for AI context:
-- `-1` - Include entire page (highest token usage)
-- `0` - Only visible viewport
-- `500` - Viewport + 500px in each direction (balanced)
-
-### `include_dynamic_attributes`
-```python
-include_dynamic_attributes: bool = True
-```
-Include dynamic attributes in selectors for better element targeting.
-
----
-
-## Downloads & Files
-
-### `accept_downloads`
-```python
-accept_downloads: bool = True
-```
-Automatically accept all downloads.
-
-### `downloads_path`
-```python
-downloads_path: str | Path | None = None
-```
-Directory for downloaded files. Auto-created if not specified.
-
-### `auto_download_pdfs`
-```python
-auto_download_pdfs: bool = True
-```
-Automatically download PDFs when navigating to PDF viewer pages.
-
----
-
-## Device Emulation
-
-### `user_agent`
-```python
-user_agent: str | None = None
-```
-Custom user agent string:
-```python
-user_agent="Mozilla/5.0 (iPhone; CPU iPhone OS 13_0 like Mac OS X)"
-```
-
-### `is_mobile`
-```python
-is_mobile: bool = False
-```
-Enable mobile viewport meta tag handling and touch events.
-
-### `has_touch`
-```python
-has_touch: bool = False
-```
-Enable touch event support.
-
-### `locale`
-```python
-locale: str | None = None
-```
-User locale (e.g., `'en-GB'`, `'de-DE'`). Affects `navigator.language` and formatting.
-
-### `timezone_id`
-```python
-timezone_id: str | None = None
-```
-Timezone identifier:
-```python
-timezone_id='America/New_York' # or 'UTC'
-```
-
-### `color_scheme`
-```python
-color_scheme: ColorScheme = 'light'
-```
-Preferred color scheme: `'light'`, `'dark'`, `'no-preference'`
-
----
-
-## Recording Options
-
-### `record_video_dir`
-```python
-record_video_dir: str | Path | None = None
-```
-Directory to save video recordings as `.webm` files.
-
-### `record_video_size`
-```python
-record_video_size: dict | None = None
-```
-Video recording dimensions:
-```python
-record_video_size={'width': 1280, 'height': 720}
-```
-
-### `record_har_path`
-```python
-record_har_path: str | Path | None = None
-```
-Path to save network trace files as `.har` format.
-
-### `traces_dir`
-```python
-traces_dir: str | Path | None = None
-```
-Directory to save complete trace files including screenshots, DOM snapshots, and network traces.
-
----
-
-## Complete Example
-
-```python
-from browser_use.browser import BrowserProfile, BrowserSession
-from browser_use.browser.profile import ProxySettings
-
-# Comprehensive configuration example
-profile = BrowserProfile(
- # Display
- headless=False,
- window_size={'width': 1920, 'height': 1080},
- viewport={'width': 1280, 'height': 720},
-
- # Browser
- stealth=True,
- executable_path="/opt/chrome/chrome",
- user_data_dir="./work-profile",
-
- # Network
- proxy=ProxySettings(server="http://proxy:8080"),
- allowed_domains=['*.company.com', 'https://trusted.com'],
-
- # Timing
- wait_between_actions=1.0,
- default_timeout=30000,
-
- # AI Integration
- highlight_elements=True,
- viewport_expansion=500,
-
- # Downloads
- downloads_path="./downloads",
- auto_download_pdfs=True,
-
- # Recording
- record_video_dir="./recordings"
-)
-
-# Use profile with session-specific overrides
-session = BrowserSession(
- browser_profile=profile,
- headless=True, # Override profile setting
- cdp_url="http://remote:9222" # Session-specific connection
-)
-```
-
----
+## Available Parameters
+
+### Core Settings
+- `cdp_url`: CDP URL for connecting to existing browser instance (e.g., `http://localhost:9222`)
+- `is_local` (default: `True`): Whether this is a local browser instance. Set to `False` for remote browsers
+- `browser_profile`: BrowserProfile template for reusable configuration
+
+### Display & Appearance
+- `headless` (default: `None`): Run browser without UI. Auto-detects based on display availability
+- `window_size`: Browser window size for headful mode (e.g., `{'width': 1920, 'height': 1080}`)
+- `window_position` (default: `{'width': 0, 'height': 0}`): Window position from top-left corner
+- `viewport`: Content area size (e.g., `{'width': 1280, 'height': 720}`)
+- `device_scale_factor`: Device scale factor (DPI). Set to 2 or 3 for high-resolution screenshots
+
+### Browser Behavior
+- `stealth` (default: `False`): Use stealth techniques to avoid bot detection
+- `keep_alive` (default: `None`): Keep browser running after agent completes
+- `allowed_domains`: Restrict navigation to specific domains (e.g., `['*.google.com']`)
+- `enable_default_extensions` (default: `True`): Load automation extensions (uBlock, cookie handlers)
+
+### User Data & Profiles
+- `user_data_dir` (default: `'~/.config/browseruse/profiles/default'`): Directory for browser profile data. Set to `None` for incognito
+- `profile_directory` (default: `'Default'`): Chrome profile subdirectory name
+- `storage_state`: Browser storage state (cookies, localStorage). Can be file path or dict
+
+### Network & Security
+- `proxy`: Proxy configuration using `ProxySettings(server, username, password, bypass)`
+- `permissions` (default: `['clipboardReadWrite', 'notifications']`): Browser permissions to grant
+- `bypass_csp` (default: `False`): Bypass Content Security Policy (increases bot detection risk)
+- `ignore_https_errors` (default: `False`): Ignore HTTPS certificate errors
+- `extra_http_headers`: Additional HTTP headers sent with every request
+
+### Browser Launch
+- `executable_path`: Path to browser executable for custom installations
+- `channel`: Browser channel (`'chromium'`, `'chrome'`, `'chrome-beta'`, `'msedge'`, etc.)
+- `args`: Additional command-line arguments for the browser
+- `env`: Environment variables for browser process
+- `chromium_sandbox` (default: `True`): Enable Chromium sandboxing (auto-disabled in Docker)
+- `devtools` (default: `False`): Open DevTools panel automatically (requires `headless=False`)
+
+### Timing & Performance
+- `default_timeout`: Default timeout for browser operations in milliseconds
+- `default_navigation_timeout`: Default timeout for page navigation
+- `minimum_wait_page_load_time` (default: `0.25`): Minimum time to wait before capturing page state
+- `wait_for_network_idle_page_load_time` (default: `0.5`): Time to wait for network activity to cease
+- `maximum_wait_page_load_time` (default: `5.0`): Maximum time to wait for page load
+- `wait_between_actions` (default: `0.5`): Time to wait between agent actions
+- `slow_mo` (default: `0.0`): Slow down actions by this many milliseconds
+
+### AI Integration
+- `highlight_elements` (default: `True`): Highlight interactive elements for AI vision
+- `viewport_expansion` (default: `500`): Viewport expansion in pixels for AI context
+- `include_dynamic_attributes` (default: `True`): Include dynamic attributes in selectors
+
+### Downloads & Files
+- `accept_downloads` (default: `True`): Automatically accept all downloads
+- `downloads_path`: Directory for downloaded files
+- `auto_download_pdfs` (default: `True`): Automatically download PDFs
+
+### Device Emulation
+- `user_agent`: Custom user agent string
+- `is_mobile` (default: `False`): Enable mobile viewport and touch events
+- `locale`: User locale (e.g., `'en-GB'`, `'de-DE'`)
+- `timezone_id`: Timezone identifier (e.g., `'America/New_York'`, `'UTC'`)
+- `color_scheme` (default: `'light'`): Preferred color scheme (`'light'`, `'dark'`, `'no-preference'`)
+
+### Recording
+- `record_video_dir`: Directory to save video recordings as `.webm` files
+- `record_har_path`: Path to save network trace files as `.har` format
+- `traces_dir`: Directory to save complete trace files
+
+### Advanced Options
+- `disable_security` (default: `False`): ⚠️ NOT RECOMMENDED. Disables all browser security features
+- `deterministic_rendering` (default: `False`): ⚠️ NOT RECOMMENDED. Forces consistent rendering but reduces performance
+- `cross_origin_iframes` (default: `False`): Enable cross-origin iframe support
+
+---
\ No newline at end of file
diff --git a/docs/docs.json b/docs/docs.json
index 74eb6653b..376222100 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -55,6 +55,7 @@
"isDefaultOpen": false,
"pages": [
"customize/browser-basic",
+ "customize/browser-keep-open",
"customize/browser-real-browser",
"customize/browser-remote",
"customize/browser-parameters"