Brand LogoBrand Logo (Dark)
홈AI 에이전트툴킷GitHub 추천에이전트 등록블로그

카테고리

  • 아트 생성기
  • 오디오 생성기
  • 자동화 도구
  • 챗봇 & AI 에이전트
  • 코드 도구
  • 금융 도구

카테고리

  • 대규모 언어 모델
  • 마케팅 도구
  • 노코드 & 로우코드
  • 리서치 & 검색
  • 영상 & 애니메이션
  • 영상 편집

GitHub 추천

  • DeerFlow — ByteDance 오픈소스 슈퍼에이전트 프레임워크

최신 블로그

  • OpenClaw와 Composer 2, 어떤 AI 비서가 더 뛰어난가?
  • 구글 AI 스튜디오 vs 앤트로픽 콘솔, 2026년 AI 개발 플랫폼 비교
  • 스티치 2.0 vs 러블 2026년, 어떤 제품이 더 나을까
  • 2026년 AI로 소규모 비즈니스 수익화하는 실전 가이드
  • OpenClaw와 MiniMax, 어떤 AI 어시스턴트가 더 나은 선택일까

최신 블로그

  • OpenClaw와 KiloClaw 실제 사용 경험 비교
  • OpenClaw와 Kimi Claw 비교하기
  • GPT-5.4와 Gemini 3.1 Pro 비교하기
  • Perplexity Computer, 19개 AI 모델로 금융 산업 판도 흔든다
  • OpenClaw 최선의 실천, 5 개 기본 원칙
LinkStartAI© 2026 LinkstartAI. 모든 권리 보유
문의하기소개
  1. 홈
  2. GitHub 추천
  3. OpenMAIC
OpenMAIC logo

OpenMAIC

어떤 주제든 한 번의 클릭으로 몰입형 멀티에이전트 교실로 전환
0TypeScriptGNU Affero General Public License v3.0
#멀티에이전트#AI교육#인터랙티브교실#PBL#LangGraph#LLM
#화이트보드
#오픈소스

개요

OpenMAIC는 칭화대 MAIC 랩이 공개한 오픈소스 AI 교육 플랫폼이다. 주제 설명이나 문서를 한 번에 상호작용형 교실로 변환하며, LangGraph 기반 멀티에이전트 오케스트레이션으로 AI 교사와 AI 학생이 실시간 강의, 화이트보드 드로잉, 토론, 질의응답을 수행한다. 핵심 기능은 슬라이드, 퀴즈, HTML 기반 인터랙티브 시뮬레이션, PBL 과제를 통합 생성하는 데 있으며, 결과물은 편집 가능한 .pptx 또는 독립 실행형 .html로 내보낼 수 있다. OpenAI, Anthropic Claude, Google Gemini, DeepSeek와 OpenAI 호환 API를 지원하고, OpenClaw를 통해 Feishu, Slack, Telegram 등 20개 이상의 메신저 앱과 연결된다. 연구 성과는 JCST'26에 게재되었다.

문제점 vs 혁신

✕기존 문제점✓혁신적 솔루션
기존 MOOC 플랫폼은 고정형 콘텐츠 중심이라 학습자가 수동적으로 시청하는 구조에 머문다2단계 생성 파이프라인으로 먼저 개요를 만들고 이후 장면별 콘텐츠를 병렬 생성해 속도와 밀도를 높인다
많은 AI 튜터링 도구는 단발성 Q&A에 그쳐 지속적인 수업 내러티브와 역할 분담이 약하다LangGraph 기반 'director graph'가 다중 에이전트를 조율하며 음성, 화이트보드, 레이저 포인터 등 28개 이상의 동작을 지원한다
자체 AI 코스웨어를 구축하려면 TTS, ASR, LLM, 렌더링, 에이전트 프레임워크를 모두 통합해야 해 비용이 크다HTML 인터랙티브 시뮬레이션 엔진이 정적인 자료를 넘어 직접 조작 가능한 학습 실험을 생성한다
일반 문서 AI 도구는 단일 문서만으로 시뮬레이션과 PBL을 포함한 완성형 수업을 만들기 어렵다OpenClaw 연동으로 20개 이상 메신저에서 교실 생성을 실행해 채팅 기반 학습 흐름을 만든다
-칭화대 팀과 JCST'26 논문 기반으로 신뢰성과 기술적 정당성을 확보했다

아키텍처 심층 분석

