Quickstart

pip install opperai
# or: uv add opperai

npm install opperai zod
# or: pnpm add opperai zod

import asyncio
from opperai.agent import Agent, tool

@tool
def add(a: int, b: int) -> int:
    """Add two numbers."""
    return a + b

@tool
def multiply(a: int, b: int) -> int:
    """Multiply two numbers."""
    return a * b

async def main() -> None:
    agent = Agent(
        name="math-agent",
        instructions="You are a helpful math assistant. Show the steps.",
        tools=[add, multiply],
    )

    result = await agent.run("What is 5 + 3, then multiplied by 2?")

    print("Output:", result.output)
    print("Iterations:", result.meta.iterations)
    print("Tokens:", result.meta.usage.total_tokens)

asyncio.run(main())

import { z } from "zod";
import { Agent, tool } from "opperai";

const add = tool({
  name: "add",
  description: "Add two numbers",
  parameters: z.object({ a: z.number(), b: z.number() }),
  execute: async ({ a, b }) => a + b,
});

const multiply = tool({
  name: "multiply",
  description: "Multiply two numbers",
  parameters: z.object({ a: z.number(), b: z.number() }),
  execute: async ({ a, b }) => a * b,
});

const agent = new Agent({
  name: "math-agent",
  instructions: "You are a helpful math assistant. Show the steps.",
  tools: [add, multiply],
});

const result = await agent.run("What is 5 + 3, then multiplied by 2?");

console.log("Output:", result.output);
console.log("Iterations:", result.meta.iterations);
console.log("Tokens:", result.meta.usage.totalTokens);

git clone https://github.com/opper-ai/opper-sdks
cd opper-sdks/python
uv run python examples/agents/00_first_agent.py

git clone https://github.com/opper-ai/opper-sdks
cd opper-sdks/typescript
npx tsx examples/agents/00-your-first-agent.ts