Skip to content

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

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.py
index 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 readability
diff --git a/browser_use/skill_cli/commands/cloud.py b/browser_use/skill_cli/commands/cloud.py
index 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'] = key
diff --git a/browser_use/skill_cli/daemon.py b/browser_use/skill_cli/daemon.py
index 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_url
self.use_cloud = use_cloud
self.cloud_profile_id = cloud_profile_id
+ self.cloud_proxy_country_code = cloud_proxy_country_code
+ self.cloud_timeout = cloud_timeout
self.running = True
self._server: asyncio.Server | None = None
self._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.py
index 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 environment
env = 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 process
if sys.platform == 'win32':
subprocess.Popen(
@@ -918,8 +925,8 @@ def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, sessi
print('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_timeout
cloud_profile_id = _ensure_cloud_profile()
@@ -931,6 +938,8 @@ def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, sessi
explicit_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 creation
diff --git a/browser_use/skill_cli/sessions.py b/browser_use/skill_cli/sessions.py
index 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_timeout
return CLIBrowserSession(**kwargs) # type: ignore[call-arg]
if profile is None: