{"data":{"slug":"hyperbrowserai-hyperagent","name":"HyperAgent","tagline":"AI Browser Automation","github_url":"https://github.com/hyperbrowserai/HyperAgent","owner":"hyperbrowserai","repo":"HyperAgent","owner_avatar_url":"https://avatars.githubusercontent.com/u/189776885?v=4","primary_language":"TypeScript","stars":1573,"forks":209,"topics":["agent","ai","automation","chrome","llm","playwright","web"],"archived":false,"github_pushed_at":"2026-05-11T21:41:09+00:00","maintenance_label":"Slowing","stars_delta_30d":48,"url":"https://www.graphcanon.com/tools/hyperbrowserai-hyperagent","markdown_url":"https://www.graphcanon.com/tools/hyperbrowserai-hyperagent.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/hyperbrowserai-hyperagent","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=hyperbrowserai-hyperagent","description":"AI Browser Automation","homepage_url":"https://www.hyperbrowser.ai/","license":"Other","open_issues":26,"watchers":6,"ai_summary":"HyperAgent is an AI tool for automating tasks in the web browser using Playwright and LLMs.","readme_excerpt":"<div align=\"center\">\n  <img src=\"assets/hyperagent-banner.png\" alt=\"Hyperagent Banner\" width=\"800\"/>\n\n  <p align=\"center\">\n    <strong>Intelligent Browser Automation with LLMs</strong>\n  </p>\n\n  <p align=\"center\">\n    <a href=\"https://www.npmjs.com/package/@hyperbrowser/agent\">\n      <img src=\"https://img.shields.io/npm/v/@hyperbrowser/agent?style=flat-square\" alt=\"npm version\" />\n    </a>\n    <a href=\"https://github.com/hyperbrowserai/hyperagent/blob/main/LICENSE\">\n      <img src=\"https://img.shields.io/npm/l/@hyperbrowser/agent?style=flat-square\" alt=\"license\" />\n    </a>\n    <a href=\"https://discord.gg/zsYzsgVRjh\" style=\"text-decoration:none;\">\n      <img alt=\"Discord\" src=\"https://img.shields.io/discord/1313014141165764619?style=flat-square&color=blue\">\n    </a>\n    <a href=\"https://x.com/AkshayShekhaw12\">\n      <img alt=\"X (formerly Twitter) Follow\" src=\"https://img.shields.io/twitter/follow/AkshayShekhaw12?style=social\">\n    </a>\n  </p>\n</div>\n\n## Overview\n\nHyperagent is Playwright supercharged with AI. No more brittle scripts, just powerful natural language commands.\nJust looking for scalable headless browsers or scraping infra? Go to [Hyperbrowser](https://app.hyperbrowser.ai/) to get started for free!\n\nView HyperAgent docs here: https://www.hyperbrowser.ai/docs/hyperagent/introduction\n\n### Features\n\n- 🤖 **AI Commands**: Simple APIs like `page.ai()`, `page.extract()` and `executeTask()` for any AI automation\n- ⚡ **Fallback to Regular Playwright**: Use regular Playwright when AI isn't needed\n- 🥷 **Stealth Mode** – Avoid detection with built-in anti-bot patches\n- ☁️ **Cloud Ready** – Instantly scale to hundreds of sessions via [Hyperbrowser](https://app.hyperbrowser.ai/)\n- 🔌 **MCP Client** – Connect to tools like Composio for full workflows (e.g. writing web data to Google Sheets)\n- 📼 **Action Caching** – Record and replay workflows deterministically without LLM calls\n\n## Quick Start\n\n### Installation\n\n```bash\n# Using npm\nnpm install @hyperbrowser/agent\n\n# Using yarn\nyarn add @hyperbrowser/agent\n```\n\n### CLI\n\n```bash\n$ npx @hyperbrowser/agent -c \"Find a route from Miami to New Orleans, and provide the detailed route information.\"\n```\n\n<p align=\"center\">\n  <img src=\"assets/flight-schedule.gif\" alt=\"Hyperagent Demo\"/>\n</p>\n\nThe CLI supports options for debugging or using hyperbrowser instead of a local browser\n\n```bash\n-d, --debug                       Enable debug mode\n-c, --command <task description>  Command to run\n--hyperbrowser                    Use Hyperbrowser for the browser provider\n```\n\n### Library\n\n```typescript\nimport { HyperAgent } from \"@hyperbrowser/agent\";\nimport { z } from \"zod\";\n\n// Initialize the agent\nconst agent = new HyperAgent({\n  llm: {\n    provider: \"openai\",\n    model: \"gpt-4o\",\n  },\n});\n\n// Execute a task\nconst result = await agent.executeTask(\n  \"Navigate to amazon.com, search for 'laptop', and extract the prices of the first 5 results\"\n);\nconsole.log(result.output);\n\n// Use page.ai, page.perform, and page.extract\nconst page = await agent.newPage();\nawait page.goto(\"https://flights.google.com\", { waitUntil: \"load\" });\nawait page.ai(\"search for flights from Rio to LAX from July 16 to July 22\");\nawait page.perform(\"click the search button\");\nconst res = await page.extract(\n  \"give me the flight options\",\n  z.object({\n    flights: z.array(\n      z.object({\n        price: z.number(),\n        departure: z.string(),\n        arrival: z.string(),\n      })\n    ),\n  })\n);\nconsole.log(res);\n\n// Clean up\nawait agent.closeAgent();\n```\n\n## Two Modes of Operation\n\nHyperAgent provides two complementary APIs optimized for different use cases:\n\n### 🎯 `page.perform()` - Single Granular Actions\n\n> `page.aiAction()` is deprecated and remains available as an alias; prefer `page.perform()` going forward.\n\n**Best for**: Single, specific actions like \"click login\", \"fill email with test@example.com\"\n\n**Advantages**:\n- ⚡ **Fast** - Uses accessibility tree (no screenshots)\n- 💰 **Cheap** - Single LLM call per action","github_created_at":"2025-04-14T05:02:59+00:00","created_at":"2026-07-15T10:55:28.278623+00:00","updated_at":"2026-09-20T04:52:20.262489+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"llm-frameworks","name":"LLM Frameworks","url":"https://www.graphcanon.com/categories/llm-frameworks","markdown_url":"https://www.graphcanon.com/categories/llm-frameworks.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/llm-frameworks"}],"tags":[{"slug":"agent","name":"agent"},{"slug":"ai","name":"ai"},{"slug":"automation","name":"automation"},{"slug":"chrome","name":"chrome"},{"slug":"llm","name":"llm"},{"slug":"playwright","name":"playwright"},{"slug":"web","name":"web"}],"trust":{"provenance":{"is_fork":false,"github_id":965900067,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T04:52:17.345Z","maintenance":{"label":"Slowing","score":36,"methodology":"github_public_v1","releases_90d":0,"days_since_push":131,"last_release_at":"2025-11-19T00:17:41Z","stars_delta_30d":48,"open_issues_delta_30d":0},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-15T10:55:29.553Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"mcp":{"source":"package.json:@modelcontextprotocol/*","observed_at":"2026-09-20T04:52:18.401Z","server_manifest":true},"scan":{"source":"repo_scan","observed_at":"2026-09-20T04:52:18.401Z"},"has_cli":{"value":true,"source":"package.json:bin|scripts","observed_at":"2026-09-20T04:52:18.401Z"},"languages":{"value":["typescript","javascript"],"source":"github.language+package.json","observed_at":"2026-09-20T04:52:18.401Z"},"license_spdx":{"value":"Other","source":"github.license","observed_at":"2026-09-20T04:52:18.401Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["When you need to integrate advanced AI-driven decisions into your web automation workflows","If your project requires precise control over Chrome and other browsers via TypeScript"],"when_not_to_use":["Avoid if the project does not require browser-based tasks or interactivity with websites","Do not use HyperAgent if you prefer native Python tools for browser automation, as it uses TypeScript"],"source":"enrich:decision_facts","observed_at":"2026-07-17T08:12:15.675Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"HyperAgent automates browser tasks using Playwright and LLMs."}]}}