3.3 万星的开源 AI 课堂 OpenMAIC 完整拆解:多智能体教学、离线内网部署与模型接入全讲清

3.3 万星的开源 AI 课堂 OpenMAIC 完整拆解:多智能体教学、离线内网部署与模型接入全讲清

【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAIC

OpenMAIC(Open Multi-Agent Interactive Classroom)是清华 MAIC 团队开源的多智能体 AI 课堂工具:输入一个主题或上传教材,系统自动生成幻灯片、测验、交互式模拟与 PBL 项目式学习场景,再由 AI 老师和 AI 同学实时授课、白板板书和讨论。它于 2026 年 3 月开源,30 天内收获 1.6 万星,8 月底突破 3.3 万星。本文不讲故事,只带你在源码里核对四件事:课程怎么生成、课堂怎么跑进离线内网、多智能体调度怎么控制成本、以及它面向多语言市场做了哪些工程准备。

课程从哪里来:一句指令到一门完整课

在 OpenMAIC 里生成课程不需要模板。用户描述一个主题或附上教材,Agent 先判断整门课要把学生带到哪里,再决定每节课承担什么任务,然后规划、生成、检查、修改、迭代,直到产出一套完整课程——避免教学目标冲突和内容重复。这个"能把活干完"的能力由服务端运行时支撑:lib/server/agent-runtime/ 提供 PostgreSQL 支撑的持久化会话、租约与心跳机制(config.ts 中心跳默认 2000ms、租约 TTL 10 秒),会话崩溃后可在其他节点恢复并接管后续指令。

课程设计范式可以一键切换。skills/agent-runtime/ 下内置 20 多个教学法技能,包括 curriculum-planner(课程规划)、spiral-curriculum(螺旋课程)、understanding-by-design(逆向设计)、zone-of-proximal-development(最近发展区)、k12-core-literacy-planning(2022 课标核心素养规划)与 social-emotional-learning(社会情感学习)。社区流传的经典案例是:把《2001:太空漫游》喂给系统,它拆解学习目标、提取全书结构,为初中生规划出横跨数学、社会学、政治博弈与文学创作的一周课程,最终衍生出 14 节沿同一学习主线展开、配齐 PPT/Quiz/交互网页/PBL 的课。按传统方式,这种系统性备课往往需要一个教研组打磨一两周。

如何离线运行:把一整堂课装进内网服务器

出海教育最常被忽视的约束是:许多学校没有公网,或数据主权规则不允许课程内容离开内网。OpenMAIC 对此有明确方案。

导出 Classroom ZIP(.maic.zip)或 Resource Pack 时,系统会把互动场景引用的 KaTeX、Three.js、Tailwind CDN、Google Fonts 与图片全部内联为data:URI,导入隔离/内网实例后课程可完全离线播放,回放期间不接触任何公网 CDN;导出时拿不到的资源会被报告并保留为 URL(详见 README.md 的 Export 章节)。

部署路径上,仓库同时提供三种落地方式:

  • 官方托管版 open.maic.chat,通过访问码分发,不懂代码也能体验;
  • 本地开发:pnpm dev或pnpm build && pnpm start;
  • Docker 一键部署:docker compose up --build,含 PostgreSQL 双容器栈。

语音链路也可以本地化。README.md 的 VoxCPM2 章节描述了三种语音模式:Auto Voice(按 Agent 人设自动生成语音提示)、Prompt voice(自然语言描述音色)、Clone voice(上传参考音频克隆音色),整套 TTS 跑在自己的硬件上、无需 API key。再配合 FunASR 本地语音识别(支持 SenseVoiceSmall、Paraformer 等模型,CPU 或 GPU 均可),一堂课可以完全在校园内网里运行。

多智能体课堂如何调度:控制 LLM 调用与轮次上限