2단계 수업 생성 파이프라인
OpenMAIC는 생성 과정을 '개요 생성'과 '장면 생성'으로 분리한다. 먼저 LLM이 챕터, 목표, 난이도를 구조화하고 이후 슬라이드, 퀴즈, HTML 시뮬레이션, PBL 콘텐츠를 병렬로 만든다. 이 방식은 수업 구조를 안정적으로 유지하면서도 전체 생성 시간을 줄여 준다. 진행 상황은 SSE로 스트리밍되어 사용자가 교실이 조립되는 과정을 실시간으로 볼 수 있다.
LangGraph 멀티에이전트 오케스트레이션
핵심 엔진은 LangGraph 기반 'director graph' 상태 머신으로, 교사, 학생, 진행자 역할의 발화 순서와 분기 규칙을 제어한다. 토론이나 Q&A로 들어가면 오케스트레이션 계층이 누가 말할지, 어떤 동작을 실행할지, 문맥을 어떻게 이어갈지 결정한다. 음성, 화이트보드, 스포트라이트, 레이저 포인터 등 다양한 액션을 지원해 실제 수업에 가까운 경험을 만든다. 상태는 프런트엔드 스토어와 동기화되어 화면 표현과 에이전트 동작이 일치한다.
재생 및 실시간 상호작용 엔진
전용 재생 상태 머신이 idle, playing, paused, live를 관리한다. 미리 생성된 콘텐츠는 순서대로 실행되고, 사용자가 질문하면 즉시 live 모드로 전환되어 실시간 응답을 생성한다. 이런 이중 상태 구조는 실시간 추론 지연이 전체 수업 재생감을 해치지 않도록 해 준다. 교육 제품에서 중요한 안정적 흐름과 즉시성 사이의 균형을 잘 잡은 설계다.
LLM 및 미디어 추상화 계층
lib/ai, lib/audio, lib/media는 각각 모델, 음성, 미디어 기능을 분리해 추상화한다. OpenAI, Anthropic, Gemini, DeepSeek, OpenAI 호환 API를 런타임에서 전환할 수 있다. TTS, ASR, 이미지 생성, 비디오 생성도 같은 플러그형 구조를 사용해 비용과 품질, 규제 요건에 맞게 공급자를 교체하기 쉽다. 덕분에 모델 생태계 변화에도 코어 시스템을 크게 바꾸지 않고 확장할 수 있다.

배포 가이드

1. Node.js 20 이상과 pnpm 10 이상을 준비한 뒤 저장소를 클론하고 의존성을 설치한다

bash
1git clone https://github.com/THU-MAIC/OpenMAIC.git2cd OpenMAIC3pnpm install

2. 환경 변수 템플릿을 복사하고 최소 한 개의 LLM 제공자 키를 설정한다

bash
1cp .env.example .env.local2# .env.local 편집3# OPENAI_API_KEY=sk-...4# ANTHROPIC_API_KEY=sk-ant-...5# GOOGLE_API_KEY=...

3. 개발 서버를 실행하고 로컬 주소에 접속한다

bash
1pnpm dev

4. 선택적으로 Docker 기반 컨테이너 배포를 진행한다

bash
1cp .env.example .env.local2# 수정 후 실행3docker compose up --build

5. 선택적으로 Vercel에 저장소를 가져오고 환경 변수를 설정한다

bash
1# https://vercel.com/new 방문2# 포크한 저장소를 불러오고 API Key 설정

활용 사례

핵심 시나리오대상 고객솔루션최종 결과
개인 학습 가속기새로운 기술을 빠르게 익히고 싶은 자기주도 학습자주제 입력이나 책·논문 업로드만으로 강의, 퀴즈, 시뮬레이션 수업을 자동 생성더 짧은 시간 안에 체계적 학습을 마치고 이해도를 높인다
기업 교육 콘텐츠 팩토리교육 자료를 대량 생산해야 하는 기업 L&D 팀사내 SOP와 지식 문서를 업로드해 인터랙티브 코스웨어를 만들고 .pptx로 내보낸다제작 리드타임과 인건비를 크게 줄인다
학교 수업용 스마트 조교차별화된 수업 자료가 필요한 대학 및 K12 교사Feishu나 Slack에서 토론과 PBL이 포함된 인터랙티브 교실을 바로 생성한다낮은 도입 장벽으로 수업 참여도와 확장성을 높인다

제한 사항 및 주의점

