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
docs: focus on driving-test demo and use Luna directly through OpenAI
MagMuellercb66bf13131b
diff --git a/README.md b/README.mdindex 75956d890..587ff15aa 100644--- a/README.md+++ b/README.md@@ -43,36 +43,13 @@Browser Use gives AI agents a browser. Describe a task, and the agent navigates websites, fills forms, and gets the work done.-<table>- <tr>- <td width="50%" valign="top">- <a href="https://x.com/mathisdittrich/status/2078619618265141560"><img src="static/readme/driving-test.jpg" alt="Johannes's Browser Use V4 driving-test booking demo" width="100%"></a>- <h3>Book a driving test</h3>- <p>Find an available slot, handle the CAPTCHA, and schedule the test.</p>- <a href="https://x.com/mathisdittrich/status/2078619618265141560">Watch Johannes's demo ↗</a>- </td>- <td width="50%" valign="top">- <a href="https://browser-use.com/showcase/pick-adjacent-cinema-seats"><img src="static/readme/cinema-seats.jpg" alt="Browser Use selecting two adjacent seats on a cinema seat map" width="100%"></a>- <h3>Find cinema seats together</h3>- <p>Check the showtime, open the seat map, and select adjacent seats.</p>- <a href="https://browser-use.com/showcase/pick-adjacent-cinema-seats">Watch demo ↗</a>- </td>- </tr>- <tr>- <td width="50%" valign="top">- <a href="https://browser-use.com/showcase/clear-tetris-lines-in-17-seconds"><img src="static/readme/tetris.jpg" alt="Browser Harness playing Tetris from the live board" width="100%"></a>- <h3>Play Tetris in the browser</h3>- <p>Read the live board and clear 100 lines in 17 seconds.</p>- <a href="https://browser-use.com/showcase/clear-tetris-lines-in-17-seconds">Watch demo ↗</a>- </td>- <td width="50%" valign="top">- <a href="https://browser-use.com/showcase/export-portal-results-to-csv"><img src="static/readme/portal-to-csv.jpg" alt="Browser Use searching a certification portal before exporting results to CSV" width="100%"></a>- <h3>Turn a website into a CSV</h3>- <p>Search a portal, collect 50 matching products, and verify the export.</p>- <a href="https://browser-use.com/showcase/export-portal-results-to-csv">Watch demo ↗</a>- </td>- </tr>-</table>+### Book a driving test++Find an available slot, handle the CAPTCHA, and schedule the test with Browser Use V4.++[](https://x.com/mathisdittrich/status/2078619618265141560)++[Watch Johannes's demo ↗](https://x.com/mathisdittrich/status/2078619618265141560)[Explore more demos and prompts ↗](https://browser-use.com/showcase)@@ -155,14 +132,11 @@ uv add browser-use# or: pip install browser-use```-**2. Add your LLM API key to `.env`**. Get one from [Browser Use Cloud](https://cloud.browser-use.com/new-api-key?utm_source=github&utm_medium=readme-quickstart-api-key), or bring your own provider key:+**2. Add your [OpenAI API key](https://platform.openai.com/api-keys) to `.env`:**```bash# .env-BROWSER_USE_API_KEY=your-key-# GOOGLE_API_KEY=your-key-# ANTHROPIC_API_KEY=your-key-# OPENAI_API_KEY=your-key+OPENAI_API_KEY=your-key```**3. Run your first agent:**@@ -170,13 +144,15 @@ BROWSER_USE_API_KEY=your-key```pythonimport asyncio-from browser_use import Agent, ChatBrowserUse+from browser_use import Agent, ChatOpenAI+from dotenv import load_dotenv++load_dotenv()async def main():agent = Agent(task="Find the number of stars of the browser-use repo",- llm=ChatBrowserUse(model='openai/gpt-5.6-luna'),- # llm=ChatBrowserUse(model='bu-2-0-mini-preview'), # Browser Use's optimized model+ llm=ChatOpenAI(model='gpt-5.6-luna', reasoning_effort='xhigh'),)history = await agent.run()@@ -184,15 +160,6 @@ if __name__ == "__main__":asyncio.run(main())```-To use Luna directly through OpenAI with `xhigh` reasoning, set `OPENAI_API_KEY` and use:--```python-from browser_use import ChatOpenAI--llm = ChatOpenAI(model='gpt-5.6-luna', reasoning_effort='xhigh')-# Pass llm=llm to Agent(...).-```-Check out the [library docs](https://docs.browser-use.com/open-source/introduction) and the [cloud docs](https://docs.browser-use.com/cloud/quickstart) for more!<br/>@@ -267,7 +234,7 @@ Yes. `ChatBrowserUse` accepts provider-prefixed model ids, so a single `BROWSER_```pythonfrom browser_use import Agent, ChatBrowserUse-llm = ChatBrowserUse(model='openai/gpt-5.6-luna') # or 'anthropic/claude-sonnet-4-6', 'google/gemini-3-pro'+llm = ChatBrowserUse(model='anthropic/claude-sonnet-4-6') # or 'google/gemini-3-pro'agent = Agent(task='...', llm=llm)```diff --git a/static/readme/README.md b/static/readme/README.mdindex ee4bdfe43..a93d46850 100644--- a/static/readme/README.md+++ b/static/readme/README.md@@ -22,17 +22,14 @@ They were introduced in [SDK PR #241](https://github.com/browser-use/sdk/pull/24Keep the local/cloud routes and separate Profile Sync path aligned with the[product guide](https://docs.browser-use.com/cloud/which-product).-## Demo thumbnails+## Demo thumbnail| Local file | Published source || --- | --- || `driving-test.jpg` | [Johannes Dittrich's driving-test demo](https://x.com/mathisdittrich/status/2078619618265141560) |-| `cinema-seats.jpg` | [Cinema-seat selection](https://browser-use.com/showcase/pick-adjacent-cinema-seats) |-| `tetris.jpg` | [Tetris](https://browser-use.com/showcase/clear-tetris-lines-in-17-seconds), originally [Shawn's recording](https://x.com/shawn_pana/status/2047120626994012442) |-| `portal-to-csv.jpg` | [Portal results to CSV](https://browser-use.com/showcase/export-portal-results-to-csv) |-The README links to the playable public recordings. Keep poster images and-captions consistent with those recordings when updating them.+The README links to the playable public recording. Keep the poster and+caption consistent with that recording when updating them.`driving-test.jpg` is the 8-second frame of Johannes's public recording,showing the appointment-location selection. The personal contact fields arediff --git a/static/readme/cinema-seats.jpg b/static/readme/cinema-seats.jpgdeleted file mode 100644index 5f6f54e11..000000000Binary files a/static/readme/cinema-seats.jpg and /dev/null differdiff --git a/static/readme/portal-to-csv.jpg b/static/readme/portal-to-csv.jpgdeleted file mode 100644index 9adf175de..000000000Binary files a/static/readme/portal-to-csv.jpg and /dev/null differdiff --git a/static/readme/tetris.jpg b/static/readme/tetris.jpgdeleted file mode 100644index 95860324c..000000000Binary files a/static/readme/tetris.jpg and /dev/null differ