> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-pricing-docs-rework.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Real Browser

> Connect to your existing Chrome browser to preserve login sessions, cookies, and extensions for authenticated tasks.

This allows you to automate your existing Chrome browser, so you are already logged into your websites.

<Warning>
  You may need to fully close Chrome before running these examples. Additionally, if Google search blocks automated browsers, use DuckDuckGo or other search engines instead.
</Warning>

## Basic Example

```python theme={null}
import asyncio
from browser_use import Agent, Browser, ChatOpenAI

# Auto-selects first available Chrome profile
browser = Browser.from_system_chrome()

agent = Agent(
    task='Visit https://duckduckgo.com and search for "browser-use founders"',
    browser=browser,
    llm=ChatOpenAI(model='gpt-4.1-mini'),
)

async def main():
    await agent.run()

if __name__ == "__main__":
    asyncio.run(main())
```

## Choosing a Profile

Chrome supports multiple profiles. List and select the one you want:

```python theme={null}
from browser_use import Browser

# List available profiles
profiles = Browser.list_chrome_profiles()
for p in profiles:
    print(f"{p['directory']}: {p['name']}")
# Output:
# Profile 1: Work
# Profile 5: Personal

# Use a specific profile
browser = Browser.from_system_chrome(profile_directory='Profile 5')
```

## Manual Path Configuration

If auto-detection does not work, specify paths manually:

```python theme={null}
browser = Browser(
    executable_path='/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
    user_data_dir='~/Library/Application Support/Google/Chrome',
    profile_directory='Default',
)
```

## How it Works

`Browser.from_system_chrome()` automatically detects:

| Platform | Executable Path                                                | User Data Directory                           |
| -------- | -------------------------------------------------------------- | --------------------------------------------- |
| macOS    | `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome` | `~/Library/Application Support/Google/Chrome` |
| Windows  | `C:\Program Files\Google\Chrome\Application\chrome.exe`        | `%LocalAppData%\Google\Chrome\User Data`      |
| Linux    | `/usr/bin/google-chrome` or `/usr/bin/chromium`                | `~/.config/google-chrome`                     |