제한 사항 및 주의점
  • 생성 품질은 기반 LLM 성능에 크게 좌우되며, 약한 모델은 사실 오류나 느슨한 수업 구조를 만들 수 있다
  • HTML 시뮬레이션은 모델이 자동 생성하므로 복잡한 실험에서는 로직 오류나 낮은 상호작용 정확도가 발생할 수 있다
  • 완전한 교실 생성에는 다수의 모델·음성 호출이 필요해 고동시성 환경에서 API 비용 부담이 커질 수 있다
  • 실시간 TTS는 네트워크 지연이나 제공자 응답 속도 문제로 몰입감을 떨어뜨릴 수 있다
  • AGPL-3.0은 폐쇄형 SaaS에 강한 제약을 주므로 상용화 전 라이선스 검토가 필요하다

자주 묻는 질문

OpenMAIC와 전통적인 MOOC의 핵심 차이는 무엇인가▾
전통적인 MOOC는 고정된 녹화 강의를 중심으로 하며 상호작용이 약하다. OpenMAIC는 현재 주제에 맞춰 교실을 즉시 생성하고 여러 에이전트가 설명과 토론, 응답을 수행해 개인화 학습에 더 유리하다.
왜 AutoGen이나 CrewAI 대신 LangGraph를 선택했나▾
수업 제품은 명시적 상태 제어와 사용자 개입 처리 능력이 중요하다. LangGraph는 재생 상태, 토론 상태, 실시간 전환을 그래프 구조로 안정적으로 모델링하기에 적합하다.
완성형 교실 하나를 만드는 데 시간과 비용은 어느 정도인가▾
장면 수, 사용하는 모델 등급, TTS 활성화 여부에 따라 달라진다. 보통 중간 규모 수업은 몇 분 안에 생성되지만 고급 모델과 복잡한 시뮬레이션은 비용을 크게 높일 수 있다.
HTML 인터랙티브 시뮬레이션은 얼마나 안정적으로 동작하나▾
단순한 시뮬레이션은 비교적 잘 동작하지만 복잡한 상호작용은 스크립트 오류나 동작 편차가 생길 수 있다. 실제 수업에 쓰려면 사전 검수와 더 강한 모델 사용이 안전하다.
OpenClaw 연동의 실질적 가치는 무엇인가▾
교실 생성 기능을 Feishu, Slack, Telegram 같은 일상 메신저 워크플로 안으로 끌어온다는 점이다. 사용자는 별도 관리 화면 없이 채팅 안에서 생성 요청, 진행 추적, 링크 수신을 처리할 수 있다.
기업 프라이빗 배포에서 가장 큰 공백은 무엇인가▾
현재 구조는 단일 사용자 셀프호스팅 성격이 강하고 인증, 권한, 멀티테넌시 기능이 기본 제공되지 않는다. 기업 도입에는 Auth, API 보호, 영속 데이터베이스 설계가 추가로 필요하다.
AGPL-3.0은 상용화에 어떤 영향을 주나▾
코드를 수정해 네트워크 서비스로 제공하면 보통 수정본 공개 의무가 발생한다. 폐쇄형 SaaS를 계획한다면 초기에 상용 라이선스 경로를 검토하는 것이 안전하다.
Gamma.app 같은 AI PPT 도구와 비교하면 어떤 점이 강한가▾
Gamma는 시각 디자인과 비즈니스 프레젠테이션 완성도가 강점이다. 반면 OpenMAIC는 교육 흐름, 에이전트 상호작용, 화이트보드 액션, 학습 중심 시나리오에서 더 강하다.
GitHub에서 보기

프로젝트 지표

Star 수0
언어TypeScript
라이선스GNU Affero General Public License v3.0
배포 난이도쉬움

Table of Contents

  1. 01개요
  2. 02문제점 vs 혁신
  3. 03아키텍처 심층 분석
  4. 04배포 가이드
  5. 05활용 사례
  6. 06제한 사항 및 주의점
  7. 07자주 묻는 질문

관련 프로젝트

DeerFlow — ByteDance 오픈소스 슈퍼에이전트 프레임워크
DeerFlow — ByteDance 오픈소스 슈퍼에이전트 프레임워크
26.1 k·Python
gstack
gstack
0·TypeScript
Marketing for Founders
Marketing for Founders
2.2 k·Markdown
Yuan3.0 Ultra
Yuan3.0 Ultra
1.2 k·Python