Framework · OpenAI
OpenAI Agents SDK (JS) at a glance
The TypeScript and JavaScript port of OpenAI's Agents SDK, with the same agents, handoffs, approvals and tracing. It adds realtime voice agents that run in the browser over WebRTC, while the Temporal durability integration remains Python-only.
Best for: Node and TypeScript apps that want OpenAI's agent primitives, including realtime voice in the browser.
Key facts
- Maintainer
- OpenAI
- Languages
- TypeScript, JavaScript
- Licence
- MIT
- Latest version
0.18.0· September 10, 2026- Repository
- openai/openai-agents-js
- Hosted option
- OpenAI Agent Builder (AgentKit) + ChatKit
Quickstart
Install the package, set the credentials, then run the smallest agent from the official docs. Model IDs are the ones the docs use and may not be enabled on your account.
npm install @openai/agents zodimport { 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 in programming.',
);
console.log(result.finalOutput);Features
| Any model | Yes | Non-OpenAI providers via @openai/agents-extensions |
|---|---|---|
| MCP client | Yes | |
| MCP server | Not confirmed | |
| Multi-agent | Yes | Handoffs and agents-as-tools |
| Durable runs | Not confirmed | Serialisable run state, but no first-party durable engine |
| Human approval | Yes | |
| Tracing | Yes | |
| Evals | No |
Recent changes
- Now requires Zod v4.
- Added sandbox agents (@openai/agents/sandbox) and realtime agents (@openai/agents/realtime).