Self-hosted TypeScript agent runtime with durable approvals and verifiable run records. Own it, approve it, audit it.

Open Multi‑Agent (OMA)

정의 – LLM 기반 에이전트 컬렉션을 구축, 실행, 감사할 수 있는 자체 호스팅 TypeScript 런타임입니다. 소유권, 감사 가능성, 인간 개입 제어에 중점을 둡니다: 원격 측정(telemetry)이 없고, 호스팅 제어 평면이 없으며, 사용자가 직접 API 키와 모델(OpenAI, Anthropic, 로컬 Ollama 등)을 제공합니다.

핵심 개념

기능	설명
팀 오케스트레이션	`runTeam()`은 높은 수준의 목표를 받아, 내장 코디네이터가 작업 그래프로 분할하고, 에이전트를 할당하며, 계획을 실행합니다.
단일 에이전트 및 파이프라인 모드	`runAgent()`는 하나의 에이전트를 실행하고; `runTasks()`는 사용자가 정의한 명시적 시퀀스를 실행합니다.
지속적 승인	실행은 계획, 작업 또는 도구 호출 전에 일시 중지될 수 있으며, 재시작 후에도 유지되는 인간 승인을 기다립니다.
검증 가능한 실행 저널	모든 모델 입력, 도구 호출, 출력이 기록됩니다; `verifyRun()`은 오프라인에서 일관성을 확인할 수 있습니다.
거버넌스 기준	필수 역할과 순서를 선언하고; 실행 후 거버넌스 규칙이 충족되었는지 검사할 수 있습니다.
이그레스 정책	`offline` 또는 허용 목록을 선택하고; 런타임은 외부 모델 호출 전에 정책을 강제합니다.
자체 호스팅	순수 라이브러리 – 자체 서비스, 컨테이너 또는 서버리스 함수 내에서 실행합니다.
관찰 가능성	선택적 OpenTelemetry 어댑터; 내장 오프라인 Run Viewer는 작업 DAG, 토큰 사용량, 도구 호출을 보여줍니다.

시작하기 (README에서)

사전 요구 사항 – Node.js 20+ (LTS 권장).
스타터 앱 생성
```
npm create oma-app@latest my-oma
```
이 명령은 템플릿 선택을 안내하고, 종속성을 설치하며, 스크립트된 모델 응답을 사용하는 결정적 데모를 실행합니다 (API 키 불필요).

기존 프로젝트에 OMA 추가

npm install @open-multi-agent/core

import { OpenMultiAgent } from '@open-multi-agent/core'

const oma = new OpenMultiAgent({ defaultProvider: 'openai', defaultModel: 'gpt-5.4' })
const team = oma.createTeam('research-team', {
  name: 'research-team',
  agents: [
    { name: 'researcher', systemPrompt: 'Find the relevant facts.' },
    { name: 'analyst',   systemPrompt: 'Compare evidence and identify tradeoffs.' }
  ],
  sharedMemory: true,
})
const result = await oma.runTeam(team, 'Compare three approaches and recommend one.')
console.log(result.agentResults.get('coordinator')?.output)

실제 모델을 사용하려면 OPENAI_API_KEY (또는 다른 공급자 키)를 설정하세요.

주요 통합 및 사용자

PR‑Copilot – OMA 기반 AI 풀 리퀘스트 리뷰어.
StuFlow – OMA 워크플로를 구동하는 터미널 코딩 어시스턴트.
Engram – 에이전트 간 지식을 동기화하는 "AI 메모리용 Git".
OrchestrAI – PostgreSQL에 체크포인트를 저장하는 시각적 작업 공간.
다양한 중국 모델 어댑터 – DeepSeek, Doubao, Hunyuan 등.

패키지

@open-multi-agent/core – 주요 런타임, 도구, 메모리, 승인, 저널, CLI, 오프라인 Run Viewer.
@open-multi-agent/otel – 선택적 OpenTelemetry 내보내기.
create-oma-app – npm create oma-app에서 사용하는 스캐폴딩 CLI.

문서 및 리소스

웹사이트 및 문서 – https://open-multi-agent.com
예제 – packages/core/examples/
전체 문서 색인 – docs/README.md
프로덕션 체크리스트, run-viewer, 거버넌스, 이그레스 정책 등은 모두 저장소의 docs/ 폴더에 포함되어 있습니다.

라이선스 및 후원

라이선스 – MIT.
유지 관리자 – YuanASI (Shenzhen YuanASI Technology Co., Ltd.).
스폰서 – Atlas Cloud가 크레딧을 제공합니다; 후원은 기술 결정에 영향을 미치지 않습니다.

결론 – OMA는 강력한 감사, 승인, 거버넌스 기능을 갖춘 LLM 에이전트 오케스트레이션을 위한 완전 오픈 소스, 자체 호스팅 프레임워크로, 키, 모델, 데이터에 대한 제어가 필요한 기업에 적합합니다.

open-multi-agent/open-multi-agent