Skip to content

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

fix merge conflict in agents md

Alezander9830f8d64739a
diff --cc AGENTS.MD
index 360330f85,6b70ac5a7..da2850f48
--- a/AGENTS.MD
+++ b/AGENTS.MD
@@@ -29,91 -32,227 +32,255 @@@ uv syn
# Human Quickstart
Source: (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