~/教學/CLASS.md

文章 / AI 工具

OpenMAIC:丟一章講義,AI 老師、AI 同學、小考全生出來(GitHub 四萬星開源 AI 教室,試用與自架教學)

OpenMAIC 是 MIT 開源的 AI 教室:上傳 PDF、Word 或簡報,排出投影片、會畫白板的 AI 老師、會討論的 AI 同學和 AI 批改的小考。先玩線上 Demo,再照官方步驟自己架。

在 Instagram 看這支 Reels留言關鍵字 #CLASS 就會收到這篇

有一章講義怎麼讀都卡住?OpenMAIC 是 GitHub 上四萬多顆星的開源專案:你丟一份 PDF、Word 或簡報進去,它排出一整堂課,有投影片、邊講邊畫白板的 AI 老師、會主動討論的 AI 同學,最後還有 AI 批改的小考。這篇是 Reels 裡 CLASS 那支影片的完整版:它做得出什麼、去哪裡先免費玩、想自己架要準備什麼,還有幾段可以直接複製的提示詞。資料全部來自官方 GitHub 和官方網站,我在 2026 年 11 月 10 日核對過。

01先看結果:一章講義,變成一間有老師、有同學的教室

OpenMAIC 官方 Demo 畫面:左邊是互動白板,上面有公式和一張函數與切線的折線圖;右邊聊天區裡,AI 同學 Maya 發問,AI 老師 Dr. Aris 回答
官方 Demo 畫面:AI 老師在白板上畫圖,右邊 AI 同學 Maya 發問、AI 老師回答。

影片裡的畫面都是 OpenMAIC 官方 README 裡的 Demo,不是我自己跑出來的課。你看到的是一堂微積分課:白板上有公式和圖,AI 同學舉手問「切線到底特別在哪」,AI 老師一邊回答一邊在白板上補一張圖。

  1. OpenMAIC 會幫你做出哪四樣東西:投影片、AI 老師、AI 同學、小考。
  2. 最快的試法:官方線上 Demo,打開網頁就能看。
  3. 想自己架:要準備什麼、官方的五個步驟,還有一段請 Claude Code 幫你架的提示詞。
  4. 丟講義進去時可以怎麼下指令(附可複製的提示詞)。
  5. 費用和限制:程式免費,AI 用量要自己付。

02它做得出什麼:投影片、AI 老師、AI 同學、小考

官方 README 的 Highlights 段落:一鍵生成課程、多代理教室、投影片與小考等場景、白板與語音、匯出、Agent 整合
官方 README 的 Highlights:第一行寫「AI 幾分鐘就做好一整堂課」。

OpenMAIC 全名是 Open Multi-Agent Interactive Classroom,意思是「很多個 AI 一起上課的互動教室」。你描述想學的主題,或附上講義,它先排出課程大綱,再把每一段做成一個場景。

  1. 投影片:AI 老師會配音講解,還有聚光燈和雷射筆效果。
  2. 白板:AI 老師會在白板上畫圖、寫公式、一步一步解題。
  3. AI 同學:會主動開啟討論,你可以隨時插話,也可能被點名回答。
  4. 小考:單選、多選和簡答題,AI 當場批改並附上解析。
  5. 互動模擬和專題式學習(PBL):例如物理模擬器,或分配角色一起做專題。
官方 Demo 的課堂討論:AI 同學 Maya 問切線為什麼特別,AI 老師 Dr. Aris 解釋並在白板上加了一張圖
官方 Demo:AI 同學 Maya 發問,AI 老師 Dr. Aris 一邊回答、一邊在白板上開圖表。
官方 Demo 的小考報告:正確選項標成綠色並打勾,下方有藍色的 Analysis 解析
官方 Demo 的小考報告:答對的選項標綠色,下面附上解析。

能吃的講義格式很多:README 列了 PDF、Word、PowerPoint、試算表、文字、圖片、音訊和影片。做好的課還能匯出成可以編輯的 .pptx,或一個離線也能播放的 .html 檔。

03最快的試法:官方線上 Demo

open.maic.chat 首頁:OpenMAIC 標誌下方有一個輸入框,寫著告訴我你想學什麼,左下角有附加檔案的迴紋針按鈕,右下角是 Enter Classroom
官方線上 Demo(open.maic.chat):輸入想學的東西,或按左下角的迴紋針附上講義。
  1. 打開 https://open.maic.chat/ 。
  2. 在輸入框打你想學的東西,或按左下角的迴紋針,附上你的講義。
  3. 按右下角的 Enter Classroom 進教室。
丟講義時可以這樣打(把[]換成你的內容)
這是我[科目]的第[幾]章講義。我卡在[哪個觀念],請用白板一步一步畫給我看,讓 AI 同學先問我會問的問題,最後出 5 題小考,答錯的地方附解析。
沒有講義,只給主題也行
用 30 分鐘教我[主題],從完全不懂開始。先講最重要的三個觀念,每個觀念都在白板上畫一次,最後出小考。

04想自己架:官方的五個步驟

自己架的好處是講義留在自己的電腦、AI 用哪一家你自己選。你需要先裝好這三樣:Node.js 22.19 以上、pnpm 10 以上、PostgreSQL 16(官方附了一行用 Docker 開資料庫的指令)。

1. 下載並安裝(貼進終端機)
git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
2. 複製設定檔
cp .env.example .env.local
cp openmaic.example.yml openmaic.yml

3. 打開 .env.local,填上你的 AI 金鑰。範例檔預設只要 OPENAI_API_KEY;想用 Claude,就在 openmaic.yml 的 providers 加上 anthropic(金鑰寫 ${ANTHROPIC_API_KEY}),再把 slots 裡的 llm 指到 Claude 的模型,README 有範例。

官方 README 的 Providers 清單:OpenAI、Azure OpenAI、Anthropic、Amazon Bedrock、Google Gemini、DeepSeek 等
官方 README 支援的 AI 供應商,Anthropic(Claude)在第三個。
4. 開資料庫,5. 啟動
pnpm db:up
pnpm dev

跑 pnpm db:up 之後,記得把 .env.local 裡 DATABASE_URL 那一行前面的註解符號拿掉,沒有資料庫它不會啟動。最後打開 http://localhost:3000 就能用。

懶得自己打指令?請 Claude Code 幫你架(把[]換成你的情況)
幫我在這台電腦架 OpenMAIC(https://github.com/THU-MAIC/OpenMAIC)。照它 README 的 Quick Start 一步一步做:先檢查 Node.js、pnpm 和 Docker 的版本夠不夠,不夠就告訴我怎麼裝。我要用[Anthropic / OpenAI / 其他]的金鑰,設定檔改好之後停下來,讓我自己把金鑰貼進 .env.local,不要幫我填。最後幫我啟動,告訴我要打開哪個網址。

05要注意

  1. 免費的是程式(MIT 授權,商用也可以)。每次生成課程都會呼叫你接的 AI,費用由那家公司算,課程越長、開的功能越多(插圖、語音、影片),用量越大。
  2. 影片和這篇的畫面是官方 Demo,我沒有自己跑一堂完整的課;「幾分鐘做好一整堂課」是官方 README 的說法。
  3. AI 老師講的內容可能出錯,特別是公式和數字;拿來考前複習很好,但要對照課本。
  4. 自己架需要一直開著的伺服器和 PostgreSQL;官方建議正式使用時用 Docker 或程序管理工具讓它常駐。
  5. 專案更新很快(2026 年 11 月 9 日才出 v1.4.2),升級前先看官方的版本說明。

資料來源

延伸閱讀