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: config-driven proxy/timeout for cloud connect, enable recording
ShawnPana032e73eec7db
diff --git a/browser_use/browser/cloud/views.py b/browser_use/browser/cloud/views.pyindex cb378dd2c..a53f9d41d 100644--- a/browser_use/browser/cloud/views.py+++ b/browser_use/browser/cloud/views.py@@ -59,6 +59,13 @@ class CreateBrowserRequest(BaseModel):title='Cloud Timeout',)+ enable_recording: bool = Field(+ default=True,+ alias='enableRecording',+ description='Enable session recording for playback in the cloud dashboard.',+ title='Enable Recording',+ )+CloudBrowserParams = CreateBrowserRequest # alias for easier readabilitydiff --git a/browser_use/skill_cli/commands/cloud.py b/browser_use/skill_cli/commands/cloud.pyindex ed59c8622..bc2aa4869 100644--- a/browser_use/skill_cli/commands/cloud.py+++ b/browser_use/skill_cli/commands/cloud.py@@ -130,6 +130,17 @@ def _ensure_cloud_profile() -> str:return new_id+def _get_cloud_connect_proxy() -> str | None:+ """Return the cloud connect proxy country code from config, or None."""+ return _read_config().get('cloud_connect_proxy')+++def _get_cloud_connect_timeout() -> int | None:+ """Return the cloud connect timeout (minutes) from config, or None."""+ val = _read_config().get('cloud_connect_timeout')+ return int(val) if val is not None else None++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 65106787d..56a9dbd94 100644--- a/browser_use/skill_cli/daemon.py+++ b/browser_use/skill_cli/daemon.py@@ -39,6 +39,8 @@ class Daemon:cdp_url: str | None = None,use_cloud: bool = False,cloud_profile_id: str | None = None,+ cloud_proxy_country_code: str | None = None,+ cloud_timeout: int | None = None,session: str = 'default',) -> None:from browser_use.skill_cli.utils import validate_session_name@@ -50,6 +52,8 @@ class Daemon:self.cdp_url = cdp_urlself.use_cloud = use_cloudself.cloud_profile_id = cloud_profile_id+ self.cloud_proxy_country_code = cloud_proxy_country_code+ self.cloud_timeout = cloud_timeoutself.running = Trueself._server: asyncio.Server | None = Noneself._shutdown_event = asyncio.Event()@@ -124,6 +128,8 @@ class Daemon:self.cdp_url,use_cloud=self.use_cloud,cloud_profile_id=self.cloud_profile_id,+ cloud_proxy_country_code=self.cloud_proxy_country_code,+ cloud_timeout=self.cloud_timeout,)try:@@ -559,6 +565,8 @@ def main() -> None: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-profile-id', help='Cloud browser profile ID')+ parser.add_argument('--cloud-proxy-country', help='Cloud browser proxy country code')+ parser.add_argument('--cloud-timeout', type=int, help='Cloud browser timeout in minutes')args = parser.parse_args()logger.info(@@ -571,6 +579,8 @@ def main() -> None:cdp_url=args.cdp_url,use_cloud=args.use_cloud,cloud_profile_id=args.cloud_profile_id,+ cloud_proxy_country_code=args.cloud_proxy_country,+ cloud_timeout=args.cloud_timeout,session=args.session,)diff --git a/browser_use/skill_cli/main.py b/browser_use/skill_cli/main.pyindex cbcb1a598..17293eff3 100755--- a/browser_use/skill_cli/main.py+++ b/browser_use/skill_cli/main.py@@ -432,6 +432,8 @@ def ensure_daemon(explicit_config: bool = False,use_cloud: bool = False,cloud_profile_id: str | None = None,+ cloud_proxy_country_code: str | None = None,+ cloud_timeout: int | None = None,) -> None:"""Start daemon if not running. Uses state file for phase-aware decisions."""probe = _probe_session(session)@@ -520,6 +522,10 @@ def ensure_daemon(cmd.append('--use-cloud')if cloud_profile_id is not None:cmd.extend(['--cloud-profile-id', cloud_profile_id])+ if cloud_proxy_country_code is not None:+ cmd.extend(['--cloud-proxy-country', cloud_proxy_country_code])+ if cloud_timeout is not None:+ cmd.extend(['--cloud-timeout', str(cloud_timeout)])# Set up environmentenv = os.environ.copy()@@ -534,6 +540,7 @@ def ensure_daemon(if cli_api_key:env['BROWSER_USE_API_KEY'] = cli_api_key+# Start daemon as background processif sys.platform == 'win32':subprocess.Popen(@@ -918,8 +925,8 @@ 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+ # Auto-manage cloud profile and read config-driven settings+ from browser_use.skill_cli.commands.cloud import _ensure_cloud_profile, _get_cloud_connect_proxy, _get_cloud_connect_timeoutcloud_profile_id = _ensure_cloud_profile()@@ -931,6 +938,8 @@ def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, sessiexplicit_config=True,use_cloud=True,cloud_profile_id=cloud_profile_id,+ cloud_proxy_country_code=_get_cloud_connect_proxy(),+ cloud_timeout=_get_cloud_connect_timeout(),)# Send connect command to force immediate session creationdiff --git a/browser_use/skill_cli/sessions.py b/browser_use/skill_cli/sessions.pyindex 4f3f17356..e12a2a616 100644--- a/browser_use/skill_cli/sessions.py+++ b/browser_use/skill_cli/sessions.py@@ -35,6 +35,8 @@ async def create_browser_session(cdp_url: str | None = None,use_cloud: bool = False,cloud_profile_id: str | None = None,+ cloud_proxy_country_code: str | None = None,+ cloud_timeout: int | None = None,) -> CLIBrowserSession:"""Create BrowserSession based on connection mode.@@ -50,6 +52,10 @@ async def create_browser_session(kwargs: dict = {'use_cloud': True}if cloud_profile_id is not None:kwargs['cloud_profile_id'] = cloud_profile_id+ if cloud_proxy_country_code is not None:+ kwargs['cloud_proxy_country_code'] = cloud_proxy_country_code+ if cloud_timeout is not None:+ kwargs['cloud_timeout'] = cloud_timeoutreturn CLIBrowserSession(**kwargs) # type: ignore[call-arg]if profile is None: