openai-agents-js  by openai

JS/TS framework for multi-agent workflows and voice agents

created 2 months ago
925 stars

Top 40.3% on sourcepulse

GitHubView on GitHub
Project Summary

This SDK provides a framework for building multi-agent workflows and real-time voice agents using JavaScript and TypeScript. It's designed for developers looking to orchestrate complex AI interactions, integrate tools, and implement robust guardrails, offering features like streaming, tracing, and parallelization.

How It Works

The framework operates on an agent loop where LLMs are configured with instructions, tools, and guardrails. Agents can dynamically hand off control to other agents or execute tools. The SDK supports structured outputs, streaming responses, and built-in tracing for debugging. It aims for provider-agnosticism, with adapters for OpenAI and the Vercel AI SDK.

Quick Start & Requirements

  • Install: npm install @openai/agents
  • Prerequisites: Node.js 22 or later, Deno, or Bun. OPENAI_API_KEY environment variable required for OpenAI models.
  • Documentation: http://localhost:4321 (local dev server)

Highlighted Details

  • Supports multi-agent workflows, tool integration, and dynamic handoffs.
  • Features structured outputs, streaming responses, and built-in tracing.
  • Includes guardrails for input/output validation and parallelization capabilities.
  • Offers real-time voice agent support via WebRTC/Websockets and a separate browser package.

Maintenance & Community

The project acknowledges contributions from the open-source community, specifically mentioning zod, Starlight, vite, vitest, pnpm, and Next.js.

Licensing & Compatibility

The SDK is open-source, intended for community expansion. Specific license details are not explicitly stated in the README, but its open-source nature suggests broad compatibility for development and integration.

Limitations & Caveats

The SDK has experimental support for Cloudflare Workers. Features like "Long running functions" and a full "Voice pipeline" (chaining speech-to-text and text-to-speech) are still under development.

Health Check
Last commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
61
Issues (30d)
51
Star History
947 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Chris Van Pelt Chris Van Pelt(Cofounder of Weights & Biases), and
2 more.

agents by livekit

1.1%
7k
Voice AI agent framework for building realtime applications
created 1 year ago
updated 3 days ago
Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Steven Hao Steven Hao(Cofounder of Cognition), and
6 more.

openai-agents-python by openai

1.5%
13k
Python SDK for multi-agent workflows
created 4 months ago
updated 1 day ago
Feedback? Help us improve.