AI 선생님과 AI 짝꿍이 있는 교실, 주제 한 줄로

강의 영상 보기와 뭐가 다른가요

한눈에

어떻게 작동하나요

1. 서버를 띄워요. Node.js 22.19 이상, pnpm 10, PostgreSQL 16이 필요해요. 1.2.0부터 수업 생성이 서버 안에서 돌아가서 브라우저 탭을 닫거나 서버를 재시작해도 이어져요. 그래서 Vercel 같은 서버리스에는 1.1.x까지만 올라가요.2. 모델을 연결해요. openmaic.yml에 제공사(providers)와 슬롯(slots)을 적어요. 슬롯은 AI를 쓰는 자리 하나하나예요. 개요(course.outline), 슬라이드 내용, 그림(image), 영상(video), 음성(tts), 웹 검색(webSearch) 같은 자리마다 다른 모델을 둘 수 있고, 키는 .env.local에만 둬요. 오픈AI, 앤트로픽, 제미나이, 딥시크, 큐원, 올라마 등 20곳 넘게 지원해요.3. 주제를 적고 생성해요. 첫 화면에 주제를 쓰거나 자료를 붙이고 Generate를 눌러요. 개요가 먼저 나오고 항목마다 장면이 만들어져요. 표준 모드는 빠르게, 심화 체험 모드는 만져 보는 화면까지 만들어요.4. 수업을 들어요. 재생하면 AI 선생님이 설명하고, AI 학생이 질문하고, 나는 언제든 끼어들어요. 슬라이드 요소나 칠판 그림을 가리키며 물으면 그 자리에서 답해요.5. 내보내요. 오른쪽 위 내려받기에서 PPTX, 리소스 팩, 오프라인 HTML, 교실 ZIP을 골라요.README는 그림, 내레이션, 영상, 웹 검색을 다 켰을 때 가장 좋다고 적는데, 그만큼 API 비용이 들어요. 토큰 플랜(한 키로 여러 기능)이나 올라마, Lemonade 같은 로컬 모델로 줄일 수 있어요.

할 수 있는 일

바로 쓸 수 있나요

시작하기

1. 받아서 설치

   Node.js 22.19 이상과 pnpm 10이 필요해요. 첫 설치는 작업 공간 패키지를 빌드해서 시간이 좀 걸려요.

   git clone https://github.com/THU-MAIC/OpenMAIC.git
   cd OpenMAIC
   pnpm install

   복사
2. 설정 파일 두 개

   .env.local에는 API 키를, openmaic.yml에는 어떤 모델을 어느 자리(슬롯)에 쓸지 적어요. 예시 파일은 OPENAI_API_KEY 하나만 채우면 돌아가고, 다른 제공사로 바꿔도 돼요.

   cp .env.example .env.local
   cp openmaic.example.yml openmaic.yml

   복사
3. 데이터베이스 띄우기

   도커로 개발용 PostgreSQL을 띄워요. 그 뒤 .env.local의 DATABASE_URL 줄 주석을 풀어요. DATABASE_URL이 없으면 서버가 시작을 거부해요.

   pnpm db:up

   복사
4. 실행

   http://localhost:3000 을 열면 교실 생성 화면이에요. 주제를 쓰거나 자료를 올리고 Generate를 눌러요.

   pnpm dev

   복사
5. 도커로 한 번에

   앱과 PostgreSQL 두 컨테이너가 떠요. 기본은 내 컴퓨터(127.0.0.1:3000)에서만 열리는 개인 설치예요. 다른 사람에게 열려면 ACCESS_CODE를 먼저 설정하세요.

   cp .env.example .env.local
   docker compose up --build

   복사
6. 메신저에서 쓰기(오픈클로)

   오픈클로에 스킬을 설치하면 페이슈, 슬랙, 텔레그램에서 "이거 가르쳐 줘"라고 말해 교실을 만들어요. open.maic.chat의 접근 코드를 쓰면 설치 없이도 돼요. 단계마다 확인을 받는다고 README가 적어요.

   clawhub install openmaic

   복사

처음 쓰는 순서

1. pnpm install저장소 받아 설치
2. openmaic.yml제공사 하나와 llm 슬롯만 적고 시작
3. pnpm db:up · pnpm dev데이터베이스 띄우고 localhost:3000 열기
4. 주제 한 줄 생성표준 모드로 짧은 수업 하나 먼저
5. 자료 붙여 생성내 PDF로 만들고 퀴즈 정답을 원문과 대조
6. 내보내기오프라인 HTML로 저장해 휴대폰에서 열기

