THU-MAIC/OpenMAIC

OpenMAIC – 开放多智能体互动课堂

简介 – OpenMAIC 是一个开源 Web 平台，允许您将任何主题、文档或学习材料转变为功能齐全、由 AI 驱动的课堂。它协调多个 AI 代理（教师、同学、白板助手、TTS 语音等）来生成幻灯片、测验、交互式 HTML 模拟和基于项目的学习活动，然后通过浏览器 UI 实时呈现。

主要功能

• 一键式课程生成 – 描述学科或上传源文件，系统会自动构建完整的课程（大纲、幻灯片内容、图片、音频旁白、可选视频）。
• 多代理交互 – AI“教师”和“同伴”可以说话、在共享白板上绘画、回答问题并运行模拟，提供对话式学习体验。
• 丰富媒体输出 – 导出可编辑的 PowerPoint（.pptx）演示文稿或自包含的交互式 HTML 页面；媒体可存储在 PostgreSQL 或 S3 中。
• 代理工作台集成 – 内置的 OpenMAIC 技能 可与 OpenClaw、Codex、DeepSeek、WorkBuddy 等许多代理框架配合使用，因此可以从飞书、Slack、Telegram 或直接在 IDE 中生成课堂。
• 可插拔模型提供商 – 支持 OpenAI、Anthropic、Azure OpenAI、Amazon Bedrock、Gemini、Qwen、MiniMax、Grok、TokenDance、小米 MiMo、智谱 GLM、Ollama、Lemonade（本地）以及任何 OpenAI 兼容 API。模型使用情况通过一个简单的 openmaic.yml 文件配置，该文件将槽位（大纲、幻灯片文本、TTS、Web 搜索等）映射到特定提供商。
• 服务器后端持久化 – 课程、聊天记录、生成的媒体和用户会话存储在 PostgreSQL 中，允许生成过程在关闭标签页或服务器重启后继续存在。
• 可通过 Docker 或本地部署 – 开发使用 pnpm 和基于 Docker 的 PostgreSQL；生产环境可以作为长期运行的 Node.js 进程（Docker Compose）运行，或者对于较旧的 1.1.x 版本，可以在 Vercel 无服务器上运行。

典型用例

场景	OpenMAIC 的用途
教育工作者为课堂或工作坊构建快速、互动的课程。	在几分钟内生成幻灯片、测验和实时模拟；导出到 PowerPoint 以供离线使用。
企业培训师需要即时的培训模块。	上传产品文档，让 AI 创建带有语音旁白和互动演示的结构化课程。
学生想要课本章节的个人导师。	描述章节，获得一个可以回答后续问题并绘制解释的多代理课堂。
开发人员/IDE 用户希望将学习嵌入到工作流程中。	使用 OpenClaw 或其他工作台中的 OpenMAIC 技能，直接从消息渠道或代码编辑器启动课程。
研究人员试验多代理编排。	开源技术栈（Next.js、LangGraph、Tailwind）完全可访问，可用于扩展代理或添加新模式。

快速入门（本地开发）

# 1. 克隆仓库
git clone https://github.com/THU-MAIC/OpenMAIC.git && cd OpenMAIC

# 2. 安装依赖项（pnpm ≥10）
pnpm install

# 3. 设置配置
cp .env.example .env.local            # put your API keys here
cp openmaic.example.yml openmaic.yml  # edit model slots if desired
# At minimum you need OPENAI_API_KEY (or another provider key)

# 4. 启动 PostgreSQL 实例（Docker 辅助）
pnpm db:up
# The helper creates a DB at postgres://openmaic:openmaic-dev@127.0.0.1:5432/openmaic

# 5. 运行开发服务器
pnpm dev

# 在浏览器中打开 http://localhost:3000 并开始生成课程。

生产环境/Docker 部署

# 准备包含密钥的环境文件
cp .env.example .env.local && nano .env.local

# 构建并运行应用和 PostgreSQL
docker compose up --build -d

Compose 堆栈创建两个容器（应用 + Postgres）并将数据持久化在命名卷（openmaic-postgres、openmaic-data）中。对于多用户部署，请在发布前设置 ACCESS_CODE 和强密码 PERSISTENCE_POSTGRES_PASSWORD。

了解更多

• 用户指南 – 英文和中文指南链接在 README 顶部。
• 文档 – 详细文档位于 packages/docs/content/docs/（配置、支持的模型、部署、托管等）。
• 在线演示 – https://open.maic.chat/ 展示了 UI 的实际效果。
• 社区 – 提供 Discord 和飞书链接以供支持和讨论。

---

OpenMAIC 是一个真正的、积极维护的 AI 项目，专注于多代理课堂生成、模型编排和交互式学习体验。它完全契合前沿 AI/ML 领域（LLM 编排、RAG、多模态生成和 AI 驱动的教育）。