Installation

The Agent SDK ships inside the unified opperai package — there is no separate install.

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

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 opperai
print(opperai.__version__)