Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openbrowser.me/llms.txt

Use this file to discover all available pages before exploring further.

Connect your existing Chrome browser to preserve authentication.

​
Basic Example

from openbrowser import Agent, Browser, ChatOpenAI

# Connect to your existing Chrome browser
browser = Browser(
    executable_path='/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
    user_data_dir='~/Library/Application Support/Google/Chrome',
    profile_directory='Default',
)

agent = Agent(
    task='Visit https://duckduckgo.com and search for "openbrowser founders"',
    browser=browser,
    llm=ChatOpenAI(model='gpt-4.1-mini'),
)
async def main():
	await agent.run()
Note: You need to fully close chrome before running this example. Also, Google blocks this approach currently so we use DuckDuckGo instead.

​
How it Works

  1. executable_path - Path to your Chrome installation
  2. user_data_dir - Your Chrome profile folder (keeps cookies, extensions, bookmarks)
  3. profile_directory - Specific profile name (Default, Profile 1, etc.)

​
Platform Paths

# macOS
executable_path='/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'
user_data_dir='~/Library/Application Support/Google/Chrome'

# Windows
executable_path='C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
user_data_dir='%LOCALAPPDATA%\\Google\\Chrome\\User Data'

# Linux
executable_path='/usr/bin/google-chrome'
user_data_dir='~/.config/google-chrome'