THU-MAIC/OpenMAIC

어떤 프로젝트인가요?

핵심 기능

• 01주제나 업로드한 문서, 오디오, 동영상으로 강의 개요와 장면을 생성합니다.
• 02장면 유형으로 슬라이드, 퀴즈, 인터랙티브 HTML 시뮬레이션, 프로젝트 기반 학습을 지원합니다.
• 03AI 교사와 학습자가 내용을 설명하고 화이트보드에 그림을 그리며 학습자와 토론합니다.
• 04편집 가능한 PPTX 슬라이드, 인터랙티브 HTML 페이지 또는 MP4 동영상으로 내보냅니다.
• 05openmaic.yml에서 모델을 설정하며 다양한 클라우드 및 로컬 공급자를 지원합니다.
• 06OpenClaw, Codex 및 기타 에이전트 워크벤치에서 사용할 수 있는 에이전트 스킬을 포함합니다.

활용 사례

• 강의 주제나 참고 자료를 슬라이드와 퀴즈로 빠르게 만들고 싶은 교사.
• 선택한 주제를 인터랙티브한 대화형 강의로 학습하고 싶은 자기주도 학습자.
• 에이전트 스킬을 통해 채팅 앱이나 IDE에서 교실을 생성하려는 개발자.
• 로컬 또는 프라이빗 모델 공급자를 활용해 자체 호스팅 AI 강의 생성기를 도입하려는 조직.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/THU-MAIC/OpenMAIC.git
2. 2

   종속성을 설치합니다(OpenMAIC 폴더 안에서 실행)

   pnpm install
3. 3

   예제 env 파일과 모델 설정 파일을 복사합니다

   cp .env.example .env.local
4. 4

   Docker에서 로컬 PostgreSQL 데이터베이스를 시작합니다

   pnpm db:up

사용 전 알아둘 점

• !PostgreSQL 16 및 Node.js 22.19 이상이 필요하며, 강의는 서버에 저장됩니다.
• !로컬 모델을 사용하는 경우가 아니라면 강의를 생성하려면 OpenAI와 같은 AI 제공업체의 API 키가 필요합니다.
• !Vercel 배포는 1.1.x 계열로 제한됩니다. 1.2 이상은 장시간 실행되는 서버가 필요합니다.

토픽

자주 묻는 질문

OpenMAIC은(는) 무엇인가요?

어떤 주제나 문서든 AI 교사와 학습자가 함께하는 인터랙티브 교실로 바꾸는 오픈소스 AI 플랫폼입니다. OpenMAIC(Open Multi-Agent Interactive Classroom)는 주제 설명이나 PDF, Word, PowerPoint, 스프레드시트, 오디오·동영상 파일 등의 자료를 업로드하면 완성된 강의를 생성합니다. 멀티 에이전트 시스템이 강의 개요를 만든 뒤 각 항목을 슬라이드, 퀴즈, 인터랙티브 HTML 시뮬레이션 또는 프로젝트 기반 학습 활동으로 구성합니다. AI 교사와 학습자는 학습자에게 내용을 설명하고, 화이트보드에 그림을 그리며, 토론에 참여합니다.

OpenMAIC은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

OpenMAIC은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

OpenMAIC은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. OpenMAIC의 마지막 커밋은 2026년 10월 18일입니다.

OpenMAIC은(는) 어디에 사용할 수 있나요?

강의 주제나 참고 자료를 슬라이드와 퀴즈로 빠르게 만들고 싶은 교사. 선택한 주제를 인터랙티브한 대화형 강의로 학습하고 싶은 자기주도 학습자. 에이전트 스킬을 통해 채팅 앱이나 IDE에서 교실을 생성하려는 개발자. 로컬 또는 프라이빗 모델 공급자를 활용해 자체 호스팅 AI 강의 생성기를 도입하려는 조직.

OpenMAIC는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/THU-MAIC/OpenMAIC.git 종속성을 설치합니다(OpenMAIC 폴더 안에서 실행): pnpm install 예제 env 파일과 모델 설정 파일을 복사합니다: cp .env.example .env.local Docker에서 로컬 PostgreSQL 데이터베이스를 시작합니다: pnpm db:up

OpenMAIC은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/THU-MAIC/OpenMAIC