Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
fix merge conflict in agents md
Alezander9830f8d64739a
diff --cc AGENTS.MDindex 360330f85,6b70ac5a7..da2850f48--- a/AGENTS.MD+++ b/AGENTS.MD@@@ -29,91 -32,227 +32,255 @@@ uv syn# Human QuickstartSource: (go to or request this content to learn more) https://docs.browser-use.com/quickstart- ## 1. Fast setup+ To get started with Browser Use you need to install the package and create an `.env` file with your API key.- <Tabs>- <Tab title="uv">- ```bash create environment theme={null}- uv venv --python 3.12- ```- </Tab>+ <Note icon="key" color="#FFC107" iconType="regular">+ `ChatBrowserUse` offers the [fastest and most cost-effective models](https://browser-use.com/posts/speed-matters/), completing tasks 3-5x faster. Get started with $10 of [free LLM credits](https://cloud.browser-use.com/new-api-key).+ </Note>- <Tab title="pip">- ```bash create environment with python >= 3.11 theme={null}- python3.12 -m venv .venv- ```- </Tab>+ ## 1. Installing Browser-Use++ <Tabs>+ <Tab title="uv">+ ```bash create environment+ uv venv --python 3.12+ ```+ ```bash activate environment+ source .venv/bin/activate+ ```+ ```bash install browser-use & chromium+ uv pip install browser-use+ uvx playwright install chromium --with-deps+ # Note: this does NOT install playwright, only chromium+ ```+ </Tab>+ <Tab title="pip">+ ```bash create environment with python >= 3.11+ python3.12 -m venv .venv+ ```+ ```bash activate environment+ source .venv/bin/activate+ ```+ ```bash install browser-use & chromium+ pip install browser-use+ pip install playwright && playwright install chromium --with-deps+ ```+ </Tab></Tabs>-<Info>On Windows, use `.venv\Scripts\activate` to activate the environment.</Info>+<Tabs>+ <Tab title="Mac/Linux">+ ```bash activate environment theme={null}+ source .venv/bin/activate+ ```+ </Tab>++ <Tab title="Windows">+ ```bash activate environment theme={null}+ .venv\Scripts\activate+ ```+ </Tab>+</Tabs>++<Tabs>+ <Tab title="uv">+ ```bash install browser-use & chromium theme={null}+ uv pip install browser-use+ uvx browser-use install+ ```+ </Tab>++ <Tab title="pip">+ ```bash install browser-use & chromium theme={null}+ pip install browser-use+ uvx browser-use install+ ```+ </Tab>+</Tabs>## 2. Choose your favorite LLM+ Create a `.env` file and add your API key.- Create a `.env` file and add your API key. Don't have one? Start with a [free Gemini key](https://aistudio.google.com/app/u/1/apikey?pli=1).+ <Callout icon="key" iconType="regular">+ We recommend using ChatBrowserUse which is optimized for browser automation tasks (highest accuracy + fastest speed + lowest token cost). Don't have one? We give you **$10** to try it out [here](https://cloud.browser-use.com/new-api-key).+ </Callout>- <Tabs>- <Tab title="Mac/Linux">- ```bash create .env file theme={null}- touch .env- ```- </Tab>+ ```bash .env+ touch .env+ ```- <Tab title="Windows">- ```cmd create .env file theme={null}- echo. > .env- ```- </Tab>- </Tabs>+ <Info>On Windows, use `echo. > .env`</Info>- <Tabs>- <Tab title="Google">- ```bash add your key to .env file theme={null}- GEMINI_API_KEY=- ```- </Tab>+ Then add your API key to the file.- <Tab title="OpenAI">- ```bash add your key to .env file theme={null}- OPENAI_API_KEY=- ```- </Tab>+ <CodeGroup>+ ```bash Browser Use+ # add your key to .env file+ BROWSER_USE_API_KEY=+ # Get 10$ of free credits at https://cloud.browser-use.com/new-api-key+ ```+ ```bash Google+ # add your key to .env file+ GOOGLE_API_KEY=+ # Get your free Gemini API key from https://aistudio.google.com/app/u/1/apikey?pli=1.+ ```+ ```bash OpenAI+ # add your key to .env file+ OPENAI_API_KEY=+ ```+ ```bash Anthropic+ # add your key to .env file+ ANTHROPIC_API_KEY=+ ```+ </CodeGroup>- <Tab title="Anthropic">- ```bash add your key to .env file theme={null}- ANTHROPIC_API_KEY=- ```- </Tab>+ See [Supported Models](/supported-models) for more.++ ## 3. Run your first agent++ <CodeGroup>+ ```python Browser Use+ from browser_use import Agent, ChatBrowserUse+ from dotenv import load_dotenv+ import asyncio++ load_dotenv()++ async def main():+ llm = ChatBrowserUse()+ task = "Find the number 1 post on Show HN"+ agent = Agent(task=task, llm=llm)+ await agent.run()++ if __name__ == "__main__":+ asyncio.run(main())+ ```+ ```python Google+ from browser_use import Agent, ChatGoogle+ from dotenv import load_dotenv+ import asyncio++ load_dotenv()++ async def main():+ llm = ChatGoogle(model="gemini-flash-latest")+ task = "Find the number 1 post on Show HN"+ agent = Agent(task=task, llm=llm)+ await agent.run()++ if __name__ == "__main__":+ asyncio.run(main())+ ```+ ```python OpenAI+ from browser_use import Agent, ChatOpenAI+ from dotenv import load_dotenv+ import asyncio++ load_dotenv()++ async def main():+ llm = ChatOpenAI(model="o3")+ task = "Find the number 1 post on Show HN"+ agent = Agent(task=task, llm=llm)+ await agent.run()++ if __name__ == "__main__":+ asyncio.run(main())+ ```+ ```python Anthropic+ from browser_use import Agent, ChatAnthropic+ from dotenv import load_dotenv+ import asyncio++ load_dotenv()++ async def main():+ llm = ChatAnthropic(model='claude-sonnet-4-0', temperature=0.0)+ task = "Find the number 1 post on Show HN"+ agent = Agent(task=task, llm=llm)+ await agent.run()++ if __name__ == "__main__":+ asyncio.run(main())+ ```+ </CodeGroup>++ <Note> Custom browsers can be configured in one line. Check out <a href = "customize/browser/basics">browsers</a> for more. </Note>+ To get started with Browser Use you need to install the package and create an `.env` file with your API key.++ <Note icon="key" color="#FFC107" iconType="regular">+ `ChatBrowserUse` offers the [fastest and most cost-effective models](https://browser-use.com/posts/speed-matters/), completing tasks 3-5x faster. Get started with $10 of [free LLM credits](https://cloud.browser-use.com/new-api-key).+ </Note>++ ## 1. Installing Browser-Use++ <Tabs>+ <Tab title="uv">+ ```bash create environment+ uv venv --python 3.12+ ```+ ```bash activate environment+ source .venv/bin/activate+ ```+ ```bash install browser-use & chromium+ uv pip install browser-use+ uvx playwright install chromium --with-deps+ # Note: this does NOT install playwright, only chromium+ ```+ </Tab>+ <Tab title="pip">+ ```bash create environment with python >= 3.11+ python3.12 -m venv .venv+ ```+ ```bash activate environment+ source .venv/bin/activate+ ```+ ```bash install browser-use & chromium+ pip install browser-use+ pip install playwright && playwright install chromium --with-deps+ ```+ </Tab></Tabs>- See [Supported Models](/customize/supported-models) for more.+ <Info>On Windows, use `.venv\Scripts\activate` to activate the environment.</Info>++ ## 2. Choose your favorite LLM+ Create a `.env` file and add your API key.++ <Callout icon="key" iconType="regular">+ We recommend using ChatBrowserUse which is optimized for browser automation tasks (highest accuracy + fastest speed + lowest token cost). Don't have one? We give you **$10** to try it out [here](https://cloud.browser-use.com/new-api-key).+ </Callout>++ ```bash .env+ touch .env+ ```++ <Info>On Windows, use `echo. > .env`</Info>++ Then add your API key to the file.++ <CodeGroup>+ ```bash Browser Use+ # add your key to .env file+ BROWSER_USE_API_KEY=+ # Get 10$ of free credits at https://cloud.browser-use.com/new-api-key+ ```+ ```bash Google+ # add your key to .env file+ GOOGLE_API_KEY=+ # Get your free Gemini API key from https://aistudio.google.com/app/u/1/apikey?pli=1.+ ```+ ```bash OpenAI+ # add your key to .env file+ OPENAI_API_KEY=+ ```+ ```bash Anthropic+ # add your key to .env file+ ANTHROPIC_API_KEY=+ ```+ </CodeGroup>++ See [Supported Models](/supported-models) for more.## 3. Run your first agent