Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
address cubic comments
Alezander9195f1f1f0f62
diff --git a/AGENTS.MD b/AGENTS.MDindex da2850f48..9ec04ba1d 100644--- a/AGENTS.MD+++ b/AGENTS.MD@@ -50,8 +50,7 @@ source .venv/bin/activate``````bash install browser-use & chromiumuv pip install browser-use-uvx playwright install chromium --with-deps-# Note: this does NOT install playwright, only chromium+browser-use install```</Tab><Tab title="pip">@@ -63,7 +62,7 @@ source .venv/bin/activate``````bash install browser-use & chromiumpip install browser-use-pip install playwright && playwright install chromium --with-deps+browser-use install```</Tab></Tabs>@@ -86,14 +85,14 @@ pip install playwright && playwright install chromium --with-deps<Tab title="uv">```bash install browser-use & chromium theme={null}uv pip install browser-use- uvx browser-use install+ browser-use install```</Tab><Tab title="pip">```bash install browser-use & chromium theme={null}pip install browser-use- uvx browser-use install+ browser-use install```</Tab></Tabs>@@ -224,8 +223,7 @@ source .venv/bin/activate``````bash install browser-use & chromiumuv pip install browser-use-uvx playwright install chromium --with-deps-# Note: this does NOT install playwright, only chromium+browser-use install```</Tab><Tab title="pip">@@ -237,7 +235,7 @@ source .venv/bin/activate``````bash install browser-use & chromiumpip install browser-use-pip install playwright && playwright install chromium --with-deps+browser-use install```</Tab></Tabs>diff --git a/README.md b/README.mdindex 6e40efe58..4b5f2dd63 100644--- a/README.md+++ b/README.md@@ -65,7 +65,7 @@ BROWSER_USE_API_KEY=your-key**4. Install Chromium browser:**```bash-uvx browser-use install+browser-use install```**5. Run your first agent:**diff --git a/browser_use/browser/watchdogs/local_browser_watchdog.py b/browser_use/browser/watchdogs/local_browser_watchdog.pyindex a5460345c..19306e9f4 100644--- a/browser_use/browser/watchdogs/local_browser_watchdog.py+++ b/browser_use/browser/watchdogs/local_browser_watchdog.py@@ -314,14 +314,16 @@ class LocalBrowserWatchdog(BaseWatchdog):async def _install_browser_with_playwright(self) -> str:"""Get browser executable path from playwright in a subprocess to avoid thread issues."""+ import platform++ # Build command - only use --with-deps on Linux (it fails on Windows/macOS)+ cmd = ['uvx', 'playwright', 'install', 'chrome']+ if platform.system() == 'Linux':+ cmd.append('--with-deps')# Run in subprocess with timeoutprocess = await asyncio.create_subprocess_exec(- 'uvx',- 'playwright',- 'install',- 'chrome',- '--with-deps',+ *cmd,stdout=asyncio.subprocess.PIPE,stderr=asyncio.subprocess.PIPE,)@@ -333,7 +335,7 @@ class LocalBrowserWatchdog(BaseWatchdog):if browser_path:return browser_pathself.logger.error(f'[LocalBrowserWatchdog] ❌ Playwright local browser installation error: \n{stdout}\n{stderr}')- raise RuntimeError('No local browser path found after: uvx playwright install chrome --with-deps')+ raise RuntimeError('No local browser path found after: uvx playwright install chrome')except TimeoutError:# Kill the subprocess if it times outprocess.kill()diff --git a/browser_use/cli.py b/browser_use/cli.pyindex 9cc75775d..279731bd6 100644--- a/browser_use/cli.py+++ b/browser_use/cli.py@@ -13,12 +13,19 @@ if '--mcp' in sys.argv:# Special case: install command doesn't need CLI dependenciesif len(sys.argv) > 1 and sys.argv[1] == 'install':+ import platformimport subprocessprint('📦 Installing Chromium browser + system dependencies...')print('⏳ This may take a few minutes...\n')- result = subprocess.run(['uvx', 'playwright', 'install', 'chromium', '--with-deps', '--no-shell'])+ # Build command - only use --with-deps on Linux (it fails on Windows/macOS)+ cmd = ['uvx', 'playwright', 'install', 'chromium']+ if platform.system() == 'Linux':+ cmd.append('--with-deps')+ cmd.append('--no-shell')++ result = subprocess.run(cmd)if result.returncode == 0:print('\n✅ Installation complete!')@@ -2024,12 +2031,19 @@ def auth():@main.command()def install():"""Install Chromium browser with system dependencies"""+ import platformimport subprocessprint('📦 Installing Chromium browser + system dependencies...')print('⏳ This may take a few minutes...\n')- result = subprocess.run(['uvx', 'playwright', 'install', 'chromium', '--with-deps', '--no-shell'])+ # Build command - only use --with-deps on Linux (it fails on Windows/macOS)+ cmd = ['uvx', 'playwright', 'install', 'chromium']+ if platform.system() == 'Linux':+ cmd.append('--with-deps')+ cmd.append('--no-shell')++ result = subprocess.run(cmd)if result.returncode == 0:print('\n✅ Installation complete!')diff --git a/docs/examples/apps/vibetest-use.mdx b/docs/examples/apps/vibetest-use.mdxindex dbc829af7..f826227b1 100644--- a/docs/examples/apps/vibetest-use.mdx+++ b/docs/examples/apps/vibetest-use.mdx@@ -38,7 +38,7 @@ source .venv/bin/activateuv pip install -e .# 4. Install browser runtime once-uvx browser-use install+browser-use install```### 1) Claude Codediff --git a/docs/quickstart.mdx b/docs/quickstart.mdxindex 3f02bfeaa..48731820f 100644--- a/docs/quickstart.mdx+++ b/docs/quickstart.mdx@@ -22,7 +22,7 @@ source .venv/bin/activate``````bash install browser-use & chromiumuv pip install browser-use-uvx browser-use install+browser-use install```</Tab><Tab title="pip">@@ -34,7 +34,7 @@ source .venv/bin/activate``````bash install browser-use & chromiumpip install browser-use-pip install playwright && playwright install chromium --with-deps+browser-use install```</Tab></Tabs>