Skip to content

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

perf: lazy import for openai and reportlab to reduce startup latency

hacking-racoon38703d5ad778
diff --git a/browser_use/agent/views.py b/browser_use/agent/views.py
index b3a518927..0131a0f7e 100644
--- a/browser_use/agent/views.py
+++ b/browser_use/agent/views.py
@@ -7,7 +7,6 @@ from dataclasses import dataclass
from pathlib import Path
from typing import Any, Generic, Literal
-from openai import RateLimitError
from pydantic import BaseModel, ConfigDict, Field, ValidationError, create_model, model_validator
from typing_extensions import TypeVar
from uuid_extensions import uuid7str
@@ -760,6 +759,9 @@ class AgentError:
message = ''
if isinstance(error, ValidationError):
return f'{AgentError.VALIDATION_ERROR}\nDetails: {str(error)}'
+ # Lazy import to avoid loading openai SDK (~800ms) at module level
+ from openai import RateLimitError
+
if isinstance(error, RateLimitError):
return AgentError.RATE_LIMIT_ERROR
diff --git a/browser_use/filesystem/file_system.py b/browser_use/filesystem/file_system.py
index 2579e62fa..da1cb9478 100644
--- a/browser_use/filesystem/file_system.py
+++ b/browser_use/filesystem/file_system.py
@@ -9,9 +9,6 @@ from pathlib import Path
from typing import Any
from pydantic import BaseModel, Field
-from reportlab.lib.pagesizes import letter
-from reportlab.lib.styles import getSampleStyleSheet
-from reportlab.platypus import Paragraph, SimpleDocTemplate, Spacer
INVALID_FILENAME_ERROR_MESSAGE = 'Error: Invalid filename format. Must be alphanumeric with supported extension.'
DEFAULT_FILE_SYSTEM_PATH = 'browseruse_agent_data'
@@ -130,6 +127,11 @@ class PdfFile(BaseFile):
return 'pdf'
def sync_to_disk_sync(self, path: Path) -> None:
+ # Lazy import reportlab
+ from reportlab.lib.pagesizes import letter
+ from reportlab.lib.styles import getSampleStyleSheet
+ from reportlab.platypus import Paragraph, SimpleDocTemplate, Spacer
+
file_path = path / self.full_name
try:
# Create PDF document
diff --git a/browser_use/llm/messages.py b/browser_use/llm/messages.py
index 75a5d8f6e..06912a3b3 100644
--- a/browser_use/llm/messages.py
+++ b/browser_use/llm/messages.py
@@ -5,7 +5,7 @@ This implementation is based on the OpenAI types, while removing all the parts t
# region - Content parts
from typing import Literal, Union
-from openai import BaseModel
+from pydantic import BaseModel
def _truncate(text: str, max_length: int = 50) -> str:
diff --git a/browser_use/utils.py b/browser_use/utils.py
index 6d836eb59..1baac45d5 100644
--- a/browser_use/utils.py
+++ b/browser_use/utils.py
@@ -24,16 +24,37 @@ URL_PATTERN = re.compile(r'https?://[^\s<>"\']+|www\.[^\s<>"\']+|[^\s<>"\']+\.[a
logger = logging.getLogger(__name__)
-# Import error types - these may need to be adjusted based on actual import paths
-try:
- from openai import BadRequestError as OpenAIBadRequestError
-except ImportError:
- OpenAIBadRequestError = None
-
-try:
- from groq import BadRequestError as GroqBadRequestError # type: ignore[import-not-found]
-except ImportError:
- GroqBadRequestError = None
+# Lazy import for error types
+# Use sentinel to avoid retrying import when package is not installed
+_IMPORT_NOT_FOUND: type = type('_ImportNotFound', (), {})
+_openai_bad_request_error: type | None = None
+_groq_bad_request_error: type | None = None
+
+
+def _get_openai_bad_request_error() -> type | None:
+ """Lazy loader for OpenAI BadRequestError."""
+ global _openai_bad_request_error
+ if _openai_bad_request_error is None:
+ try:
+ from openai import BadRequestError
+
+ _openai_bad_request_error = BadRequestError
+ except ImportError:
+ _openai_bad_request_error = _IMPORT_NOT_FOUND
+ return _openai_bad_request_error if _openai_bad_request_error is not _IMPORT_NOT_FOUND else None
+
+
+def _get_groq_bad_request_error() -> type | None:
+ """Lazy loader for Groq BadRequestError."""
+ global _groq_bad_request_error
+ if _groq_bad_request_error is None:
+ try:
+ from groq import BadRequestError # type: ignore[import-not-found]
+
+ _groq_bad_request_error = BadRequestError
+ except ImportError:
+ _groq_bad_request_error = _IMPORT_NOT_FOUND
+ return _groq_bad_request_error if _groq_bad_request_error is not _IMPORT_NOT_FOUND else None
# Global flag to prevent duplicate exit messages