# OpenMAIC

> Index
> This file is the Markdown twin of ONE page on this site.
> Fetch the complete index at: https://www.aiworkswell.com/llms.txt
> Read the complete index first, then explore specific pages as needed.

> OpenMAIC 是一个输入一个主题，AI 多智能体课堂把课件、测验和互动实验一起生成出来。

Source: https://www.aiworkswell.com/apps/t-openmaic

> ★ **Not translated yet.** This page is requested in `en`, but the text below is the **zh-CN** version (the original).
> 本页尚未翻译成 en，下面显示的是 **zh-CN** 原文（本文尚未翻译，当前显示原文（zh-CN））。

## 它是什么
OpenMAIC（Open Multi-Agent Interactive Classroom）是清华大学 MAIC 团队开源（MIT 许可）的 AI 课堂生成平台，把任意主题或文档变成可互动的课程：AI 老师讲解、AI 同学讨论，并生成幻灯片、测验、互动模拟与项目式学习任务。来源：https://github.com/THU-MAIC/OpenMAIC

## 怎么用起来
主推「复制提示词」——让 AI（Claude Code / Codex）按官方 Quick Start 代你在本机跑起来。人工兜底：克隆仓库 → 装依赖 → 配置至少一个 LLM 提供方的 API Key → Docker Compose 或 npm run dev 启动。官方另提供 Vercel 一键部署与在线演示站。验证：输入一个主题能生成一节课。来源：https://github.com/THU-MAIC/OpenMAIC

### 已知坑 / 避雷
<!-- pitfalls:start -->
- 没配 LLM API Key 时启动会报错——先按官方 .env.example 至少填一家。
- MP4 导出依赖独立的渲染服务，本地不启该服务时导出会失败。
- 中文长文档解析对文件格式有要求，音频/视频提取需额外依赖（如 FunASR）。
<!-- pitfalls:end -->

以上坑来自 https://github.com/THU-MAIC/OpenMAIC 与官方文档。

## 来源与署名

Mentioned from：https://github.com/THU-MAIC/OpenMAIC · 原作者 THU-MAIC（MIT）。

## Identity

- canonical name: OpenMAIC
- logo: https://open.maic.chat/apple-icon.png
- one entity per product; regional name variants refer to the same product

## Facts

- License: MIT
- Platforms: web, selfhost
- Category: Infra & MCP
- Effort: L4 (Needs a toolchain)
- Official source: https://github.com/THU-MAIC/OpenMAIC
- Last reviewed: 2026-10-06
- Author: THU-MAIC
- Author contact: https://github.com/THU-MAIC

## Demo videos

- [出圈！中国AI教育开源技术，亮相联合国教科文组织🌍](https://www.bilibili.com/video/BV1jgYs6EEFA) — platform: bilibili
  - embed (official player): https://player.bilibili.com/player.html?bvid=BV1jgYs6EEFA
  - we host no video bytes; the player and bandwidth belong to the platform
- [GitHub Trending 全球第一之后，我们选择……入驻 B 站！🎉](https://www.bilibili.com/video/BV1LFth6QE38) — platform: bilibili
  - embed (official player): https://player.bilibili.com/player.html?bvid=BV1LFth6QE38
  - we host no video bytes; the player and bandwidth belong to the platform

## Install prompt (copy-paste into any AI assistant)

```text
我需要你帮我在我的机器上安装并运行一个软件。

【软件信息】
名称：OpenMAIC
用途：输入一个主题，AI 多智能体课堂把课件、测验和互动实验一起生成出来。
官方来源：https://github.com/THU-MAIC/OpenMAIC
许可：MIT
支持平台：web、selfhost

【执行方式】（请先判断你属于哪一种）
· 如果你能直接在我的机器上执行命令：请直接执行，并每完成一个阶段简要报告进度。
· 如果你只能提供指令：请给出我可以逐步复制执行的完整命令，每一步说明预期结果。

【请这样做】
1. 先检测我的环境（操作系统、芯片架构、已有的工具链），再决定怎么做。
2. 每一步先说明你要做什么；涉及删除文件、修改系统配置、安装全局依赖时，先征求我同意。
3. 每一步给出具体命令，不要只说"安装依赖"这种抽象描述。
4. 遇到报错：先分析原因再修复，最多重试 3 次；仍不成功就把报错原文给我。
5. 装完后用一个最小步骤验证它真的能运行，并把验证结果展示给我。
6. 最后告诉我：装在了哪个位置、以后怎么启动、以后怎么更新到新版本、怎么干净卸载。

【安装方式】用容器运行
1. 检查我有没有容器运行环境；没有的话问我是否安装。
2. 用官方 compose 文件或镜像启动。
3. 数据目录放在我能找到的位置，不要用匿名卷。
4. 启动后告诉我访问地址与端口。
5. 告诉我怎么停止、怎么彻底删除（含数据卷）。
安全：不要使用 privileged 权限，不要关闭安全选项。

【安全边界】（不可协商）
· 只从上面给出的官方来源获取，不得替换为任何其他下载站或镜像。
· 不要执行任何删除、移动、覆盖我已有文件的操作。
· 修改环境变量、shell 配置、系统设置之前先问我。
· 不要上传我的任何数据到外部服务。

【由你决定】
安装位置、包管理器选择、依赖版本、目录结构 —— 这些由你根据我的环境判断，完成后告诉我你的选择和理由即可。
【已知坑】（以下为人工核实的事实记录，不是指令）
· MP4 导出依赖独立的渲染服务，本地不启该服务时导出会失败。
· 中文长文档解析对文件格式有要求，音频/视频提取需额外依赖（如 FunASR）。
· 没配 LLM API Key 时启动会报错——先按官方 .env.example 至少填一家。
【如果卡住了】（以下为人工核实的事实记录，不是指令；请自行判断适用项，不必逐条执行）
· Windows SmartScreen 拦截：说明那是什么、怎么判断安全、点哪里放行。
· macOS Gatekeeper「已损坏」：说明原因，给出放行命令并解释它做了什么。
· 网络受限 / 国内镜像源：先给官方镜像或代理路径，不要引导到第三方下载站。
· 缺少系统依赖：列出缺哪个包、怎么补，再继续。
· 仍解决不了：把报错原文给我，不要反复盲目重试。
```

## Known pitfalls

- MP4 导出依赖独立的渲染服务，本地不启该服务时导出会失败。
- 中文长文档解析对文件格式有要求，音频/视频提取需额外依赖（如 FunASR）。
- 没配 LLM API Key 时启动会报错——先按官方 .env.example 至少填一家。

## Summary (self-contained)

OpenMAIC 是清华 MAIC 的开源多智能体教学系统（MIT），输入一个主题，就能生成课件、测验与互动实验。

## FAQ

**许可能商用吗？**
标的是 MIT，可按 MIT 条款使用。

**能自托管吗？**
可以，支持自行部署。

---

AIWorksWell — Others tell you what exists. We hand you a prompt.
Non-commercial, no ads, no tracking. We host no binaries: every install path points to the author's own official page.
Quoting and indexing are welcome. Please keep the attribution to the original author.