THU-MAIC/OpenMAIC

OpenMAIC（Open Multi-Agent Interactive Classroom）是一个可自托管的开源平台，能把一句提示或一份文档变成可回放的课堂：幻灯片、测验、交互式 HTML 模拟和项目式学习活动，由会说话、会在白板画图并与学习者实时讨论的 AI 老师和 AI 同学呈现。它适合想要生成式课程而不只是聊天回答的教育者、课程作者和学习者，但前提是愿意自己运行一个服务器。

一节课如何生成

有两种生成模式。标准模式走两阶段流水线：先生成大纲，再把每个大纲条目变成丰富的场景。深度互动模式则构建动手单元——3D 可视化、过程模拟、小游戏、思维导图和浏览器内编程练习，在桌面、平板和手机上都能自适应，AI 老师还能操作界面来提示重点。材料支持 PDF、Word、PowerPoint、表格、文本、图片、音频和视频；解析器会把支持的类型转成生成输入。如果音视频提取不可用，这类材料会被标记为失败，而不是悄悄生成空转写。

如何运行

应用基于 Next.js/TypeScript，需要自托管。本地使用需要 Node.js ≥ 22.19、pnpm ≥ 10 和 PostgreSQL 16；缺少 DATABASE_URL 时服务器会拒绝启动并退出。课堂生成运行在长期服务进程里，所以浏览器离开页面后仍会继续。这也是 Vercel 等无服务器托管只支持到 1.1.x 的原因——1.2.0 及以后需要长期运行的 Node 进程加 PostgreSQL，可通过 Docker Compose 或 pnpm start 部署。提供的 Compose 文件明确是个人安装：只监听 localhost，且为单用户模式；若不加 ACCESS_CODE 就发布到网络，任何能访问端口的人都能拥有、编辑并删除整个课程库。

模型在服务端的 openmaic.yml 中声明，把提供商映射到大纲、幻灯片内容、语音、搜索等用途；密钥保存在 .env.local。许多能力是可选开启的：本地模型（Lemonade）、本地语音识别（FunASR）、文档解析（MinerU）、带声音克隆的自托管 TTS（VoxCPM2），以及 MP4 导出——后者需要单独的 Chromium+FFmpeg 渲染容器，没有时导出会退化为项目 ZIP。

导出与升级

课堂可导出为可编辑 PPTX、可离线播放的单文件 HTML，或用于备份和跨部署迁移的 ZIP；离线导出会把外部资源内联，以便在隔离网络中播放，但在此功能之前导出的课程需要重新导出。升级需要留意：1.3.0 要求先停止所有旧实例，且不支持降级到 1.3.0 以下；1.2.0 改变了身份/归属模式，应在首次启动前设置；Compose 部署另有升级说明。仓库采用 MIT 许可，允许商业使用，但两个随附的工作区包各有独立条款（其中一个为 LGPL-3.0-or-later）。代理工作台集成（OpenClaw、Codex 等）是可选的，且依赖对应工作台。

项目源码与说明