OpenAI Realtime Agents

Stale
GitHub TypeScript MIT

Description

A demonstration of advanced agentic patterns built on top of OpenAI's Realtime API, showcasing real-time voice interaction and multi-agent collaboration.

Key Features

  • Chat-Supervisor pattern: lightweight realtime chat agent handles basic tasks while a more intelligent text-based supervisor model handles complex tool calls
  • Sequential Handoff pattern: specialized agents transfer users between them to handle specific intents, inspired by OpenAI Swarm
  • Built on OpenAI Agents SDK with unified agent orchestration, state management, and event handling
  • Low-latency streaming voice interactions via OpenAI Realtime API
  • Extensible multi-agent collaboration with guardrails, handoffs, and tool use
  • Configurable decision boundary allowing gradual migration from text to realtime agents

Use Cases

💡 Customer service voice agents that handle routine queries with a chat agent and escalate complex issues to specialist supervisors
💡 Prototyping multi-agent realtime voice applications in under 20 minutes using the Sequential Handoff pattern
💡 Building voice-enabled AI assistants that combine fast conversational responses with high-intelligence tool calling
💡 Gradually migrating existing text-based chat agents to voice by reusing prompts and tools for the supervisor layer

Strengths & Limitations

Strengths

  • High community interest (7.0k stars)
  • Permissive open-source license (MIT)
  • Responsive to issues, low backlog

⚠️ Limitations

  • No updates in over 7 months

Quick Start

1. Clone the repo and install dependencies with `npm i`
2. Add your OPENAI_API_KEY to `.env` (copy from `.env.sample`)
3. Run `npm run dev` and open http://localhost:3000
4. Select a scenario from the top-right dropdown to try Chat-Supervisor or Sequential Handoff patterns

Related Projects

MetaGPT

69.9k · Python
Stale B

The Multi-Agent Framework for building the first AI Software Company, enabling natural language programming with multi-role collaboration for automated requirement analysis, design, coding, and testing.

multi-agentframeworkpython +2
  • · Multi-role collaboration - Built-in product manager, architect, engineer roles simulating a full software company SOP pipeline
  • · Natural language programming - Input a one-line requirement to auto-generate user stories, competitive analysis, API design, and complete code
  • · Data Interpreter - Dynamic code generation and data analysis for CSV processing, visualization, and exploratory tasks

Shannon

2.2k · Go
Active A

Shannon is a production-oriented multi-agent orchestration framework built in Go, focusing on efficient and reliable agent coordination and task scheduling for enterprise-grade multi-agent systems.

multi-agentframeworkgo +2
  • · Production-grade multi-agent orchestration with 8 execution strategies — Simple, DAG, ReAct, Research, Exploratory, Browser Use, Domain Analysis, and Swarm — auto-routed by task complexity
  • · Temporal workflow engine with time-travel debugging — replay any agent execution step-by-step for full observability and post-mortem analysis
  • · Hard token budget control per task/agent with automatic model fallback and cost optimization — research strategy reduces costs 50-70%

LazyLLM

3.9k · Python
Active A+

LazyLLM is a lightweight multi-agent LLM application framework offering the easiest way to build multi-agent LLM apps, with built-in RAG, knowledge graph, fine-tuning, and integration with LangChain and LlamaIndex ecosystems.

multi-agentframeworkrag +3
  • · Low-code multi-agent application assembly with built-in data flow and functional modules like Lego blocks
  • · One-click deployment with lightweight gateway for POC and Kubernetes packaging for production
  • · Cross-platform compatibility across bare-metal, Slurm clusters, and public clouds without code changes

Related Articles