# browser-use/browser-harness

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/browser-use-browser-harness).**

15,265 stars · 1,424 forks · Python · MIT

## Links

- GitHub: https://github.com/browser-use/browser-harness
- Homepage: https://browser-harness.com
- awesome-repositories: https://awesome-repositories.com/repository/browser-use-browser-harness.md

## Topics

`ai-agent` `browser-agent` `browser-automation` `browser-use` `browser-use-box` `browser-use-cloud` `cdp` `cloud-browser` `llm` `persistent-browser` `playwright` `telegram-agent` `vps-agent` `web-automation`

## Description

This project is an automation framework that connects large language models to web browsers via the Chrome DevTools Protocol for autonomous task execution. It functions as a bridge between intelligent agents and browser engines, allowing for the direct control of browser sessions and profiles.

The framework features a self-healing agent capable of generating and executing custom scripts during runtime to resolve failures and optimize browser tasks. It supports stealthy deployment through the use of integrated proxies and captcha solvers to bypass bot detection and security mitigations.

The system covers a wide range of capabilities including cloud-based headless browser management, remote session orchestration via authentication keys, and page state inspection through combined visual and DOM analysis. It also provides mechanisms for integrating site-specific logic and pre-defined skills from local workspaces to increase task reliability.

## Tags

### Artificial Intelligence & ML

