Skip to content

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

fix-wildcard-imports

Magnus Müllere26eceb7fcd9
diff --git a/browser_use/llm/__init__.py b/browser_use/llm/__init__.py
index ba796a59f..e46c208db 100644
--- a/browser_use/llm/__init__.py
+++ b/browser_use/llm/__init__.py
@@ -37,8 +37,40 @@ if TYPE_CHECKING:
from browser_use.llm.openai.chat import ChatOpenAI
from browser_use.llm.openrouter.chat import ChatOpenRouter
-# Import all models from models.py
-from browser_use.llm.models import * # noqa: F403
+ # Type stubs for model instances - enables IDE autocomplete
+ openai_gpt_4o: ChatOpenAI
+ openai_gpt_4o_mini: ChatOpenAI
+ openai_gpt_4_1_mini: ChatOpenAI
+ openai_o1: ChatOpenAI
+ openai_o1_mini: ChatOpenAI
+ openai_o1_pro: ChatOpenAI
+ openai_o3: ChatOpenAI
+ openai_o3_mini: ChatOpenAI
+ openai_o3_pro: ChatOpenAI
+ openai_o4_mini: ChatOpenAI
+ openai_gpt_5: ChatOpenAI
+ openai_gpt_5_mini: ChatOpenAI
+ openai_gpt_5_nano: ChatOpenAI
+
+ azure_gpt_4o: ChatAzureOpenAI
+ azure_gpt_4o_mini: ChatAzureOpenAI
+ azure_gpt_4_1_mini: ChatAzureOpenAI
+ azure_o1: ChatAzureOpenAI
+ azure_o1_mini: ChatAzureOpenAI
+ azure_o1_pro: ChatAzureOpenAI
+ azure_o3: ChatAzureOpenAI
+ azure_o3_mini: ChatAzureOpenAI
+ azure_o3_pro: ChatAzureOpenAI
+ azure_gpt_5: ChatAzureOpenAI
+ azure_gpt_5_mini: ChatAzureOpenAI
+
+ google_gemini_2_0_flash: ChatGoogle
+ google_gemini_2_0_pro: ChatGoogle
+ google_gemini_2_5_pro: ChatGoogle
+ google_gemini_2_5_flash: ChatGoogle
+ google_gemini_2_5_flash_lite: ChatGoogle
+
+# Models are imported on-demand via __getattr__
# Lazy imports mapping for heavy chat models
_LAZY_IMPORTS = {
@@ -54,9 +86,12 @@ _LAZY_IMPORTS = {
'ChatOpenRouter': ('browser_use.llm.openrouter.chat', 'ChatOpenRouter'),
}
+# Cache for model instances - only created when accessed
+_model_cache: dict[str, 'BaseChatModel'] = {}
+
def __getattr__(name: str):
- """Lazy import mechanism for heavy chat model imports."""
+ """Lazy import mechanism for heavy chat model imports and model instances."""
if name in _LAZY_IMPORTS:
module_path, attr_name = _LAZY_IMPORTS[name]
try:
@@ -64,12 +99,25 @@ def __getattr__(name: str):
module = import_module(module_path)
attr = getattr(module, attr_name)
- # Cache the imported attribute in the module's globals
- globals()[name] = attr
return attr
except ImportError as e:
raise ImportError(f'Failed to import {name} from {module_path}: {e}') from e
+ # Check cache first for model instances
+ if name in _model_cache:
+ return _model_cache[name]
+
+ # Try to get model instances from models module on-demand
+ try:
+ from browser_use.llm.models import __getattr__ as models_getattr
+
+ attr = models_getattr(name)
+ # Cache in our clean cache dict
+ _model_cache[name] = attr
+ return attr
+ except AttributeError:
+ pass
+
raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
diff --git a/examples/integrations/agentmail/2fa.py b/examples/integrations/agentmail/2fa.py
index 9346bfa24..89b80caf3 100644
--- a/examples/integrations/agentmail/2fa.py
+++ b/examples/integrations/agentmail/2fa.py
@@ -4,15 +4,13 @@ import sys
from agentmail import AsyncAgentMail # type: ignore
-from browser_use import Agent, Browser, models
-from examples.integrations.agentmail.email_tools import EmailTools
-
sys.path.append(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))))
-
from dotenv import load_dotenv
load_dotenv()
+from browser_use import Agent, Browser, models
+from examples.integrations.agentmail.email_tools import EmailTools
TASK = """
Go to reddit.com, create a new account (use the get_email_address), make up password and all other information, confirm the 2fa with get_latest_email, and like latest post on r/elon subreddit.