https://github.com/gregpr07/browser-use Skip to content Navigation Menu Toggle navigation Sign in * Product + GitHub Copilot Write better code with AI + Security Find and fix vulnerabilities + Actions Automate any workflow + Codespaces Instant dev environments + Issues Plan and track work + Code Review Manage code changes + Discussions Collaborate outside of code + Code Search Find more, search less Explore + All features + Documentation + GitHub Skills + Blog * Solutions By company size + Enterprises + Small and medium teams + Startups By use case + DevSecOps + DevOps + CI/CD + View all use cases By industry + Healthcare + Financial services + Manufacturing + Government + View all industries View all solutions * Resources Topics + AI + DevOps + Security + Software Development + View all Explore + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Enterprise + Enterprise platform AI-powered developer platform Available add-ons + Advanced Security Enterprise-grade security features + GitHub Copilot Enterprise-grade AI features + Premium Support Enterprise-grade 24/7 support * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up Reseting focus You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} gregpr07 / browser-use Public * Notifications You must be signed in to change notification settings * Fork 7 * Star 156 License MIT license 156 stars 7 forks Branches Tags Activity Star Notifications You must be signed in to change notification settings * Code * Issues 0 * Pull requests 0 * Actions * Projects 0 * Security * Insights Additional navigation options * Code * Issues * Pull requests * Actions * Projects * Security * Insights gregpr07/browser-use main BranchesTags [ ] Go to file Code Folders and files Name Name Last commit Last commit message date Latest commit History 120 Commits .vscode .vscode examples examples src src static static .env.example .env.example .gitattributes .gitattributes .gitignore .gitignore .python-version .python-version LICENSE LICENSE README.md README.md conftest.py conftest.py instruction.md instruction.md pyproject.toml pyproject.toml pytest.ini pytest.ini requirements.txt requirements.txt setup.py setup.py View all files Repository files navigation * README * MIT license Browser-Use Open-Source Web Automation with LLMs GitHub stars License: MIT Python 3.11+ Let LLMs interact with websites naturally Key Features * Live Demos * Quick Start * Examples * Models --------------------------------------------------------------------- Live Demos Watch Browser-Use tackle real-world tasks: Kayak flight search demo Prompt: Go to kayak.com and find a one-way flight from Zurich to San Francisco on 12 January 2025. Photos search demo Prompt: Opening new tabs and searching for images for these people: Albert Einstein, Oprah Winfrey, Steve Jobs. Then ask me for further instructions. Key Features * Universal LLM Support - Works with any Language Model * Smart Element Detection - Automatically finds interactive elements * Multi-Tab Management - Seamless handling of browser tabs * XPath Extraction - No more manual DevTools inspection * [?] Vision Model Support - Process visual page information * [?] Customizable Actions - Add your own browser interactions Quick Start Create a virtual environment and install the dependencies: # I recommend using uv pip install -r requirements.txt Add your API keys to the .env file. cp .env.example .env You can use any LLM model that is supported by LangChain by adding correct environment variables. Head over to the langchain models page to see all available models. Examples from src import Agent from langchain_openai import ChatOpenAI # Initialize browser agent agent = Agent( task='Find cheapest flight from London to Kyrgyzstan and return the url.', llm=ChatOpenAI(model='gpt-4o'), ) # Let it work its magic await agent.run() Chain of Agents You can persist the browser across multiple agents and chain them together. from langchain_anthropic import ChatAnthropic from src import Agent, Controller # Persist the browser state across agents controller = Controller() # Initialize browser agent agent1 = Agent( task='Open 5 VCs websites in the New York area.', llm=ChatAnthropic(model_name='claude-3-sonnet', timeout=25, stop=None, temperature=0.3), controller=controller, ) agent2 = Agent( task='Give me the names of the founders of the companies in all tabs.', llm=ChatAnthropic(model_name='claude-3-sonnet', timeout=25, stop=None, temperature=0.3), controller=controller, ) # Let it work its magic await agent1.run() founders, history = await agent2.run() print(founders) You can use the history to run the agents again deterministically. Simple Run You can run any of the examples using the command line interface: python examples/try.py "Your query here" --provider [openai|anthropic] Anthropic You need to add ANTHROPIC_API_KEY to your environment variables. Example usage: python examples/try.py "Find cheapest flight from London to Paris" --provider anthropic OpenAI You need to add OPENAI_API_KEY to your environment variables. Example usage: python examples/try.py "Search for top AI companies" --provider openai Supported Models All LangChain chat models are supported. Tested * GPT-4o * GPT-4o Mini * Claude 3.5 Sonnet * LLama 3.1 405B Contributing Contributions are welcome! Also feel free to open issues for any bugs or feature requests. --------------------------------------------------------------------- Star this repo if you find it useful! Made with [?] by the Browser-Use team Future Roadmap * [*] Save agent actions and execute them deterministically (for QA testing etc) * [ ] Pydantic forced output * [ ] Third party SERP API for faster Google Search results About No description, website, or topics provided. Resources Readme License MIT license Activity Stars 156 stars Watchers 1 watching Forks 7 forks Report repository Releases No releases published Packages 0 No packages published Contributors 2 * * Languages * Python 100.0% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.