OpenMAIC 怎么部署到 Vercel？

OpenMAIC 怎么部署到 Vercel？

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

OpenMAIC 是一个标准的 Next.js 应用，可以直接部署到 Vercel，得到一个可在线访问的 AI 互动课堂。完成部署后，你得到的是一个公网地址，访客打开即可生成和播放课程。前提是：你需要为至少一个 LLM 提供方配置 API key，否则课堂生成无法工作。本文只覆盖 Vercel 这条部署路径；Docker 和自建主机的方案见 部署文档。

准备条件

部署前只需要确认两件事：

• 一个至少配置了某个 LLM 提供方 key 的环境。配置文档中列出的常用 key 包括OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY、OPENROUTER_API_KEY、GROK_API_KEY等，任一即可；
• 如果要给共享 demo 加站点级密码，再准备一个ACCESS_CODE（可选，见下文）。

仓库根目录的 vercel.json 已经声明了 Vercel 的构建方式，部署时无需自行修改：

{ "$schema": "https://openapi.vercel.sh/vercel.json", "framework": "nextjs", "installCommand": "pnpm install", "buildCommand": "pnpm build", "functions": { "app/api/**/*.ts": { "maxDuration": 300 } } }

即 Vercel 会按 Next.js 框架识别项目，用pnpm install安装依赖、pnpm build构建，且app/api下的函数最长可运行 300 秒。

路径一：README 的 Deploy 按钮（最快）

仓库 README 顶部有一个 "Deploy with Vercel" 按钮，点击后会引导你 fork 仓库、进入 API key 填写提示。按提示填入至少一个 LLM 的 API key，然后完成部署即可。这是官方文档中说明的最快路径。

路径二：手动导入 Vercel

不想用按钮时，部署文档给出的手动流程是四步：

1. Fork 仓库；
2. 在 Vercel 中新建项目并导入该 fork；
3. 设置环境变量——最少填入一个 LLM 的 API key；
4. 点击部署。

每次提交代码后，Vercel 会自动重新构建并部署这个 Next.js 应用；部署后如果换 key 或加功能开关，同样在项目设置里改环境变量并触发重建。

可选：设置站点级密码

如果部署是给团队演示或课堂共享用的，配置文档建议设置ACCESS_CODE：

ACCESS_CODE=your-secret-code

在 Vercel 项目的环境变量中加入这一项后，访客在打开应用前会被要求先输入密码；密码只提示一次，保存在 HTTP-only cookie 中。不设置时应用照常访问。注意 README 提到该部署方式下所有 API 路由同样受这个密码门保护。

Vercel 部署的两个限制

• 默认只有浏览器端持久化。Vercel 部署的课堂状态保存在访客浏览器的 IndexedDB 中。文档明确说明：server-persistence这个 Docker Compose profile 不能直接用于 Vercel。如果你需要服务端持久化（PostgreSQL），要改用外部 PostgreSQL 加服务端部署的方案。
• NEXT_PUBLIC_*是构建时变量。这些功能开关在构建时注入客户端，只改 Vercel 环境变量而不重新构建不会生效；改完需要触发一次重建。

验证部署

部署完成后，打开 Vercel 分配的应用地址：

• 如果设置了ACCESS_CODE，先输入密码才能进入应用；
• 进入首页后提交一次课程生成，能正常产出课堂内容，说明 LLM key 配置生效——这也是文档中反复强调"至少配置一个 LLM 提供方"的原因：不配置 key，应用可以打开但无法生成课程。

如果后续需要服务端存储、视频导出渲染服务等 Vercel 上无法直接运行的能力，回到 部署文档 查看 Docker 或自建虚拟机方案。

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