> ## Documentation Index
> Fetch the complete documentation index at: https://stagehand-stg-1784.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Computer Use Agents

> Incorporate Computer Use APIs from Anthropic and OpenAI with one line of code in Stagehand.

## What is a Computer Use Agent?

<iframe width="100%" height="400" src="https://www.youtube.com/embed/ODaHJzOyVCQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

You might've heard of [Claude Computer Use](https://www.anthropic.com/news/3-5-models-and-computer-use) or [OpenAI's Computer Using Agent](https://openai.com/index/computer-using-agent/).

These are powerful tools that can convert natural language into actions on the computer. However, you'd otherwise need to write your own code to convert these actions into Playwright commands.

Stagehand not only handles the execution of Computer Use outputs, but also lets you hot-swap between OpenAI and Anthropic models with one line of code.

## How to use a Computer Use Agent in Stagehand

Stagehand lets you use Computer Use Agents with one line of code:

<Note>
  **IMPORTANT! Configure your browser dimensions**

  Computer Use Agents will often return XY-coordinates to click on the screen, so you'll need to configure your browser dimensions.

  If not specified, the default browser dimensions are 1024x768. You can also configure the browser dimensions in the `browserbaseSessionCreateParams` or `localBrowserLaunchOptions` options.
</Note>

### Configuring browser dimensions

Browser configuration differs by environment:

<Tabs>
  <Tab title="BROWSERBASE">
    <CodeGroup>
      ```typescript TypeScript theme={null}
      import { Stagehand } from "@browserbasehq/stagehand";

      const stagehand = new Stagehand({
      	env: "BROWSERBASE",
        	apiKey: process.env.BROWSERBASE_API_KEY /* API key for authentication */,
          projectId: process.env.BROWSERBASE_PROJECT_ID /* Project identifier */,
        
          browserbaseSessionCreateParams: {
            projectId: process.env.BROWSERBASE_PROJECT_ID!,
            browserSettings: {
      		blockAds: true,
              viewport: {
                width: 1024,
                height: 768,
              },
            },
        	},
      });

      await stagehand.init();
      ```

      ```python Python theme={null}
      import os
      from stagehand import Stagehand, StagehandConfig

      stagehand = Stagehand(StagehandConfig(
          env="BROWSERBASE",
          api_key=os.getenv("BROWSERBASE_API_KEY"),  # API key for authentication
          project_id=os.getenv("BROWSERBASE_PROJECT_ID"),  # Project identifier
          
          browserbase_session_create_params={
              "projectId": os.getenv("BROWSERBASE_PROJECT_ID"),
              "browserSettings": {
                  "blockAds": True,
                  "viewport": {
                      "width": 1024,
                      "height": 768,
                  },
              },
          },
      ))

      await stagehand.init()
      ```
    </CodeGroup>
  </Tab>

  <Tab title="LOCAL">
    <CodeGroup>
      ```typescript TypeScript theme={null}
      import { Stagehand } from "@browserbasehq/stagehand";

      const stagehand = new Stagehand({
        env: "LOCAL",
        localBrowserLaunchOptions: {
          headless: false,
          viewport: {
            width: 1024,
            height: 768,
          },
        }
      });

      await stagehand.init();
      ```

      ```python Python theme={null}
      from stagehand import Stagehand, StagehandConfig

      stagehand = Stagehand(StagehandConfig(
          env="LOCAL",
          local_browser_launch_options={
              "headless": False,
              "viewport": {
                  "width": 1024,
                  "height": 768,
              },
          }
      ))

      await stagehand.init()
      ```
    </CodeGroup>
  </Tab>
</Tabs>

### Direct your Computer Use Agent

Call `execute` on the agent to assign a task to the agent.

<CodeGroup>
  ```typescript TypeScript theme={null}
  // Navigate to a website
  await stagehand.page.goto("https://www.google.com");

  const agent = stagehand.agent({
  	// You can use either OpenAI or Anthropic
  	provider: "anthropic",
  	// The model to use (computer-use-preview for OpenAI)
  	model: "claude-sonnet-4-20250514",

  	// Customize the system prompt
  	instructions: `You are a helpful assistant that can use a web browser.
  	Do not ask follow up questions, the user will trust your judgement.`,

  	// Customize the API key
  	options: {
  		apiKey: process.env.ANTHROPIC_API_KEY,
  	},
  });

  // Execute the agent
  await agent.execute("Apply for a library card at the San Francisco Public Library");
  ```

  ```python Python theme={null}
  import os

  # Navigate to a website
  await stagehand.page.goto("https://www.google.com")

  agent = stagehand.agent({
      # The model to use
      model="computer-use-preview",

      # Customize the system prompt
      instructions="You are a helpful assistant that can use a web browser. Do not ask follow up questions, the user will trust your judgement.",

      # Customize the API key
      options={
          "apiKey": os.getenv("ANTHROPIC_API_KEY"),
      },
  })

  # Execute the agent
  await agent.execute("Apply for a library card at the San Francisco Public Library")
  ```
</CodeGroup>

You can also define the maximum number of steps the agent can take with:

<CodeGroup>
  ```typescript TypeScript theme={null}
  await agent.execute({
  	instructions: "Apply for a library card at the San Francisco Public Library",
  	maxSteps: 10,
  });
  ```

  ```python Python theme={null}
  await agent.execute(
  	"Apply for a library card at the San Francisco Public Library",
  	max_steps=10,
  )
  ```
</CodeGroup>

<Callout icon="code" color="#6ec202" iconType="regular">View or run the example templates [here](https://www.browserbase.com/templates?category=Computer+Use+Agents)</Callout>