Skip to content

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

don't slow down CLI

Laith Weinberger9ee4929912ff
diff --git a/browser_use/cli.py b/browser_use/cli.py
index 95f6a1a42..13e8f9f28 100644
--- a/browser_use/cli.py
+++ b/browser_use/cli.py
@@ -59,35 +59,26 @@ def _capture_cli_event(
error_message: str | None = None,
) -> None:
try:
- import logging
-
- from browser_use.telemetry import CLITelemetryEvent, ProductTelemetry
+ from browser_use.telemetry.service import capture_detached
+ from browser_use.telemetry.views import CLITelemetryEvent
model, model_provider = _detect_model()
- telemetry_logger = logging.getLogger('browser_use.telemetry.service')
- telemetry_logger_disabled = telemetry_logger.disabled
- telemetry_logger.disabled = True
- try:
- telemetry = ProductTelemetry()
- telemetry.capture(
- CLITelemetryEvent(
- version=_browser_use_version(),
- action=action,
- mode=mode,
- command=command,
- task=_redacted_task(task),
- task_length=len(task) if task is not None else None,
- agent_client=_detect_agent_client(),
- model=model,
- model_provider=model_provider,
- duration_seconds=time.monotonic() - start_time,
- exit_code=_exit_code(result),
- error_message=error_message,
- )
+ capture_detached(
+ CLITelemetryEvent(
+ version=_browser_use_version(),
+ action=action,
+ mode=mode,
+ command=command,
+ task=_redacted_task(task),
+ task_length=len(task) if task is not None else None,
+ agent_client=_detect_agent_client(),
+ model=model,
+ model_provider=model_provider,
+ duration_seconds=time.monotonic() - start_time,
+ exit_code=_exit_code(result),
+ error_message=error_message,
)
- telemetry.flush()
- finally:
- telemetry_logger.disabled = telemetry_logger_disabled
+ )
except Exception:
pass
diff --git a/browser_use/telemetry/service.py b/browser_use/telemetry/service.py
index c3edfdc9d..99b14909d 100644
--- a/browser_use/telemetry/service.py
+++ b/browser_use/telemetry/service.py
@@ -2,7 +2,6 @@ import logging
import os
from dotenv import load_dotenv
-from posthog import Posthog
from uuid_extensions import uuid7str
from browser_use.telemetry.views import BaseTelemetryEvent
@@ -19,6 +18,99 @@ POSTHOG_EVENT_SETTINGS = {
'process_person_profile': True,
}
+POSTHOG_PROJECT_API_KEY = 'phc_F8JMNjW1i2KbGUTaW1unnDdLSPCoyc52SGRU0JecaUh'
+POSTHOG_HOST = 'https://eu.i.posthog.com'
+DEVICE_ID_PATH = str(CONFIG.BROWSER_USE_CONFIG_DIR / 'device_id')
+
+_device_id: str | None = None
+
+
+def get_or_create_device_id() -> str:
+ """Return the anonymous device id shared by telemetry"""
+ global _device_id
+ if _device_id:
+ return _device_id
+ _device_id = os.environ.get('BROWSER_USE_DEVICE_ID') or _persisted_device_id() or _machine_fingerprint() or uuid7str()
+ return _device_id
+
+
+def _persisted_device_id() -> str | None:
+ try:
+ if os.path.exists(DEVICE_ID_PATH):
+ with open(DEVICE_ID_PATH) as f:
+ return f.read().strip() or None
+ os.makedirs(os.path.dirname(DEVICE_ID_PATH), exist_ok=True)
+ new_device_id = uuid7str()
+ tmp_path = f'{DEVICE_ID_PATH}.{os.getpid()}.tmp'
+ with open(tmp_path, 'w') as f:
+ f.write(new_device_id)
+ os.replace(tmp_path, DEVICE_ID_PATH)
+ return new_device_id
+ except Exception:
+ return None
+
+
+def _machine_fingerprint() -> str | None:
+ """Hashed hardware-derived id"""
+ import hashlib
+ import socket
+ import uuid
+
+ node = uuid.getnode()
+ if (node >> 40) & 0x01: # multicast bit set: getnode() failed and returned a random id
+ return None
+ return 'bu_' + hashlib.sha256(f'browser-use:{node}:{socket.gethostname()}'.encode()).hexdigest()[:32]
+
+
+_DETACHED_SENDER_SOURCE = """
+import json, sys, urllib.request
+try:
+ job = json.load(sys.stdin)
+ request = urllib.request.Request(
+ job['url'],
+ method='POST',
+ data=json.dumps(job['payload']).encode('utf-8'),
+ headers={'Content-Type': 'application/json'},
+ )
+ urllib.request.urlopen(request, timeout=job['timeout']).close()
+except Exception:
+ pass
+"""
+
+
+def capture_detached(event: BaseTelemetryEvent) -> None:
+ """Send a single event to PostHog from a detached helper process."""
+ if not CONFIG.ANONYMIZED_TELEMETRY:
+ return
+ try:
+ import json
+ import subprocess
+ import sys
+
+ job = {
+ 'url': f'{POSTHOG_HOST}/i/v0/e/',
+ 'timeout': float(os.environ.get('BROWSER_USE_TELEMETRY_TIMEOUT', '5')),
+ 'payload': {
+ 'api_key': POSTHOG_PROJECT_API_KEY,
+ 'distinct_id': get_or_create_device_id(),
+ 'event': event.name,
+ 'properties': {**event.properties, **POSTHOG_EVENT_SETTINGS},
+ },
+ }
+
+ process = subprocess.Popen(
+ [sys.executable, '-c', _DETACHED_SENDER_SOURCE],
+ stdin=subprocess.PIPE,
+ stdout=subprocess.DEVNULL,
+ stderr=subprocess.DEVNULL,
+ start_new_session=True,
+ )
+ assert process.stdin is not None
+ process.stdin.write(json.dumps(job).encode('utf-8'))
+ process.stdin.close()
+ except Exception:
+ return
+
@singleton
class ProductTelemetry:
@@ -28,9 +120,9 @@ class ProductTelemetry:
If the environment variable `ANONYMIZED_TELEMETRY=False`, anonymized telemetry will be disabled.
"""
- USER_ID_PATH = str(CONFIG.BROWSER_USE_CONFIG_DIR / 'device_id')
- PROJECT_API_KEY = 'phc_F8JMNjW1i2KbGUTaW1unnDdLSPCoyc52SGRU0JecaUh'
- HOST = 'https://eu.i.posthog.com'
+ USER_ID_PATH = DEVICE_ID_PATH
+ PROJECT_API_KEY = POSTHOG_PROJECT_API_KEY
+ HOST = POSTHOG_HOST
UNKNOWN_USER_ID = 'UNKNOWN'
_curr_user_id = None
@@ -42,6 +134,8 @@ class ProductTelemetry:
if telemetry_disabled:
self._posthog_client = None
else:
+ from posthog import Posthog
+
logger.info('Using anonymized telemetry, see https://docs.browser-use.com/development/monitoring/telemetry.')
self._posthog_client = Posthog(
project_api_key=self.PROJECT_API_KEY,
@@ -95,18 +189,5 @@ class ProductTelemetry:
if self._curr_user_id:
return self._curr_user_id
- # File access may fail due to permissions or other reasons. We don't want to
- # crash so we catch all exceptions.
- try:
- if not os.path.exists(self.USER_ID_PATH):
- os.makedirs(os.path.dirname(self.USER_ID_PATH), exist_ok=True)
- with open(self.USER_ID_PATH, 'w') as f:
- new_user_id = uuid7str()
- f.write(new_user_id)
- self._curr_user_id = new_user_id
- else:
- with open(self.USER_ID_PATH) as f:
- self._curr_user_id = f.read()
- except Exception:
- self._curr_user_id = 'UNKNOWN_USER_ID'
+ self._curr_user_id = get_or_create_device_id()
return self._curr_user_id