​
Join the Browser Use Community!

We’re thrilled you’re interested in contributing to Browser Use! This guide will help you get started with contributing to our project. Your contributions are what make the open-source community such an amazing place to learn, inspire, and create.

​
Quick Setup

Get started with Browser Use development in minutes:

git clone https://github.com/browser-use/browser-use
cd browser-use
uv sync --all-extras --dev
# or pip install -U git+https://github.com/browser-use/browser-use.git@main

echo "BROWSER_USE_LOGGING_LEVEL=debug" >> .env

For more detailed setup instructions, see our Local Setup Guide.

​
How to Contribute

​
Find Something to Work On

​
Making a Great Pull Request

When submitting a pull request, please:

  • Include a clear description of what the PR does and why it’s needed
  • Add tests that cover your changes
  • Include a demo screenshot/gif or an example script demonstrating your changes
  • Make sure the PR passes all CI checks and tests
  • Keep your PR focused on a single issue or feature to make it easier to review

Note: We appreciate quality over quantity. Instead of submitting small typo/style-only PRs, consider including those fixes as part of larger bugfix or feature PRs.

​
Contribution Process

  1. Fork the repository
  2. Create a new branch for your feature or bugfix
  3. Make your changes
  4. Run tests to ensure everything works
  5. Submit a pull request
  6. Respond to any feedback from maintainers
  7. Celebrate your contribution!

Feel free to bump your issues/PRs with comments periodically if you need faster feedback.

​
Code of Conduct

We’re committed to providing a welcoming and inclusive environment for all contributors. Please be respectful and constructive in all interactions.

​
Getting Help

If you need help at any point:

We’re here to help you succeed in contributing to Browser Use!