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
Bridge BrowserProfile viewport
Magnus Müller857a24f8bc88
diff --git a/RUST_AGENT_INTEGRATION_FEATURES.md b/RUST_AGENT_INTEGRATION_FEATURES.mdindex 13f1ff23d..ac0c0f819 100644--- a/RUST_AGENT_INTEGRATION_FEATURES.md+++ b/RUST_AGENT_INTEGRATION_FEATURES.md@@ -171,16 +171,22 @@ Terminal core branch: `magnus/browser-use-rust-integration` at latest pulled mai- The terminal core applies those settings with CDP `Browser.setDownloadBehavior` after connecting to managed, local, remote-CDP, or cloud browsers.- Proof: `test_rust_agent_translates_browser_profile_downloads`, `browser_download_behavior_env_allows_downloads_path`, and `browser_download_behavior_env_denies_disabled_downloads`.+33. BrowserProfile viewport bridge+ - `BrowserProfile.viewport`, `screen`, `device_scale_factor`, and `no_viewport` are serialized into `BU_BROWSER_VIEWPORT` and `BU_BROWSER_NO_VIEWPORT`.+ - The terminal core applies viewport metrics with CDP `Emulation.setDeviceMetricsOverride`, and the headless screenshot helper reuses those settings instead of forcing its default 1280x720 viewport.+ - Proof: `test_rust_agent_translates_browser_profile_viewport`, `browser_viewport_env_parses_device_metrics`, and `browser_viewport_env_honors_no_viewport`.+## Current Verification- `python3 -m py_compile browser_use/rust/service.py browser_use/rust/__init__.py browser_use/__init__.py tests/ci/test_rust_agent.py examples/rust_agent/basic.py examples/rust_agent/real_v8_smoke.py`-- `uv run pytest -q tests/ci/test_rust_agent.py` (42 tests)+- `uv run pytest -q tests/ci/test_rust_agent.py` (43 tests)- `cargo build -q -p browser-use-cli`- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-agent selected_remote_cdp_mode_allows_remote_cdp_connect -- --nocapture`- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-agent bare_browser_connect_resolves_to_selected_managed_mode_with_launch_args -- --nocapture`- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-agent bare_browser_connect_resolves_to_selected_managed_mode_with_profile_dir -- --nocapture`- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-browser browser_permissions_env_parses_json_array -- --nocapture`- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-browser browser_download_behavior_env_ -- --nocapture`+- `CARGO_INCREMENTAL=0 cargo test -q -p browser-use-browser browser_viewport_env_ -- --nocapture`- Managed-headless end-to-end:- `BROWSER_USE_TERMINAL_BINARY=/home/exedev/Developer/terminal/target/debug/browser-use-terminal BROWSER_USE_RUST_BROWSER_MODE=managed-headless BU_TASK='Open https://example.com and report the page title only.' BU_MAX_STEPS=12 timeout 300 uv run python examples/rust_agent/basic.py`- Output: `Example Domain`diff --git a/browser_use/rust/service.py b/browser_use/rust/service.pyindex 645bcc0a0..1ada47e97 100644--- a/browser_use/rust/service.py+++ b/browser_use/rust/service.py@@ -265,6 +265,59 @@ def _extract_browser_downloads(return accept_downloads, downloads_path+def _viewport_size(value: Any) -> tuple[int, int] | None:+ if value is None:+ return None+ if isinstance(value, (list, tuple)) and len(value) >= 2:+ width, height = value[0], value[1]+ else:+ width = _value_from_object(value, 'width')+ height = _value_from_object(value, 'height')+ if not isinstance(width, int) or not isinstance(height, int) or width <= 0 or height <= 0:+ return None+ return width, height+++def _extract_browser_viewport(+ browser_session: BrowserSession | None, browser_profile: BrowserProfile | None+) -> tuple[bool | None, dict[str, int | float] | None]:+ no_viewport: bool | None = None+ viewport_size: tuple[int, int] | None = None+ screen_size: tuple[int, int] | None = None+ device_scale_factor: int | float | None = None+ session_profile = getattr(browser_session, 'browser_profile', None)+ for profile in (session_profile, browser_profile, browser_session):+ if no_viewport is None:+ value = getattr(profile, 'no_viewport', None)+ if isinstance(value, bool):+ no_viewport = value+ if viewport_size is None:+ viewport_size = _viewport_size(getattr(profile, 'viewport', None))+ if screen_size is None:+ screen_size = _viewport_size(getattr(profile, 'screen', None))+ if device_scale_factor is None:+ value = getattr(profile, 'device_scale_factor', None)+ if isinstance(value, (int, float)) and value >= 0:+ device_scale_factor = value+ if no_viewport is True:+ return no_viewport, None+ if viewport_size is None and no_viewport is False:+ viewport_size = screen_size+ if viewport_size is None:+ return no_viewport, None+ width, height = viewport_size+ viewport: dict[str, int | float] = {+ 'width': width,+ 'height': height,+ 'deviceScaleFactor': 1 if device_scale_factor is None else device_scale_factor,+ }+ if screen_size is not None:+ screen_width, screen_height = screen_size+ viewport['screenWidth'] = screen_width+ viewport['screenHeight'] = screen_height+ return no_viewport, viewport++def _is_managed_browser_mode(mode: str) -> bool:normalized = mode.strip().lower().replace('_', '-').replace(' ', '-')return normalized in {'managed-headless', 'headless', 'headless-chromium', 'managed-headed', 'managed', 'headed'}@@ -799,6 +852,9 @@ class Agent(Generic[AgentStructuredOutput]):self.browser_accept_downloads, self.browser_downloads_path = _extract_browser_downloads(self.browser_session, self.browser_profile)+ self.browser_no_viewport, self.browser_viewport = _extract_browser_viewport(+ self.browser_session, self.browser_profile+ )self.sensitive_data_context = _sensitive_data_context(sensitive_data)self.display_files_in_done_text = display_files_in_done_textself.file_system_path = file_system_path@@ -1250,6 +1306,10 @@ class Agent(Generic[AgentStructuredOutput]):env['BU_BROWSER_ACCEPT_DOWNLOADS'] = 'true' if self.browser_accept_downloads else 'false'if self.browser_downloads_path:env['BU_BROWSER_DOWNLOADS_PATH'] = self.browser_downloads_path+ if self.browser_no_viewport is not None:+ env['BU_BROWSER_NO_VIEWPORT'] = 'true' if self.browser_no_viewport else 'false'+ if self.browser_viewport:+ env['BU_BROWSER_VIEWPORT'] = json.dumps(self.browser_viewport)if self.managed_browser_env and _is_managed_browser_mode(browser_mode):env.update(self.managed_browser_env)if self.managed_browser_args and _is_managed_browser_mode(browser_mode):diff --git a/tests/ci/test_rust_agent.py b/tests/ci/test_rust_agent.pyindex 61fa84058..e3fd6d2be 100644--- a/tests/ci/test_rust_agent.py+++ b/tests/ci/test_rust_agent.py@@ -385,6 +385,44 @@ def test_rust_agent_translates_browser_profile_downloads(monkeypatch, tmp_path):assert env['BU_BROWSER_DOWNLOADS_PATH'] == str(profile_downloads_path)+def test_rust_agent_translates_browser_profile_viewport(monkeypatch):+ from browser_use.rust import Agent++ class BrowserProfile:+ viewport = {'width': 1024, 'height': 768}+ screen = (1440, 900)+ device_scale_factor = 2+ no_viewport = False+ cdp_url = 'http://127.0.0.1:9222'++ class NoViewportProfile:+ viewport = {'width': 1024, 'height': 768}+ no_viewport = True+ cdp_url = 'http://127.0.0.1:9222'++ monkeypatch.setenv('BROWSER_USE_TERMINAL_BINARY', '/tmp/browser-use-terminal')++ agent = Agent(task='report title', browser_profile=BrowserProfile())+ env = agent._run_env()+ viewport = json.loads(env['BU_BROWSER_VIEWPORT'])++ assert env['LLM_BROWSER_BROWSER_MODE'] == 'remote-cdp'+ assert env['BU_BROWSER_NO_VIEWPORT'] == 'false'+ assert viewport == {+ 'width': 1024,+ 'height': 768,+ 'deviceScaleFactor': 2,+ 'screenWidth': 1440,+ 'screenHeight': 900,+ }++ no_viewport_agent = Agent(task='report title', browser_profile=NoViewportProfile())+ no_viewport_env = no_viewport_agent._run_env()++ assert no_viewport_env['BU_BROWSER_NO_VIEWPORT'] == 'true'+ assert 'BU_BROWSER_VIEWPORT' not in no_viewport_env++def test_rust_agent_translates_browser_profile_user_data_dir(monkeypatch, tmp_path):from browser_use.rust import Agent