Repolode
jigjoy-ai

jigjoy-ai/mozaik

AI 에이전트가 하나의 공간에 참여해 이벤트에 반응하고, 서로를 막지 않으면서 동시에 실행되는 TypeScript 런타임입니다.

스타
166
포크
18
열린 이슈
4
마지막 커밋
10시간 전

어떤 프로젝트인가요?

Mozaik은 이벤트 버스를 공유하는 AI 에이전트를 구축하기 위한 TypeScript 런타임입니다. 사람, 에이전트, 옵서버 같은 참여자가 런타임에 들어와 메시지나 사용자 지정 신호 같은 이벤트를 게시하고, 명세와 프로세서를 짝지은 상황 핸들러를 통해 이에 반응합니다.

각 에이전트의 턴은 메시지 수신, 모델 추론, 도구 호출, 최종 답변을 아우르는 상태 머신으로 실행됩니다. runLoop 호출은 fire-and-forget 방식이므로 여러 에이전트가 동시에 사고하고 도구를 사용할 수 있습니다. 선택 사항인 인터셉션 핸들러는 다음 상태가 실행되기 전에 이를 검사하거나 다시 작성할 수 있어, 사람이나 다른 에이전트가 루프의 진행 방향을 조정할 수 있습니다.

이 패키지는 npm에서 @mozaik-ai/core라는 이름으로 배포됩니다. 공급자는 runInference에 전달된 모델 이름을 기준으로 선택되며, OpenAI, Anthropic, Gemini 인증 정보는 환경 변수에서 읽습니다. DeepSeek은 OpenAI 호환 엔드포인트를 통해 사용할 수 있습니다.

핵심 기능

  • 01참여자(사람, 에이전트, 옵서버)는 공유 런타임에 들어와 SpaceEvents를 주고받습니다.
  • 02에이전트 루프는 동시에 실행되며, 각 루프에는 고유한 loopId가 있습니다.
  • 03상황 명세와 프로세서를 사용하면 폴링 없이 에이전트가 이벤트에 반응할 수 있습니다.
  • 04추론, 스트리밍, 도구 호출, 모델 답변을 처리하는 루프 상태가 기본 제공됩니다.
  • 05인터셉션 핸들러는 다음 루프 전환이 실행되기 전에 이를 다시 작성할 수 있습니다.
  • 06RuntimeState 하위 클래스를 통해 공유 상태의 타입을 지정합니다.

활용 사례

  • 여러 에이전트가 같은 목표를 위해 실시간으로 협업하는 멀티 에이전트 시스템 구축.
  • 다른 에이전트의 답변에 반응하는 비평가 또는 검토 에이전트 추가.
  • 대화에 참여하지 않고 이벤트를 관찰해 대화 기록이나 UI 스트림 생성.
  • 도구 호출이 실행되기 전에 가로채 사람이 참여하는 흐름 유지.

빠른 시작

  1. 1

    npm으로 코어 패키지를 설치합니다

    npm install @mozaik-ai/core
  2. 2

    사용할 제공자의 API 키를 .env 파일에 설정합니다

사용 전 알아둘 점

  • 추론을 실행하려면 OpenAI, Anthropic, Gemini와 같은 모델 제공자의 API 키가 필요합니다.
  • 발췌된 README에는 바로 실행할 수 있는 엔드투엔드 예제가 없으므로, 설치 후 설정에 다소 노력이 필요할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

mozaik은(는) 무엇인가요?
AI 에이전트가 하나의 공간에 참여해 이벤트에 반응하고, 서로를 막지 않으면서 동시에 실행되는 TypeScript 런타임입니다. Mozaik은 이벤트 버스를 공유하는 AI 에이전트를 구축하기 위한 TypeScript 런타임입니다. 사람, 에이전트, 옵서버 같은 참여자가 런타임에 들어와 메시지나 사용자 지정 신호 같은 이벤트를 게시하고, 명세와 프로세서를 짝지은 상황 핸들러를 통해 이에 반응합니다.
mozaik은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mozaik은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mozaik은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mozaik의 마지막 커밋은 2026년 11월 7일입니다.
mozaik은(는) 어디에 사용할 수 있나요?
여러 에이전트가 같은 목표를 위해 실시간으로 협업하는 멀티 에이전트 시스템 구축. 다른 에이전트의 답변에 반응하는 비평가 또는 검토 에이전트 추가. 대화에 참여하지 않고 이벤트를 관찰해 대화 기록이나 UI 스트림 생성. 도구 호출이 실행되기 전에 가로채 사람이 참여하는 흐름 유지.
mozaik는 어떻게 설치하나요?
npm으로 코어 패키지를 설치합니다: npm install @mozaik-ai/core 사용할 제공자의 API 키를 .env 파일에 설정합니다
mozaik은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jigjoy-ai/mozaik

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트