---
title: "OpenAI Agents SDK (JS): features, version and quickstart · DotsAgent"
description: "OpenAI Agents SDK (JS) by OpenAI: licence, latest version, MCP support, durable runs, human approval, tracing and evals, plus a quickstart to copy."
url: https://dotsagent.io/frameworks/openai-agents-js
---

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](https://github.com/openai/openai-agents-js) · 3,882 stars
- **Hosted option**: [OpenAI Agent Builder (AgentKit) + ChatKit](https://developers.openai.com/api/docs/guides/agent-builder)Agent Builder is deprecated and shuts down on 30 November 2026; ChatKit stays.

## 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.

`Install`

```
npm install @openai/agents zod
```

Needs OPENAI_API_KEY

`TypeScript`

```
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 in programming.',
);
console.log(result.finalOutput);
```

[Quickstart source](https://openai.github.io/openai-agents-js/)

## Features

| Any model | — | Non-OpenAI providers via @openai/agents-extensions |
| --- | --- | --- |
| MCP client | — | — |
| MCP server | — | — |
| Multi-agent | — | Handoffs and agents-as-tools |
| Durable runs | — | Serialisable run state, but no first-party durable engine |
| Human approval | — | — |
| Tracing | — | — |
| Evals | — | — |

## Recent changes

- Now requires Zod v4.
- Added sandbox agents (@openai/agents/sandbox) and realtime agents (@openai/agents/realtime).

## Alternatives in the same language

- [Claude Agent SDK](https://dotsagent.io/frameworks/claude-agent-sdk)

- [Google ADK](https://dotsagent.io/frameworks/google-adk)

- [LangGraph](https://dotsagent.io/frameworks/langgraph)

- [LlamaIndex](https://dotsagent.io/frameworks/llamaindex)

- [Mastra](https://dotsagent.io/frameworks/mastra)

- [Vercel AI SDK](https://dotsagent.io/frameworks/vercel-ai-sdk)

## Sources

1. [openai.github.io](https://openai.github.io/openai-agents-js/)/openai-agents-js/
2. [registry.npmjs.org](https://registry.npmjs.org/@openai%2fagents)/@openai%2fagents
3. [api.github.com](https://api.github.com/repos/openai/openai-agents-js)/repos/openai/openai-agents-js

Independent reference for people who build AI agents. Not affiliated with any vendor named here.

© 2026 DotsAgent · Facts checked October 1, 2026