Skip to content

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

address cubic comments

Alezander9195f1f1f0f62
diff --git a/AGENTS.MD b/AGENTS.MD
index da2850f48..9ec04ba1d 100644
--- a/AGENTS.MD
+++ b/AGENTS.MD
@@ -50,8 +50,7 @@ source .venv/bin/activate
```
```bash install browser-use & chromium
uv 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 & chromium
pip 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 & chromium
uv 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 & chromium
pip install browser-use
-pip install playwright && playwright install chromium --with-deps
+browser-use install
```
</Tab>
</Tabs>
diff --git a/README.md b/README.md
index 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.py
index 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 timeout
process = 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_path
self.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 out
process.kill()
diff --git a/browser_use/cli.py b/browser_use/cli.py
index 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 dependencies
if len(sys.argv) > 1 and sys.argv[1] == 'install':
+ import platform
import subprocess
print('📦 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 platform
import subprocess
print('📦 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.mdx
index dbc829af7..f826227b1 100644
--- a/docs/examples/apps/vibetest-use.mdx
+++ b/docs/examples/apps/vibetest-use.mdx
@@ -38,7 +38,7 @@ source .venv/bin/activate
uv pip install -e .
# 4. Install browser runtime once
-uvx browser-use install
+browser-use install
```
### 1) Claude Code
diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx
index 3f02bfeaa..48731820f 100644
--- a/docs/quickstart.mdx
+++ b/docs/quickstart.mdx
@@ -22,7 +22,7 @@ source .venv/bin/activate
```
```bash install browser-use & chromium
uv 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 & chromium
pip install browser-use
-pip install playwright && playwright install chromium --with-deps
+browser-use install
```
</Tab>
</Tabs>