OpenMAIC 사용법: 문서와 주제로 대화형 AI 교실을 만드는 오픈소스
GitHub 일간 Trending 1위에 오른 OpenMAIC의 설치와 최소 실행법을 살펴본다. 멀티에이전트 수업 제작, v1.0.0의 기능, 데이터 전송과 권한·보안상 주의점을 정리했다.
OpenMAIC는 주제나 문서를 입력하면 슬라이드, 퀴즈, 시뮬레이션과 음성 설명을 포함한 대화형 수업을 구성하는 MIT 라이선스 오픈소스다. 2026년 9월 1일 10시 03분(Asia/Seoul) 확인 기준 GitHub 일간 Trending 1위였고 2,824 stars today가 표시됐다. GitHub API의 총 스타 수는 27,064개였다.
무엇을 하는 소프트웨어인가
여러 에이전트가 강사와 학습자 역할을 나눠 수업 개요, 슬라이드, 퀴즈와 프로젝트 학습 자료를 만든다. 8월 27일 공개된 v1.0.0은 채팅 중심 Pro 작업대, 재시작 뒤에도 이어지는 서버 세션, 업로드 자료 검색, 20개 내장 스킬과 PostgreSQL 영속화를 추가했다.
설치와 최소 실행
공식 README의 빠른 시작은 Node.js 20 이상과 pnpm 10 이상을 요구한다.
git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
cp .env.example .env.local
pnpm dev.env.local에 지원되는 모델 제공자 키를 하나 이상 설정한다. 명령 형식과 요구 버전은 README와 v1.0.0 릴리스를 대조했으며, 이 작업에서는 의존성 설치와 외부 모델 호출을 실행하지 않았다.
핵심 사용법과 활용
- 한 번에 수업 생성: 주제와 대상 학습자를 설명해 기본 수업을 만든다.
- 자료 기반 제작: 문서·오디오·비디오를 세션 자료로 검색한다.
- Pro 작업대: 대화로 교육과정을 계획하고 각 페이지를 수정한다.
- 내보내기: 대화형 HTML이나 편집 가능한 PPTX로 결과를 전달한다.
지원 환경·권한·보안
주요 구성은 Next.js 16, React 19, TypeScript 5다. 외부 LLM·검색·음성·이미지 제공자를 쓰면 입력 자료가 해당 서비스로 전송될 수 있다. 학생 개인정보나 제한 자료가 있다면 보존 정책을 먼저 확인해야 한다. 자체 호스팅에서는 관리자 기능과 세션 저장소를 공개 인터넷에 바로 노출하지 말고 업로드 형식·크기·도메인과 실행 계정 권한을 제한한다.
한계와 도입 전 확인 사항
생성된 수업의 사실 정확성과 교육과정 적합성은 자동으로 보장되지 않는다. 퀴즈 정답, 출처, 연령 적합성, 접근성을 교사가 검토해야 한다. 멀티에이전트와 미디어 생성은 비용과 지연이 커질 수 있으므로 제공자별 한도, 실패 재시도, 데이터 삭제 정책을 시험해야 한다.
출처
확인: 2026년 9월 1일 10시 03분(Asia/Seoul). 기본 브랜치 main, 최근 push 2026년 9월 1일 07시 04분, 최신 안정 릴리스 v1.0.0, MIT 라이선스.
