OpenMAIC

项目简介

OpenMAIC（Open Multi-Agent Interactive Classroom）是一个开源 AI 平台，可将任意主题或文档转化为丰富的互动课堂体验。它通过多智能体编排生成幻灯片、测验、交互式模拟和项目式学习活动，并由能够发言、在白板上绘图并进行实时讨论的 AI 教师和 AI 同学呈现。内置的 OpenMAIC Skill 还可与 OpenClaw 以及 Codex、DeepSeek、WorkBuddy 等智能体工作台配合使用，从而通过即时通讯应用或 IDE 生成课堂。

核心功能

• 一键从主题或附件材料生成课程；多智能体课堂中的 AI 教师与同学可实时讲授、讨论和互动；支持幻灯片、测验、交互式 HTML 模拟和项目式学习等场景；智能体可通过白板和语音合成绘制图表、书写公式并讲解；可导出保留全部场景的 PPTX、离线 HTML 课程或课堂 ZIP；通过 OpenMAIC Skill 与 OpenClaw、Codex、DeepSeek、WorkBuddy 等智能体工作台集成。

适用场景

• 根据主题或上传文档生成完整课程；与 AI 教师和 AI 同学开展互动课堂；创建项目式学习活动和交互式模拟；通过智能体工作台集成，从即时通讯应用或 IDE 生成课堂。

快速开始

• 前置条件为 Node.js 22.19 或更高版本、pnpm 10 或更高版本及 PostgreSQL 16。克隆仓库并运行 pnpm install。将 .env.example 复制为 .env.local，将 openmaic.example.yml 复制为 openmaic.yml，然后提供 OPENAI_API_KEY 或配置其他提供商。运行 pnpm db:up 启动数据库，取消 .env.local 中本地 DATABASE_URL 行的注释，再运行 pnpm dev，打开本地 3000 端口。

部署与要求

• OpenMAIC 需要 PostgreSQL 和 DATABASE_URL，缺少时服务器会拒绝启动。自 1.2.0 起，课程生成在服务器进程中运行，因此需要长期运行的 Node.js 进程和 PostgreSQL；Vercel 等无服务器托管不受支持。Docker Compose 以两个容器运行应用和 PostgreSQL，课程、生成媒体与运行时会话保存在命名卷中。构建后可运行 pnpm build 与 pnpm start，并保持服务器长期运行。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。