Add web browsing capabilities to Browser Use

Integrate Browserbase with Browser Use

1. Get your API Key

   Visit the Dashboard’s Overview tab:

   Then copy and set the BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID environment variables in your .env file.

2. Install and create a virtual environment with UV

   UV is a modern package manager for Python.

   uv venv
   

3. Install Browserbase and Browser Use

   source .venv/bin/activate # follow the `uv venv` output
   uv pip install browserbase browser-use langchain-anthropic python-dotenv
   

4. Create the Browser Session

   We’ll create a browser session using Browserbase’s CDP connection with proper configuration for remote browser stability.

   main.py

   from dotenv import load_dotenv
   import os
   import asyncio
   from browserbase import Browserbase
   from browser_use import Agent
   from browser_use.browser.session import BrowserSession
   from browser_use.browser import BrowserProfile
   from langchain_anthropic import ChatAnthropic
   
   async def main():
       load_dotenv()
       
       # Create Browserbase session
       bb = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"])
   
       session = bb.sessions.create(project_id=os.environ["BROWSERBASE_PROJECT_ID"])
       debug_url = f"https://www.browserbase.com/sessions/{session.id}"
       print("Debug URL:", debug_url)
   

5. Configure Browser Profile

   Set up the browser profile with appropriate timeouts and settings for remote browser usage:

   main.py

       # Configure browser profile for Browserbase
       browser_profile = BrowserProfile(
           keep_alive=True,  # Don't close browser automatically
           wait_between_actions=2.0,  # Add delay between actions
           # Increase timeouts to handle remote browser latency
           default_timeout=45000,
           default_navigation_timeout=45000,
       )
   
       # Create browser session with Browserbase CDP URL
       browser_session = BrowserSession(
           cdp_url=session.connect_url,
           browser_profile=browser_profile,
           keep_alive=True,
           initialized=False,  # Let it initialize properly
       )
       
       # Pre-initialize the browser session
       try:
           await browser_session.start()
           print("Browser session initialized successfully")
       except Exception as e:
           print(f"Failed to initialize browser session: {e}")
           return
   

6. Create and Run the Agent

   Set up the LLM and create the browser automation agent:

   main.py

       # Set up LLM
       llm = ChatAnthropic(model="claude-3-5-sonnet-20240620", temperature=0.0)
   
       # Create agent with browser session
       agent = Agent(
           task="Go to https://www.macrumors.com/contact.php and fill in the form. Make sure to use the selectors and submit the form",
           llm=llm,
           browser_session=browser_session,  # Pass browser_session directly
           enable_memory=False,
           max_failures=5,
           retry_delay=5,
           max_actions_per_step=1,  # Reduce actions per step for stability
       )
       
       try:
           result = await agent.run(max_steps=20)
           print(result)
       finally:
           try:
               # Properly close the browser session
               if browser_session.initialized:
                   await browser_session.stop()
           except Exception as e:
               print(f"Error closing browser session: {e}")
   
   if __name__ == "__main__":
       asyncio.run(main())
   

7. Run your script

   Run your script:

   uv run main.py
   

   You should see your Browserbase session start in Browserbase. The debug URL will be printed to console for real-time session monitoring.

   Important Environment Variables

   Make sure you have these environment variables in your .env file:

   • BROWSERBASE_API_KEY
   • BROWSERBASE_PROJECT_ID
   • ANTHROPIC_API_KEY

   Key Configuration Notes

   • Use BrowserSession directly instead of custom context classes
   • Set max_actions_per_step=1 for better stability with remote browsers
   • Use the debug URL to monitor your session in real-time
   • Increase timeouts to handle remote browser latency

   Common Issues & Fixes

   • If actions timeout, increase default_timeout and default_navigation_timeout
   • If browser context closes unexpectedly, ensure keep_alive=True in both BrowserProfile and BrowserSession
   • For troubleshooting, check the debug URL to see what’s happening in the browser
   • Reach out to us at [e-mail]