Practical overview
When it fits
Use it when an application already works with OpenAI assistants and needs a manager to coordinate specialized assistants from a Node.js client.
Who it is for
- Developers building workflows around OpenAI assistants.
- Teams organizing assistant responsibilities into specialized agents and coordinating their work.
Documented uses
- Route a prompt to assistants whose configured responsibilities match its tasks.
- Run independent delegated subtasks in parallel.
- Handle responses and actions from delegated assistant tasks through a manager interface.
Requirements & limits
The project is publicly available on GitHub under the MIT license. The documented setup uses the OpenAI Node.js SDK and an API key.
- Integration is documented as an extension to the OpenAI Node.js SDK, not as a standalone hosted workspace.
- Delegation depends on relevant specialized assistants being available in the OpenAI assistant registry.
- The README says streaming is not available yet and mentions event listeners as an approach for waiting on delegated results.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the swarm manager with the OpenAI Node.js SDK
Install the documented packages, extend an OpenAI client with swarm abilities, and initialize the manager.
Before you start
- Node.js project using the OpenAI Node.js SDK
- OpenAI API key
Steps
Install the
openaipackage with npm or Yarn.Install
@mintplex-labs/openai-assistant-swarmwith npm or Yarn.Create an OpenAI client using an API key, then call
EnableSwarmAbilitieswith that client.Initialize the manager with
OpenAIClient.beta.assistants.swarm.init().
Expected outcome
The OpenAI client is extended with the swarm manager interface, which the README says makes swarm management functions available after initialization.
Guide limitations
- The documented example says streaming is not available yet.
- This setup guide does not cover creating or configuring specialized assistants.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- Mintplex-Labs/openai-assistant-swarm · Official homepage title · retained in its source language