- [Agentic Browser Controllers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-browser-controllers.md) — Functions as the primary bridge between an intelligent agent and a web browser for autonomous task completion. ([source](https://github.com/browser-use/browser-harness/blob/main/AGENTS.md))
- [Dynamic Helper Generation](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-automation-frameworks/operational-self-healing/dom-element-self-healing/dynamic-helper-generation.md) — Generates and executes custom scripts during runtime to overcome failures and optimize browser automation tasks.
- [Browser Automation Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/browser-automation-agents.md) — Acts as an intelligent agent capable of interacting with web browsers to complete autonomous tasks.
- [Self-Improving Automation Code](https://awesome-repositories.com/f/artificial-intelligence-ml/self-improving-agent-tutorials/self-improving-logic/self-improving-automation-code.md) — Enables a self-healing agent to write and execute new code to resolve failures and improve future task success. ([source](https://github.com/browser-use/browser-harness))
- [Skill Directory Configurations](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-skill-configurations/skill-directory-configurations.md) — Loads site-specific logic and pre-defined automation primitives from local directories to increase task reliability.

### Web Development

- [LLM-Driven Automation](https://awesome-repositories.com/f/web-development/browser-automation/llm-driven-automation.md) — Connects large language models to web browsers for autonomous navigation and complex task execution.
- [Browser Automation](https://awesome-repositories.com/f/web-development/browser-automation.md) — Provides a comprehensive framework for controlling headless browsers to perform autonomous web interactions. ([source](https://github.com/browser-use/browser-harness/blob/main/SKILL.md))
- [LLM Browser Connectivity](https://awesome-repositories.com/f/web-development/browser-automation-protocols/llm-browser-connectivity.md) — Provides the essential connectivity layer that allows language models to execute tasks via direct browser control. ([source](https://github.com/browser-use/browser-harness/blob/main/README.md))
- [Chrome DevTools Protocols](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-control-protocols/chrome-devtools-protocols.md) — Utilizes the Chrome DevTools Protocol for bidirectional communication and low-level control of the browser engine.
- [DevTools Protocol Clients](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-control-protocols/chrome-devtools-protocols/devtools-protocol-clients.md) — Functions as a DevTools Protocol client to manage browser sessions, profiles, and page interactions.
- [Stealth Configurations](https://awesome-repositories.com/f/web-development/browser-automation/stealth-configurations.md) — Deploys browser sessions with integrated proxies and captcha solvers to bypass bot detection and security mitigations.
- [Remote Browser Infrastructure Management](https://awesome-repositories.com/f/web-development/browser-integration-utilities/browser-infrastructure/remote-browser-infrastructure-management.md) — Orchestrates the deployment and scaling of headless browser instances in cloud environments. ([source](https://github.com/browser-use/browser-harness/blob/main/SKILL.md))
- [Session Orchestration Tools](https://awesome-repositories.com/f/web-development/session-orchestration-tools.md) — Manages the lifecycle and isolation of concurrent headless browser sessions on cloud servers.
- [Custom Automation Primitive Extensions](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-interaction-primitives/custom-automation-primitive-extensions.md) — Supports the development of custom scripts in local workspaces to build new browser automation primitives. ([source](https://github.com/browser-use/browser-harness/blob/main/AGENTS.md))
- [Cloud Browser Integrations](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-orchestration-systems/cloud-browser-integrations.md) — Bridges local LLM environments to remote cloud-hosted browser sessions using authentication keys.
- [Headless Browser Orchestrators](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-orchestration-systems/headless-browser-orchestrators.md) — Orchestrates isolated headless browser instances on cloud servers for background tasks and data extraction.
- [Remote Browser Connections](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-orchestration-systems/remote-browser-connections.md) — Implements interfaces to initialize and connect to remote cloud-hosted browser instances using authentication keys. ([source](https://github.com/browser-use/browser-harness/blob/main/.env.example))

### Content Management & Publishing

- [DOM State Inspection](https://awesome-repositories.com/f/content-management-publishing/page-insertion/text-page-generation/per-page-content-extractors/live-page-content-readers/dom-state-inspection.md) — Combines coordinate-based screenshots with DOM analysis to extract real-time page data and interface layouts.

### Development Tools & Productivity

- [Dynamic Automation Helper Generation](https://awesome-repositories.com/f/development-tools-productivity/task-automation-scripts/dynamic-automation-helper-generation.md) — Synthesizes new automation functions during runtime to overcome complex browser task requirements. ([source](https://github.com/browser-use/browser-harness/blob/main/README.md))
- [Browser Protocol Controllers](https://awesome-repositories.com/f/development-tools-productivity/custom-command-execution/hardware-command-execution/browser-protocol-controllers.md) — Allows the direct transmission of low-level CDP commands to the browser engine for advanced control. ([source](https://github.com/browser-use/browser-harness/blob/main/SKILL.md))

### Software Engineering & Architecture

- [Dynamic Automation Helper Generation](https://awesome-repositories.com/f/software-engineering-architecture/dynamic-scripting-runtimes/dynamic-automation-helper-generation.md) — Allows the system to create and execute custom scripts at runtime to resolve failures and optimize browser tasks.
- [Site-Specific Skill Integration](https://awesome-repositories.com/f/software-engineering-architecture/site-specific-extractors/site-specific-skill-integration.md) — Increases task reliability by loading site-specific logic and pre-defined skills from local workspaces. ([source](https://github.com/browser-use/browser-harness/blob/main/SKILL.md))

### Testing & Quality Assurance

- [Element Interaction](https://awesome-repositories.com/f/testing-quality-assurance/automation-interaction-tools/element-interaction.md) — Simulates user actions including coordinate-based clicks, iframe management, and page scrolling. ([source](https://github.com/browser-use/browser-harness/blob/main/SKILL.md))
- [Page State Analysis](https://awesome-repositories.com/f/testing-quality-assurance/general-testing-utilities/test-utilities-assertions/browser-ui-interaction/browser-environment-emulation/browser-page-management/page-state-analysis.md) — Analyzes the current DOM and visual state of a page to inform autonomous agent decision-making. ([source](https://github.com/browser-use/browser-harness/blob/main/SKILL.md))
- [LLM-Driven Frameworks](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/testing-frameworks/test-frameworks/browser-and-ui-testing/browser-automation-frameworks/llm-driven-frameworks.md) — Provides a framework where large language models determine the interaction sequences for browser automation.

### DevOps & Infrastructure

- [Stealth Headless Instance Management](https://awesome-repositories.com/f/devops-infrastructure/stealth-headless-instance-management.md) — Deploys invisible browser sessions with integrated proxy support and automated captcha solving to avoid detection. ([source](https://github.com/browser-use/browser-harness))

### Networking & Communication

- [Bot Detection Bypass](https://awesome-repositories.com/f/networking-communication/request-header-configuration/request-header-overrides/bot-detection-bypass.md) — Employs techniques to mimic legitimate human behavior and bypass automated bot detection systems.