> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the unified opperai SDK for Python or TypeScript

The Agent SDK ships inside the unified `opperai` package, so you don't install anything extra.

<CodeGroup>
  ```bash Python theme={null}
  pip install opperai
  # or
  uv add opperai
  # or
  poetry add opperai
  ```

  ```bash TypeScript theme={null}
  npm install opperai zod
  # or
  pnpm add opperai zod
  ```
</CodeGroup>

| Language   | Minimum runtime | Notes                                                                         |
| ---------- | --------------- | ----------------------------------------------------------------------------- |
| Python     | 3.10+           | Pydantic optional: `pip install opperai[pydantic]` for typed `output_schema`. |
| TypeScript | Node.js 18+     | Requires Zod v4 (`zod@4`). The `zod@3.25.x` dual-mode build is not supported. |

## API key

Set `OPPER_API_KEY` in the environment, or pass `client` config explicitly:

<CodeGroup>
  ```python Python theme={null}
  from opperai.agent import Agent

  agent = Agent(
      name="my-agent",
      instructions="Be helpful.",
      client={"api_key": "op-..."},
  )
  ```

  ```typescript TypeScript theme={null}
  import { Agent } from "opperai";

  const agent = new Agent({
    name: "my-agent",
    instructions: "Be helpful.",
    client: { apiKey: "op-..." },
  });
  ```
</CodeGroup>

Get a key at [platform.opper.ai](https://platform.opper.ai/).

## Verify

<CodeGroup>
  ```python Python theme={null}
  import opperai
  print(opperai.__version__)
  ```

  ```typescript TypeScript theme={null}
  import { Agent } from "opperai";
  console.log(typeof Agent); // "function"
  ```
</CodeGroup>

Next: [Quickstart](/agents/quickstart).