Installation

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

pip install opperai
# or
uv add opperai
# or
poetry add opperai

npm install opperai zod
# or
pnpm add opperai zod

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:

from opperai.agent import Agent

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

import { Agent } from "opperai";

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

import opperai
print(opperai.__version__)

import { Agent } from "opperai";
console.log(typeof Agent); // "function"

⌘I