Skip to main content
HyperAgent is an open-source browser automation framework that extends Playwright with AI capabilities. Write natural language commands instead of complex selectors, and let HyperAgent handle the tedious parts of web automation.

GitHub Repository

View source code

npm Package

Install node SDK

Templates

View curated list of templates

The Challenge with Browser Automation

Browser automation tools like Puppeteer and Playwright offer powerful functionality for scripting clicks, typing, scrolling, and more. But they require you to understand the DOM structure and locate elements through HTML attributes, CSS selectors, or complex XPath queries. This gets harder fast:
  • Selectors break when websites update their markup
  • Iframes isolate content, requiring nested queries to reach elements inside them
  • Shadow DOM encapsulation makes elements even harder to access
  • Dynamic content means selectors that worked yesterday might fail today
You end up spending more time maintaining selectors than building features.

What HyperAgent Does

HyperAgent lets you describe what you want in plain English. The AI figures out how to interact with the page—no matter how the DOM is structured.
HyperAgent handles iframes, shadow DOM, and dynamic content automatically. When a site changes, your automation keeps working.

Core Methods

page.ai()

Execute complex multi-step tasks with natural language

page.perform()

Fast, single-action execution

page.extract()

Pull structured data with Zod schemas

Playwright Compatible

Use standard Playwright when you need deterministic control

Key Features

Describe the element in natural language. HyperAgent finds it regardless of DOM structure, iframes, or shadow DOM.
Record your automation once, replay it without LLM calls. Deterministic execution at a fraction of the cost.
Use OpenAI, Anthropic, Google Gemini. Switch providers with one line of code.
Run locally for development, scale to hundreds of sessions with Hyperbrowser in production.
Native Chrome DevTools Protocol integration for precise coordinates, deep iframe tracking, and automatic ad filtering.

Get Started

Quickstart

Build your first automation