openai-agents-js

Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

Get the source so you can inspect, configure and run it locally.

git clone https://github.com/openai/openai-agents-js.git
cd openai-agents-js

Add the agents package and Zod to your Node.js 22+, Deno or Bun project.

npm install @openai/agents zod

Create an Agent with instructions and run it — see the README examples for text, sandbox and realtime variants.

import { Agent, run } from '@openai/agents';
const agent = new Agent({ name: 'Assistant', instructions: 'You are a helpful assistant.' });
const result = await run(agent, 'Write a haiku about recursion.');