# @openai/agents > The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows. Latest version **0.21.0** (published 2026-10-20) · MIT license · 0 weekly downloads ## Install ```sh npm install @openai/agents pnpm add @openai/agents yarn add @openai/agents bun add @openai/agents ``` ## Health **Score 70/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score. Warnings: low downloads; pre 1.0. ## Facts | | | |---|---| | Version | 0.21.0 | | Published | 2026-10-20 | | First published | 2025-06-03 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 4 | | Unpacked size | 23.1 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 3985 | | Author | OpenAI | | Maintainers | openai-publisher, tino-openai, dylan-hurd-openai, moustafa-openai, tylersmith-openai, mdangelo-openai, victor-openai, jbeckwith-oai, wadih-openai, atty-openai, tibo-openai, dkundel-openai, mbolin-openai, fouad-openai, easong-openai, aibrahim-openai, apcha-oai, seratch-openai | | Keywords | openai, agents, ai, agentic | ## Links - npm: https://www.npmjs.com/package/@openai/agents - Repository: https://github.com/openai/openai-agents-js - Homepage: https://openai.github.io/openai-agents-js/ - npm.io page: https://npm.io/package/@openai/agents ## Dependencies (4) - [openai](https://npm.io/package/openai.md) ^7.2.0 - [@openai/agents-core](https://npm.io/package/@openai/agents-core.md) 0.21.0 - [@openai/agents-openai](https://npm.io/package/@openai/agents-openai.md) 0.21.0 - [@openai/agents-realtime](https://npm.io/package/@openai/agents-realtime.md) 0.21.0 ## Alternatives - [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads - [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads - [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads - [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads - [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads ## Recent versions - 0.21.0 (latest) — 2026-10-20 - 0.20.0 — 2026-10-08 - 0.19.0 — 2026-10-05 - 0.18.0 — 2026-09-10 - 0.17.2 — 2026-09-08 - 0.17.1 — 2026-09-08 - 0.17.0 — 2026-08-19 - 0.16.1 — 2026-08-16 - 0.16.0 — 2026-08-15 - 0.15.0 — 2026-08-11 - 0.14.3 — 2026-08-05 - 0.14.2 — 2026-08-01 - 0.14.1 — 2026-07-29 - 0.14.0 — 2026-07-28 - 0.13.5 — 2026-07-17 - … 92 more at https://npm.io/package/@openai/agents/versions ## README # OpenAI Agents SDK (JavaScript/TypeScript) [![npm version](https://badge.fury.io/js/@openai%2Fagents.svg)](https://badge.fury.io/js/@openai%2Fagents) [![CI](https://github.com/openai/openai-agents-js/actions/workflows/test.yml/badge.svg)](https://github.com/openai/openai-agents-js/actions/workflows/test.yml) The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows in JavaScript/TypeScript. It is provider-agnostic, supporting OpenAI APIs and more. Image of the Agents Tracing UI > [!NOTE] Looking for the Python version? Check out [OpenAI Agents SDK Python](https://github.com/openai/openai-agents-python). ## Core concepts 1. [**Agents**](https://openai.github.io/openai-agents-js/guides/agents): LLMs configured with instructions, tools, guardrails, and handoffs 1. [**Sandbox Agents**](https://openai.github.io/openai-agents-js/guides/sandbox-agents): Agents paired with a filesystem workspace and sandbox environment for longer-running work 1. [**Realtime Agents**](https://openai.github.io/openai-agents-js/guides/voice-agents/quickstart/): Low-latency agents for spoken interactions, with tools, guardrails, handoffs, and conversation history 1. **[Agents as tools](https://openai.github.io/openai-agents-js/guides/tools/#4-agents-as-tools) / [Handoffs](https://openai.github.io/openai-agents-js/guides/handoffs/)**: Delegating to other agents for specific tasks 1. [**Tools**](https://openai.github.io/openai-agents-js/guides/tools/): Various Tools let agents take actions (functions, MCP, hosted tools) 1. [**Guardrails**](https://openai.github.io/openai-agents-js/guides/guardrails/): Configurable safety checks for input and output validation 1. [**Human in the loop**](https://openai.github.io/openai-agents-js/guides/human-in-the-loop/): Built-in mechanisms for involving humans across agent runs 1. [**Sessions**](https://openai.github.io/openai-agents-js/guides/sessions/): Automatic conversation history management across agent runs 1. [**Tracing**](https://openai.github.io/openai-agents-js/guides/tracing/): Built-in tracking of agent runs, allowing you to view, debug and optimize your workflows Explore the [`examples/`](https://github.com/openai/openai-agents-js/tree/main/examples) directory to see the SDK in action. ## Get started ### Supported environments - Node.js 22 or later - Deno - Bun #### Experimental support: - Cloudflare Workers with `nodejs_compat` enabled [Check out the documentation](https://openai.github.io/openai-agents-js/guides/troubleshooting/) for more detailed information. ### Installation ```bash npm install @openai/agents zod ``` ### Build a text agent Use a regular [Agent](https://openai.github.io/openai-agents-js/guides/agents) for text-based workflows that do not need a sandbox workspace or Realtime session. ```js 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); ``` ### Build a sandbox agent Use a [Sandbox Agent](https://openai.github.io/openai-agents-js/guides/sandbox-agents) when the agent should work in a filesystem, run commands, or carry workspace state across longer tasks. This example uses `UnixLocalSandboxClient`, which is supported on macOS and Linux. On Windows, use `DockerSandboxClient` or a hosted sandbox client instead; see [Sandbox clients](https://openai.github.io/openai-agents-js/guides/sandbox-agents/clients) for setup details. ```js import { run } from '@openai/agents'; import { gitRepo, SandboxAgent } from '@openai/agents/sandbox'; import { UnixLocalSandboxClient } from '@openai/agents/sandbox/local'; const agent = new SandboxAgent({ name: 'Workspace Assistant', model: 'gpt-5.5', instructions: 'Inspect the repo before changing files.', defaultManifest: { entries: { repo: gitRepo({ repo: 'openai/openai-agents-js' }) }, }, }); const result = await run( agent, 'Inspect the repo README and summarize what this project does.', { sandbox: { client: new UnixLocalSandboxClient() } }, ); console.log(result.finalOutput); ``` ### Build a realtime agent Use a [Realtime Agent](https://openai.github.io/openai-agents-js/guides/voice-agents/quickstart/) for low-latency, spoken interactions in the browser. ```js import { RealtimeAgent, RealtimeSession } from '@openai/agents/realtime'; const agent = new RealtimeAgent({ name: 'Assistant', instructions: 'You are a helpful assistant.', }); // Automatically connects your microphone and audio output in the browser via WebRTC. const session = new RealtimeSession(agent); await session.connect({ apiKey: '' }); ``` Set `OPENAI_API_KEY` in your server environment for text and sandbox agents. For browser-based realtime agents, use your server to create a short-lived ephemeral client token and pass it to `session.connect(...)`. Explore the [`examples/`](https://github.com/openai/openai-agents-js/tree/main/examples) directory to see the SDK in action. ## Acknowledgements We'd like to acknowledge the excellent work of the open-source community, especially: - [zod](https://github.com/colinhacks/zod) (schema validation) - [Starlight](https://github.com/withastro/starlight) - [vite](https://github.com/vitejs/vite) and [vitest](https://github.com/vitest-dev/vitest) - [pnpm](https://pnpm.io/) - [Next.js](https://github.com/vercel/next.js) We're committed to building the Agents SDK as an open source framework so others in the community can expand on our approach. For more details, see the [documentation](https://openai.github.io/openai-agents-js) or explore the [`examples/`](https://github.com/openai/openai-agents-js/tree/main/examples) directory. --- _Source: https://npm.io/package/@openai/agents · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._