Quickstart

import { HyperAgent } from "@hyperbrowser/agent";

async function main() {
  // Initialize the agent
  const agent = new HyperAgent({
    llm: {
      provider: "openai",
      model: "gpt-5.1",
    },
  });

  // Create a new browser page
  const page = await agent.newPage();

  // Navigate and automate
  await page.goto("https://news.ycombinator.com");
  
  const result = await page.ai(
    "Find the top story and tell me the title and point count"
  );

  console.log(result.output);

  // Remember to close the agent when you're done, otherwise the session will stay open.
  await agent.closeAgent();
}

main();

npx tsx demo.ts

npx @hyperbrowser/agent -c "Go to google.com and search for 'best pizza in NYC'"

await page.ai("search for flights from Miami to LAX, select the cheapest option");

await page.perform("click the login button");
await page.perform("fill email with user@example.com");

import { z } from "zod";

const data = await page.extract(
  "get the product details",
  z.object({
    name: z.string(),
    price: z.number(),
    rating: z.number(),
  })
);

const page = await agent.newPage();
await page.goto("https://amazon.com");

// Fast, single-action execution
await page.perform("click the search box");
await page.perform("type 'mechanical keyboard'");
await page.perform("press Enter");

// AI handles the complex part
await page.ai("search for keyboards under $100");

// Extract structured data
const product = await page.extract(
  "Select the first product from the search results",
  z.object({
    name: z.string(),
    price: z.number(),
    rating: z.number(),
  })
);

console.log(product);

const agent = new HyperAgent({
  browserProvider: "Hyperbrowser", // That's it!
});