Skip to main content

Make websites accessible for AI agents

Project description

Shows a black Browser Use Logo in light color mode and a white one in dark color mode.

GitHub stars Discord Documentation Twitter Follow Twitter Follow

Enable AI to control your browser 🤖.

Browser use is the easiest way to connect your AI agents with the browser. If you have used Browser Use for your project feel free to show it off in our Discord.

To learn more about the library, check out the documentation 📕.

Quick start

With pip:

pip install browser-use

install playwright:

playwright install

Spin up your agent:

from langchain_openai import ChatOpenAI
from browser_use import Agent
import asyncio
from dotenv import load_dotenv
load_dotenv()

async def main():
    agent = Agent(
        task="Go to Reddit, search for 'browser-use' in the search bar, click on the first post and return the first comment.",
        llm=ChatOpenAI(model="gpt-4o"),
    )
    result = await agent.run()
    print(result)

asyncio.run(main())

And don't forget to add your API keys to your .env file.

OPENAI_API_KEY=

For other settings, models, and more, check out the documentation 📕.

Test with UI

You can test browser-use with a UI repository

Or simply run the gradio example:

uv pip install gradio
python examples/gradio.py

Demos

Prompt: Write a letter in Google Docs to my Papa, thanking him for everything, and save the document as a PDF.

Letter to Papa



Prompt: Read my CV & find ML jobs, save them to a file, and then start applying for them in new tabs, if you need help, ask me.'

https://github.com/user-attachments/assets/171fb4d6-0355-46f2-863e-edb04a828d04



Prompt: Find flights on kayak.com from Zurich to Beijing from 25.12.2024 to 02.02.2025.

flight search 8x 10fps



Prompt: Look up models with a license of cc-by-sa-4.0 and sort by most likes on Hugging face, save top 5 to file.

https://github.com/user-attachments/assets/de73ee39-432c-4b97-b4e8-939fd7f323b3

More examples

For more examples see the examples folder or join the Discord and show off your project.

Vision

Tell your computer what to do, and it gets it done.

Roadmap

  • Improve memory management
  • Enhance planning capabilities
  • Improve self-correction
  • Fine-tune the model for better performance
  • Create datasets for complex tasks
  • Sandbox browser-use for specific websites
  • Implement deterministic script rerun with LLM fallback
  • Cloud-hosted version
  • Add stop/pause functionality
  • Improve authentication handling
  • Reduce token consumption
  • Implement long-term memory
  • Handle repetitive tasks reliably
  • Third-party integrations (Slack, etc.)
  • Include more interactive elements
  • Human-in-the-loop execution
  • Benchmark various models against each other
  • Let the user record a workflow and browser-use will execute it
  • Improve the generated GIF quality
  • Create various demos for tutorial execution, job application, QA testing, social media, etc.

Contributing

We love contributions! Feel free to open issues for bugs or feature requests.

Local Setup

To learn more about the library, check out the local setup 📕.

Cooperations

We are forming a commission to define best practices for UI/UX design for browser agents. Together, we're exploring how software redesign improves the performance of AI agents and gives these companies a competitive advantage by designing their existing software to be at the forefront of the agent age.

Email Toby to apply for a seat on the committee.

Citation

If you use Browser Use in your research or project, please cite:

@software{browser_use2024,
  author = {Müller, Magnus and Žunič, Gregor},
  title = {Browser Use: Enable AI to control your browser},
  year = {2024},
  publisher = {GitHub},
  url = {https://github.com/browser-use/browser-use}
}

Made with ❤️ in Zurich and San Francisco

Email me

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

browser_use-0.1.27.tar.gz (294.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

browser_use-0.1.27-py3-none-any.whl (69.2 kB view details)

Uploaded Python 3

File details

Details for the file browser_use-0.1.27.tar.gz.

File metadata

  • Download URL: browser_use-0.1.27.tar.gz
  • Upload date:
  • Size: 294.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for browser_use-0.1.27.tar.gz
Algorithm Hash digest
SHA256 8fac46652009f6ee2a7a5a3d75c575d8f232a013f597c9a1f55ebbf0d9158404
MD5 1b9413c61abf14c51a008b4a09227476
BLAKE2b-256 d8fa932596ad604c306f5027516b1ee71cd433ed5a259668c567c7bba02b4135

See more details on using hashes here.

File details

Details for the file browser_use-0.1.27-py3-none-any.whl.

File metadata

  • Download URL: browser_use-0.1.27-py3-none-any.whl
  • Upload date:
  • Size: 69.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for browser_use-0.1.27-py3-none-any.whl
Algorithm Hash digest
SHA256 8a76c87ebbfdc75fbd1963e82739756a74e86573b9fc1e00d40434dfd27fc314
MD5 3cb9ac60fc0648712efd595a274630ea
BLAKE2b-256 e01e47aa461fadfaa19391814625157406c4cfa90664bccc43108d2cc69aea99

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page