Skip to content

imlewc/browser-use

Repository files navigation

Load Session State from HAR Files | 从HAR文件加载会话状态

Browser-use supports loading session states and cookies from HAR (HTTP Archive) files, allowing AI agents to access websites in logged-in state.

浏览器使用(Browser-use)支持从HAR(HTTP Archive)文件加载会话状态和Cookie,使AI代理能够以登录状态访问网站。

# Load session from HAR file and execute custom tasks | 从HAR文件加载会话并执行自定义任务 python examples/features/load_from_har.py resource/har/xxx.har{after_login_prompt}
  • resource/har/xxx.har: Path to HAR file | HAR文件路径
  • {after_login_prompt}: Optional parameter, custom instructions after login | 可选参数,自定义登录后执行的指令

This feature allows you to easily reuse existing login states without manually logging in each time, greatly improving the efficiency of automated workflows.

这个功能让您能够轻松地复用已有的登录状态,而无需每次都手动登录账户,大大提高了自动化工作流的效率。


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

Enable AI to control your browser 🤖

GitHub starsDiscordCloudDocumentationTwitter FollowTwitter FollowWeave Badge

🌐 Browser-use is the easiest way to connect your AI agents with the browser.

💡 See what others are building and share your projects in our Discord! Want Swag? Check out our Merch store.

🌤️ Skip the setup - try our hosted version for instant browser automation! Try the cloud ☁︎.

Quick start

With pip (Python>=3.11):

pip install browser-use

Install Playwright:

playwright install chromium

Spin up your agent:

fromlangchain_openaiimportChatOpenAIfrombrowser_useimportAgentimportasynciofromdotenvimportload_dotenvload_dotenv() asyncdefmain(): agent=Agent( task="Compare the price of gpt-4o and DeepSeek-V3", llm=ChatOpenAI(model="gpt-4o"), ) awaitagent.run() asyncio.run(main())

Add your API keys for the provider you want to use to your .env file.

OPENAI_API_KEY= ANTHROPIC_API_KEY= AZURE_ENDPOINT= AZURE_OPENAI_API_KEY= GEMINI_API_KEY= DEEPSEEK_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/ui/gradio_demo.py

Demos



Task: Add grocery items to cart, and checkout.

AI Did My Groceries



Prompt: Add my latest LinkedIn follower to my leads in Salesforce.

LinkedIn to Salesforce



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.'

apply.to.jobs.8x.mp4



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: 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.

hugging_face_high_quality.mp4



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

Agent

  • Improve agent memory (summarize, compress, RAG, etc.)
  • Enhance planning capabilities (load website specific context)
  • Reduce token consumption (system prompt, DOM state)

DOM Extraction

  • Improve extraction for datepickers, dropdowns, special elements
  • Improve state representation for UI elements

Rerunning tasks

  • LLM as fallback
  • Make it easy to define workflow templates where LLM fills in the details
  • Return playwright script from the agent

Datasets

  • Create datasets for complex tasks
  • Benchmark various models against each other
  • Fine-tuning models for specific tasks

User Experience

  • Human-in-the-loop execution
  • 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. To contribute to the docs, check out the /docs folder.

Local Setup

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

main is the primary development branch with frequent changes. For production use, install a stable versioned release instead.


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.

Swag

Want to show off your Browser-use swag? Check out our Merch store. Good contributors will receive swag for free 👀.

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} }

Twitter FollowTwitter Follow

Made with ❤️ in Zurich and San Francisco

About

Make websites accessible for AI agents

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python90.6%
  • JavaScript9.4%