THU-MAIC/OpenMAIC

OpenMAIC – 오픈 멀티 에이전트 인터랙티브 교실

정의 – OpenMAIC는 모든 주제, 문서 또는 학습 자료를 완전한 기능을 갖춘 AI 기반 교실로 전환할 수 있는 오픈소스 웹 플랫폼입니다. 여러 AI 에이전트(교사, 급우, 화이트보드 어시스턴트, TTS 음성 등)를 오케스트레이션하여 슬라이드, 퀴즈, 인터랙티브 HTML 시뮬레이션 및 프로젝트 기반 학습 활동을 생성하고 브라우저 UI를 통해 실시간으로 제공합니다.

주요 기능

• 원클릭 수업 생성 – 주제를 설명하거나 소스 파일을 업로드하면 시스템이 전체 수업(개요, 슬라이드 콘텐츠, 이미지, 오디오 내레이션, 선택적 비디오)을 자동으로 구축합니다.
• 멀티 에이전트 상호작용 – AI '교사'와 '동료'가 공유 화이트보드에 말하고, 그리고, 질문에 답하고, 시뮬레이션을 실행하여 대화형 학습 경험을 제공할 수 있습니다.
• 리치 미디어 출력 – 편집 가능한 PowerPoint(.pptx) 덱 또는 자체 포함된 인터랙티브 HTML 페이지를 내보낼 수 있습니다. 미디어는 PostgreSQL 또는 S3에 저장할 수 있습니다.
• 에이전트 워크벤치 통합 – 내장된 OpenMAIC 스킬은 OpenClaw, Codex, DeepSeek, WorkBuddy 및 기타 많은 에이전트 프레임워크와 함께 작동하므로 Feishu, Slack, Telegram 또는 IDE 내에서 직접 교실을 생성할 수 있습니다.
• 플러그형 모델 제공업체 – OpenAI, Anthropic, Azure OpenAI, Amazon Bedrock, Gemini, Qwen, MiniMax, Grok, TokenDance, Xiaomi MiMo, Zhipu GLM, Ollama, Lemonade(로컬) 및 모든 OpenAI 호환 API를 지원합니다. 모델 사용은 슬롯(개요, 슬라이드 텍스트, TTS, 웹 검색 등)을 특정 공급자에 매핑하는 간단한 openmaic.yml 파일을 통해 구성됩니다.
• 서버 기반 영구 저장 – 코스, 채팅 기록, 생성된 미디어 및 사용자 세션이 PostgreSQL에 저장되므로 탭을 닫거나 서버를 다시 시작해도 생성 프로세스가 유지됩니다.
• Docker 또는 로컬 배포 가능 – 개발에는 pnpm 및 Docker 기반 PostgreSQL을 사용합니다. 프로덕션은 장기 실행 Node.js 프로세스(Docker Compose)로 실행하거나, 이전 1.1.x 릴리스의 경우 Vercel 서버리스에서 실행할 수 있습니다.

일반적인 사용 사례

시나리오	OpenMAIC의 도움
교육자가 수업이나 워크숍을 위한 빠르고 인터랙티브한 수업을 구축합니다.	몇 분 만에 슬라이드, 퀴즈 및 라이브 시뮬레이션을 생성하고 오프라인 사용을 위해 PowerPoint로 내보냅니다.
기업 교육자가 즉석 교육 모듈을 필요로 합니다.	제품 문서를 업로드하고 AI가 음성 해설과 인터랙티브 데모를 갖춘 구조화된 코스를 만들도록 합니다.
학생이 교과서 챕터에 대한 개인 튜터를 원합니다.	챕터를 설명하고 후속 질문에 답하고 설명을 그릴 수 있는 멀티 에이전트 교실을 얻으세요.
개발자/IDE 사용자가 워크플로우에 학습을 포함시키려고 합니다.	OpenClaw 또는 다른 워크벤치에서 OpenMAIC 스킬을 사용하여 메시징 채널이나 코드 편집기에서 직접 수업을 시작하세요.
연구자가 멀티 에이전트 오케스트레이션을 실험합니다.	오픈소스 스택(Next.js, LangGraph, Tailwind)은 에이전트 확장이나 새로운 양식 추가에 완전히 접근 가능합니다.

빠른 시작(로컬 개발)

# 1. 리포지토리 복제
git clone https://github.com/THU-MAIC/OpenMAIC.git && cd OpenMAIC

# 2. 종속성 설치(pnpm ≥10)
pnpm install

# 3. 구성 설정
cp .env.example .env.local            # put your API keys here
cp openmaic.example.yml openmaic.yml  # edit model slots if desired
# At minimum you need OPENAI_API_KEY (or another provider key)

# 4. PostgreSQL 인스턴스 시작(Docker 도우미)
pnpm db:up
# The helper creates a DB at postgres://openmaic:openmaic-dev@127.0.0.1:5432/openmaic

# 5. 개발 서버 실행
pnpm dev

# 브라우저에서 http://localhost:3000을 열고 수업 생성을 시작합니다.

프로덕션/Docker 배포

# 키가 있는 환경 파일 준비
cp .env.example .env.local && nano .env.local

# 앱과 PostgreSQL 모두 빌드 및 실행
docker compose up --build -d

Compose 스택은 두 개의 컨테이너(앱 + Postgres)를 만들고 명명된 볼륨(openmaic-postgres, openmaic-data)에 데이터를 저장합니다. 다중 사용자 배포의 경우 게시 전에 ACCESS_CODE와 강력한 PERSISTENCE_POSTGRES_PASSWORD를 설정하세요.

더 알아보기

• 사용자 가이드 – 영어 및 중국어 가이드는 README 상단에 링크되어 있습니다.
• 문서 – 자세한 문서는 packages/docs/content/docs/에 있습니다(구성, 지원되는 모델, 배포, 호스팅 등).
• 라이브 데모 – https://open.maic.chat/ 에서 UI를 확인할 수 있습니다.
• 커뮤니티 – 지원 및 토론을 위해 Discord 및 Feishu 링크가 제공됩니다.

---

OpenMAIC는 멀티 에이전트 교실 생성, 모델 오케스트레이션 및 인터랙티브 학습 경험에 초점을 맞춘 진정한 활발하게 유지 관리되는 AI 프로젝트입니다. 최첨단 AI/ML 공간(LLM 오케스트레이션, RAG, 멀티모달 생성, AI 기반 교육)에 완벽하게 부합합니다.