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
feat: zero-config cloud connect with auto-managed profile
ShawnPanab4b2a4c18d2d
diff --git a/browser_use/skill_cli/README.md b/browser_use/skill_cli/README.mdindex f245e88da..fd426a846 100644--- a/browser_use/skill_cli/README.md+++ b/browser_use/skill_cli/README.md@@ -205,10 +205,7 @@ Generic REST passthrough to the Browser-Use Cloud API, plus cloud browser provis| Command | Description ||---------|-------------|-| `cloud connect` | Provision cloud browser and connect |-| `cloud connect --timeout 120` | Cloud browser with custom timeout |-| `cloud connect --proxy-country US` | Cloud browser with proxy |-| `cloud connect --profile-id <id>` | Cloud browser with profile |+| `cloud connect` | Provision cloud browser and connect (zero-config, auto-manages profile) || `cloud login <api-key>` | Save API key || `cloud logout` | Remove API key || `cloud v2 GET <path>` | GET request to API v2 |diff --git a/browser_use/skill_cli/commands/cloud.py b/browser_use/skill_cli/commands/cloud.pyindex 2c6df8a6f..3b75b19fa 100644--- a/browser_use/skill_cli/commands/cloud.py+++ b/browser_use/skill_cli/commands/cloud.py@@ -90,6 +90,37 @@ def _get_api_key() -> str:sys.exit(1)+def _ensure_cloud_profile() -> str:+ """Return the default cloud connect profile ID, creating one if needed."""+ config = _read_config()+ profile_id = config.get('cloud_connect_profile_id')+ api_key = _get_api_key()++ # Validate existing profile+ if profile_id:+ status, _ = _http_request('GET', f'{_base_url("v2")}/profiles/{profile_id}', None, api_key)+ if status == 200:+ return profile_id+ # Profile was deleted — fall through to create++ # Create new profile+ body = json.dumps({'name': 'Browser Use CLI'}).encode()+ status, resp = _http_request('POST', f'{_base_url("v2")}/profiles', body, api_key)+ if status >= 400:+ print(f'Error creating cloud profile: HTTP {status}', file=sys.stderr)+ _print_json(resp, file=sys.stderr)+ sys.exit(1)++ data = json.loads(resp)+ new_id = data['id']++ # Save to config+ config['cloud_connect_profile_id'] = new_id+ _write_config(config)++ return new_id++def _save_api_key(key: str) -> None:config = _read_config()config['api_key'] = keydiff --git a/browser_use/skill_cli/daemon.py b/browser_use/skill_cli/daemon.pyindex 71c35a93c..65106787d 100644--- a/browser_use/skill_cli/daemon.py+++ b/browser_use/skill_cli/daemon.py@@ -38,8 +38,6 @@ class Daemon:profile: str | None,cdp_url: str | None = None,use_cloud: bool = False,- cloud_timeout: int | None = None,- cloud_proxy_country_code: str | None = None,cloud_profile_id: str | None = None,session: str = 'default',) -> None:@@ -51,8 +49,6 @@ class Daemon:self.profile = profileself.cdp_url = cdp_urlself.use_cloud = use_cloud- self.cloud_timeout = cloud_timeout- self.cloud_proxy_country_code = cloud_proxy_country_codeself.cloud_profile_id = cloud_profile_idself.running = Trueself._server: asyncio.Server | None = None@@ -127,8 +123,6 @@ class Daemon:self.profile,self.cdp_url,use_cloud=self.use_cloud,- cloud_timeout=self.cloud_timeout,- cloud_proxy_country_code=self.cloud_proxy_country_code,cloud_profile_id=self.cloud_profile_id,)@@ -564,8 +558,6 @@ def main() -> None:parser.add_argument('--profile', help='Chrome profile (triggers real Chrome mode)')parser.add_argument('--cdp-url', help='CDP URL to connect to')parser.add_argument('--use-cloud', action='store_true', help='Use cloud browser')- parser.add_argument('--cloud-timeout', type=int, help='Cloud browser timeout in seconds')- parser.add_argument('--cloud-proxy-country', help='Cloud browser proxy country code')parser.add_argument('--cloud-profile-id', help='Cloud browser profile ID')args = parser.parse_args()@@ -578,8 +570,6 @@ def main() -> None:profile=args.profile,cdp_url=args.cdp_url,use_cloud=args.use_cloud,- cloud_timeout=args.cloud_timeout,- cloud_proxy_country_code=args.cloud_proxy_country,cloud_profile_id=args.cloud_profile_id,session=args.session,)diff --git a/browser_use/skill_cli/main.py b/browser_use/skill_cli/main.pyindex 1956704ad..cbcb1a598 100755--- a/browser_use/skill_cli/main.py+++ b/browser_use/skill_cli/main.py@@ -431,8 +431,6 @@ def ensure_daemon(session: str = 'default',explicit_config: bool = False,use_cloud: bool = False,- cloud_timeout: int | None = None,- cloud_proxy_country_code: str | None = None,cloud_profile_id: str | None = None,) -> None:"""Start daemon if not running. Uses state file for phase-aware decisions."""@@ -520,10 +518,6 @@ def ensure_daemon(cmd.extend(['--cdp-url', cdp_url])if use_cloud:cmd.append('--use-cloud')- if cloud_timeout is not None:- cmd.extend(['--cloud-timeout', str(cloud_timeout)])- if cloud_proxy_country_code is not None:- cmd.extend(['--cloud-proxy-country', cloud_proxy_country_code])if cloud_profile_id is not None:cmd.extend(['--cloud-profile-id', cloud_profile_id])@@ -912,14 +906,7 @@ Setup:def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, session: str) -> int:- """Handle `browser-use cloud connect` — provision cloud browser and connect."""- # Parse connect-specific args- connect_parser = argparse.ArgumentParser(prog='browser-use cloud connect', add_help=False)- connect_parser.add_argument('--timeout', type=int, default=None, help='Cloud browser timeout in seconds')- connect_parser.add_argument('--proxy-country', default=None, help='Cloud browser proxy country code')- connect_parser.add_argument('--profile-id', default=None, help='Cloud browser profile ID')- connect_args, _ = connect_parser.parse_known_args(cloud_args)-+ """Handle `browser-use cloud connect` — zero-config cloud browser provisioning."""# Mutual exclusivity checksif getattr(args, 'connect', False):print('Error: --connect and cloud connect are mutually exclusive', file=sys.stderr)@@ -931,6 +918,11 @@ def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, sessiprint('Error: --profile and cloud connect are mutually exclusive', file=sys.stderr)return 1+ # Auto-manage cloud profile (creates on first use, validates on reuse)+ from browser_use.skill_cli.commands.cloud import _ensure_cloud_profile++ cloud_profile_id = _ensure_cloud_profile()+# Start daemon with cloud configensure_daemon(args.headed,@@ -938,9 +930,7 @@ def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, sessisession=session,explicit_config=True,use_cloud=True,- cloud_timeout=connect_args.timeout,- cloud_proxy_country_code=connect_args.proxy_country,- cloud_profile_id=connect_args.profile_id,+ cloud_profile_id=cloud_profile_id,)# Send connect command to force immediate session creationdiff --git a/browser_use/skill_cli/sessions.py b/browser_use/skill_cli/sessions.pyindex 5a767899e..4f3f17356 100644--- a/browser_use/skill_cli/sessions.py+++ b/browser_use/skill_cli/sessions.py@@ -34,8 +34,6 @@ async def create_browser_session(profile: str | None,cdp_url: str | None = None,use_cloud: bool = False,- cloud_timeout: int | None = None,- cloud_proxy_country_code: str | None = None,cloud_profile_id: str | None = None,) -> CLIBrowserSession:"""Create BrowserSession based on connection mode.@@ -50,10 +48,6 @@ async def create_browser_session(if use_cloud:kwargs: dict = {'use_cloud': True}- if cloud_timeout is not None:- kwargs['cloud_timeout'] = cloud_timeout- if cloud_proxy_country_code is not None:- kwargs['cloud_proxy_country_code'] = cloud_proxy_country_codeif cloud_profile_id is not None:kwargs['cloud_profile_id'] = cloud_profile_idreturn CLIBrowserSession(**kwargs) # type: ignore[call-arg]diff --git a/skills/browser-use/SKILL.md b/skills/browser-use/SKILL.mdindex 8bc5c7112..fe27e2220 100644--- a/skills/browser-use/SKILL.md+++ b/skills/browser-use/SKILL.md@@ -123,8 +123,7 @@ Read `references/cdp-python.md` for the `browser._run()` pattern and copy-pastea## Cloud API```bash-browser-use cloud connect # Provision cloud browser and connect-browser-use cloud connect --timeout 120 --proxy-country US # With options+browser-use cloud connect # Provision cloud browser and connect (zero-config)browser-use cloud login <api-key> # Save API key (or set BROWSER_USE_API_KEY)browser-use cloud logout # Remove API keybrowser-use cloud v2 GET /browsers # REST passthrough (v2 or v3)@@ -133,7 +132,7 @@ browser-use cloud v2 poll <task-id> # Poll task until donebrowser-use cloud v2 --help # Show API endpoints```-`cloud connect` provisions a cloud browser, connects via CDP, and prints a live URL. `browser-use close` disconnects AND stops the cloud browser.+`cloud connect` provisions a cloud browser with a persistent profile (auto-created on first use), connects via CDP, and prints a live URL. `browser-use close` disconnects AND stops the cloud browser. For custom browser settings (proxy, timeout, specific profile), use `cloud v2 POST /browsers` directly with the desired parameters.## Tunnels