OpenMAIC 的课堂由一个"导演"角色调度:它决定下一位发言的 Agent,讲师、学生等不同角色按回合交替推进。课堂主循环实现在 lib/chat/pi/director-loop.ts,系统提示词由 lib/chat/pi/prompts.ts 构建,lib/orchestration/ 则提供 Agent 注册与状态摘要。两个工程细节值得注意:

  1. 硬性上限:lib/chat/pi/config.ts 把每轮对话的 Agent 轮次上限(默认 6)和单 Agent 动作数上限(默认 8)写死为常量,课堂节奏有确定性兜底;
  2. 按需调用:单 Agent 场景下导演走纯代码逻辑、零 LLM 调用,多 Agent 场景才启用大模型决策——用最少的大模型调用换取课堂节奏的确定性。

模型接入同样解耦。openmaic.example.yml 把配置拆成两层:providers(可调用的账号)与slots(每个 AI 用途对应一个模型),并支持lock锁定默认值或allowUserKeys: false禁止用户自带密钥。官方支持的提供商超过 20 家:OpenAI、Anthropic、Amazon Bedrock、Google Gemini、DeepSeek、Qwen、Kimi、MiniMax、Grok、GLM、Ollama,以及 Lemonade 本地推理和任意 OpenAI 兼容 API。欧洲学校可以用 Bedrock 满足数据合规,国内机构接 DeepSeek/Qwen 压低推理成本,离线机构跑 Lemonade——课堂生成能力与具体模型完全解耦,这是跨市场复制的前提。

国际版本演进:从浏览器端到 server-first 的基础设施

界面层的国际化可以直接数出来:lib/i18n/locales.ts 注册了 12 个地区代码,覆盖简体中文、繁体中文、英语、日语、韩语、俄语、阿拉伯语、巴西葡语、墨西哥西语、法语、越南语与德语;lib/i18n/workbench-locales/ 为 Agent 工作台补齐了其中 10 种语言的文案,由 lib/i18n/config.ts 深度合并解析。此外,skills/openmaic/SKILL.md 做成标准 Skill 包,可被 OpenClaw、Codex、DeepSeek、WorkBuddy 等 Agent 工作台加载,用户可以直接在飞书、Slack、Telegram 等 20+ 聊天应用里生成并查看一堂互动课,不用碰终端。

学术端,README.md 的 Citation 章节收录了发表于《Journal of Computer Science and Technology》的论文《From MOOC to MAIC: Reimagine Online Teaching and Learning through LLM-driven Agents》。从 MOOC 到 MAIC 的提法本身就是一套叙事:在线教学的载体从"大规模在线课程"变成了"可运行、可复现、可二次开发的开源课堂"。

版本线(见 CHANGELOG.md)勾勒出演进节奏:3 月 v0.1.0 开源,2026 年 8 月底 v1.0.0 引入 Agent 工作台与持久化会话;v1.2.0(2026-10-16)是转折点——生成逻辑整体搬到服务端,课程生成可跨关闭标签页与重启存活,模型在openmaic.yml统一配置,Web 应用与 API 共享同一条生成管线,代价是必须部署 PostgreSQL 和长驻 Node 服务器(serverless 环境仍停留在 1.1.x);v1.2.1(2026-10-18)再补上网络研究能力,Kimi、DeepSeek、Firecrawl 接入网页搜索。从浏览器端到服务端、从单节课到整门课,这条从演示走向基础设施的路径,正是 OpenMAIC 用源码给出的答案:MIT 许可允许任何团队二次开发,离线导出把一节课装进任何内网,而课堂属于任何能运行这份代码的地方。

【免费下载链接】OpenMAICOpen Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click项目地址: https://gitcode.com/GitHub_Trending/op/OpenMAIC

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

波分复用器原理与选型全解析:TFF/AWG、CWDM/DWDM一文看懂

波分复用器原理与选型全解析:TFF/AWG、CWDM/DWDM一文看懂

每次遇到波分复用器,我总会想起早年间在某个城域网机房里的扩容场景:两个核心节点之间的光纤资源已经用光,新增的10G业务等着开通,重新敷设光缆要等规划、施工、割接,周期长得让人头大。当时传输岗的同事拿出几台波分复…

2026/10/20 10:41:31 阅读更多 →
C#上位机与Zigbee串口通信实战:数据解析与控制指令详解

