HyperAgent

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Node.js 与 npm（该项目为 npm 包 @hyperbrowser/agent）
• 可选：yarn 包管理器
• 使用云端/规模化能力时需 Hyperbrowser 账号与 API Key
• 可访问 https://www.hyperbrowser.ai/docs/hyperagent/introduction 查看完整文档

安装与启动步骤

1. 1准备 Node 环境

   HyperAgent 是 TypeScript 项目、以 npm 包形式发布，需先在本机装好 Node.js 与 npm，用 node -v 和 npm -v 确认可用。

   node -v
   npm -v

   复制

2. 2安装 HyperAgent 包

   在项目目录下通过 npm 安装官方包 @hyperbrowser/agent，装完后依赖会出现在 node_modules 中。

   npm install @hyperbrowser/agent

   复制

3. 3或用 yarn 安装

   若项目使用 yarn，可改用 yarn 添加同一个包。README 中 yarn 命令被截断，此处沿用同一包名。

   yarn add @hyperbrowser/agent

   复制

4. 4获取 Hyperbrowser 凭证

   README 提示可前往 Hyperbrowser 控制台免费开通，用于云端会话与规模化能力；本地纯 Playwright 场景可不用。

5. 5查阅官方使用文档

   README 的 Usage Guide 内容缺失，实际 API 用法（如 page.ai()、page.extract()、executeTask()）请以官方文档为准。

如何确认成功

安装命令执行无报错，node_modules 下出现 @hyperbrowser/agent 目录，即可在代码中导入该包。

常见问题

注意事项

• 本次 README 节选缺少 Usage Guide 与 yarn 命令后半段，涉及 API Key 名称、初始化代码等细节请以官方文档为准，不要凭猜测填写。
• HyperAgent 基于 Playwright，使用前建议确认浏览器依赖在目标环境可正常安装。
• 追求稳定复现的流程可结合 README 提到的 Action Caching 能力，减少 LLM 调用。