Practical overview
When it fits
Use OMA when an agent workflow needs self-hosted operation, durable human approval, restartable execution, or offline verification of recorded run content.
Who it is for
- Engineering teams building agent workflows in their own environment.
- Organizations that need human approval before consequential agent actions.
- Developers using cloud providers or local model servers such as Ollama, vLLM, or llama-server.
- Teams that need run lineage and content verification outside a hosted control plane.
Documented uses
- Orchestrate single agents, explicit task pipelines, and teams from a goal.
- Pause plans, task dispatches, or consequential tool calls until an approval is recorded.
- Persist checkpoints and pending approvals so runs can resume after a restart.
- Record and verify model context, tool activity, results, and context rewrites offline.
- Evaluate governance receipts against required roles and dependency order.
Requirements & limits
The repository is public and licensed under MIT. The documented setup requires Node.js 20 or newer; the repository recommends a currently maintained Node.js LTS release for production. A live provider example requires `OPENAI_API_KEY`, while the documented local demo uses no API key and makes no model request.
- Self-hosting: OMA is described as having no hosted control plane or telemetry, with operators controlling keys, models, and runtime infrastructure.
- Model choice: the repository names cloud providers, OpenAI-compatible endpoints, AI SDK providers, Ollama, vLLM, and llama-server as supported model environments.
- Approval durability: suspended requests are stored beside checkpoints and bound to a SHA-256 hash of the reviewer-visible content.
- Verification scope: offline journal verification checks byte-for-byte reproduction and reports an evicted context window as inconclusive.
- Governance evaluation: required roles and execution order can be assessed through an execution receipt, and a run may succeed while still reporting
unsatisfied.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Scaffold a local OMA starter project
Create an OMA application and run its documented deterministic local demo.
Before you start
- Node.js 20 or newer.
- An interactive terminal.
- The npm package tooling used by the documented scaffold command.
Steps
Run the command below.
npm create oma-app@latest my-omaSelect a starter and runtime when prompted.
Allow the scaffold to install dependencies and run the deterministic local demo.
Expected outcome
A starter OMA application is scaffolded and its local demo exercises the scheduler, result aggregation, and offline dashboard without an API key or model request.
Guide limitations
- The documented demo uses scripted model responses and does not demonstrate a live provider or model connection.
- The source does not provide setup details for each supported local model environment.
Add OMA to an existing backend with checkpointed execution
Configure the documented core runtime example with a provider, an approval policy, and a durable file checkpoint.
Before you start
- Node.js 20 or newer.
- The
@open-multi-agent/corepackage. - An OpenAI API key for the provider shown in the example.
- An existing TypeScript backend.
Steps
Install
@open-multi-agent/core.Create an
OpenMultiAgentinstance with the documented provider and model settings.Set consequential tool calls to suspend for a human decision.
Create a team and run it with a
FileStorecheckpoint path.
Expected outcome
The backend starts a checkpointed team run whose consequential tool calls can remain suspended pending reviewer decisions.
Guide limitations
- The example uses an OpenAI provider and requires
OPENAI_API_KEY; other providers and local servers are covered separately by the repository documentation. - The source does not provide a complete approval-review interface or deployment procedure in the supplied material.
Compare options for Agent orchestration
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| OMA (Open Multi-Agent) | Orchestrate single agents, explicit task pipelines, and teams from a goal. | CLI, Self-hosted, Server | The repository is public and licensed under MIT. The documented setup requires Node.js 20 or newer; the repository recommends a currently maintained Node.js LTS release for production. A live provider example requires `OPENAI_API_KEY`, while the documented local demo uses no API key and makes no model request. |
| Agenite | Define typed tools with JSON Schema validation and error handling. | CLI | |
| Veldra | Create an agent with a policy, tools, skills, knowledge base and reasoning method. | Self-hosted | The documented deployment is self-hosted and uses a sign-in gate after a first-run administrator account is created. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 2 October 2026
- Original website title
- open-multi-agent/open-multi-agent · Official homepage title · retained in its source language