README와 시작 문서(getting-started)에 나온 순서를 처음 쓰는 순서로 묶은 예예요. 설치가 부담되면 공식 데모(open.maic.chat)를 먼저 열어 보세요.

주제 한 줄이 교실이 되기까지

README의 두 단계 생성(개요, 장면), 장면 종류, 교실 구성, 내보내기 설명을 따라 저희가 그린 예시예요. 수업 내용과 대사는 지어낸 것이고 실제 결과는 연결한 모델과 설정에 따라 달라져요. AI 선생님도 틀릴 수 있으니 교과서와 선생님께 확인하세요.

비슷한 도구

OpenMAIC은 자료를 여러 AI가 이끄는 수업 장면으로 바꾸는 쪽이고, DeepTutor는 내 자료로 1:1 과외와 복습을 이어 가는 쪽이에요(각 README 기준).

주의할 점

1. AI 선생님도 틀릴 수 있어요. 자동으로 만든 슬라이드 내용, 퀴즈의 정답과 풀이, 시뮬레이션의 수치까지 모두 AI가 쓴 것이니 교과서와 선생님께 확인하세요. 특히 자료 없이 주제만 적어 만든 수업은 근거가 모델의 기억뿐이에요.
2. 비용이 여러 곳에서 나가요. 수업 하나에 글 생성, 그림, 내레이션 음성, 영상, 웹 검색이 각각 API를 불러요. 처음엔 llm 슬롯만 켜고 나머지(video: null 처럼)는 끈 채로 시험해 보세요.
3. 중국어가 꽤 보여요. README의 데스크톱, 아이패드, 휴대폰 캡처와 3D 수업 데모가 중국어 화면이고, 사용 안내는 영어판과 중국어판이 페이슈 위키에 있어요. 커뮤니티는 디스코드와 페이슈예요. 화면 언어는 한국어 포함 12개를 고를 수 있어요.
4. 다른 사람에게 열 때는 ACCESS_CODE가 전부예요. 설정하지 않으면 포트에 닿는 누구나 수업 전체를 보고 고치고 지울 수 있다고 README가 적어요. 16자 이상 무작위 값을 쓰세요.
5. 올릴 때 되돌리기 어려운 변경이 있어요. 1.3.0, 1.3.1은 옛 인스턴스를 모두 멈춘 뒤 올려야 하고 되돌리려면 데이터베이스 복원이 필요해요. 보안 패치(SSRF, DNS 리바인딩 등)도 자주 나왔으니 최신 판을 유지하세요.
6. VoxCPM2로 목소리를 복제하는 기능이 있어요. 본인 동의 없는 목소리 사용은 금지예요. 참조 녹음은 브라우저에 저장됐다가 내 VoxCPM 서버로만 가요.
7. 저장소 안의 packages/mathml2omml 은 LGPL-3.0이라 MIT와 조건이 달라요. 전체를 다시 배포할 때는 그 패키지 조건을 따라야 해요.

더 보기

칭화대 MAIC 팀(THU-MAIC)이 만들었어요. 바탕 논문은 "From MOOC to MAIC"(JCST 2026)이고, 2026년 6월 v0.3.0에서 MIT로 라이선스를 바꿨어요.

공식 데모 ↗영어 사용 안내 ↗시작 문서 ↗논문(JCST) ↗바뀐 점 ↗깃허브 저장소 ↗

낯선 말

1. 멀티 에이전트 · 역할이 다른 AI 여럿(선생님, 학생들)이 한 장면에서 함께 움직이는 방식이에요
2. 장면(scene) · 수업을 이루는 한 단위예요. 슬라이드, 퀴즈, 실습, 프로젝트 중 하나예요
3. PBL · 역할을 맡아 단계별 목표와 결과물을 만들며 배우는 프로젝트 기반 학습이에요
4. 슬롯 · AI를 쓰는 자리 하나(개요, 그림, 음성 등)에 어떤 모델을 둘지 정하는 설정이에요
5. 토큰 플랜 · 한 키로 대화, 그림, 영상, 음성, 검색을 함께 쓰는 제공사 요금제예요
6. TTS · 글을 소리로 읽어 주는 기술이에요. AI 선생님 목소리가 이거예요
7. ACCESS_CODE · 설치본 전체를 지키는 하나의 비밀번호예요