C#上位机与Zigbee串口通信实战:数据解析与控制指令详解

简介:面向C#/Zigbee上位机开发者的完整工程包,适用于需要实现串口通信、Zigbee传感器数据采集、界面显示与设备控制的物联网项目。资源包含小区燃气监控系统上位机源码、可执行程序及相关工程配置,便于学习从SerialPort串口收发、数据解析到M…

2026/10/20 10:41:31 阅读更多 →
深入解析C语言尾队列TAILQ:内存布局与核心宏原理

深入解析C语言尾队列TAILQ:内存布局与核心宏原理

我最早看到TAILQ_INSERT_TAIL()的时候,心里其实很疑惑:Linux 内核不是已经有一套list_head了吗,为什么还要再搞一套“尾队列”?直到有一次在一段网络驱动代码里追数据的入队和出队逻辑,发现对方用的是 BSD 风味的TAILQ…

2026/10/20 10:40:28 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/10/21 9:32:40 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/10/21 9:32:40 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/10/21 9:32:40 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/10/21 9:32:40 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/10/21 9:32:40 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/10/21 9:31:32 阅读更多 →

日新闻

统一内存+量化:锐龙AI Max PRO 400如何本地跑320B大模型

统一内存+量化:锐龙AI Max PRO 400如何本地跑320B大模型

这段时间硬件圈和AI圈都在传一个事:AMD锐龙AI Max PRO 400系列把最高192GB统一内存搬进了PC形态的产品里,按宣传口径,本地跑320B参数的大家伙不再是纸面概念。我第一反应倒不是“内存真大”,而是这话背后的含金量——它把过去只能…

2026/10/21 0:00:11 阅读更多 →
AI助手深度使用体验:对话质量、长文本处理与指令遵循如何留住用户

AI助手深度使用体验:对话质量、长文本处理与指令遵循如何留住用户

1. 从“封号重开”这个行为说起:用户到底在追求什么“封号重开”这四个字,放在任何产品语境里都带着一股决绝的味道。一个账号从零开始积累使用记录、调教偏好、沉淀工作流,背后是大量的时间和精力成本。正常情况下,没有人愿意主动…

2026/10/21 0:00:11 阅读更多 →
ROS中YOLOv3工程落地:通信同步、坐标变换与性能调优

ROS中YOLOv3工程落地:通信同步、坐标变换与性能调优

1. 为什么在ROS里硬刚YOLOv3不是“炫技”,而是工程落地的必经之路我第一次在某高校机器人实验室看到那台搭载Jetson TX2的移动底盘原地打转、反复识别错垃圾桶时,就意识到:单纯跑通darknet_ros demo和真正让YOLOv3在ROS里“干活”&#xff0c…

2026/10/21 0:00:11 阅读更多 →

周新闻

基于GMM的语音识别系统原理与MATLAB实现详解

基于GMM的语音识别系统原理与MATLAB实现详解

说到基于高斯混合模型(GMM)的语音识别系统,很多人第一反应就是一堆数学公式,觉得门槛很高。但如果你真的在MATLAB里把它落地跑通,会发现核心其实就是三件事:把声音变成特征向量,用GMM给每个类别…

2026/10/20 10:02:13 阅读更多 →
数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理这四个字听起来挺唬人,但落到具体操作上,无非就是让计算机按你的想法“摆弄”像素。我在一个模拟项目X里用了一套特别经典的基础处理流程:对图像做反白、改调色板、彩色转灰度,最后把像素数据导出成txt文件。单看每一…

2026/10/20 20:43:59 阅读更多 →
机器人大脑技术盘点:具身智能的感知、决策与数据闭环

机器人大脑技术盘点:具身智能的感知、决策与数据闭环

如果你的信息流最近也天天刷到“机器人大脑”这个词,你会发现一个很有意思的现象:每个人说的“大脑”根本不是同一个东西。有人指的是大语言模型,有人指的是运动控制系统,还有人指的是能理解物理世界的端到端模型。在2026年这个时…

2026/10/21 4:27:17 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 10:02:08 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 9:50:17 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/20 9:50:45 阅读更多 →