OpenMAIC

Overview

OpenMAIC (Open Multi-Agent Interactive Classroom) is an open-source AI platform that turns any topic or document into a rich, interactive classroom experience. Multi-agent orchestration generates slides, quizzes, interactive simulations, and project-based learning activities, delivered by AI teachers and AI classmates that can speak, draw on a whiteboard, and discuss in real time. The built-in OpenMAIC Skill also works with OpenClaw and agent workbenches such as Codex, DeepSeek, and WorkBuddy, so classrooms can be generated from messaging apps or an IDE.

Key Features

• One-click lesson generation from a topic or attached materials
• Multi-agent classroom with AI teachers and peers who lecture, discuss, and interact in real time
• Rich scene types including slides, quizzes, interactive HTML simulations, and project-based learning
• Whiteboard and text-to-speech support so agents can draw diagrams, write formulas, and explain aloud
• Export as a PPTX that keeps every scene, an offline HTML lesson, or a classroom ZIP
• Agent workbench integration through the OpenMAIC Skill with OpenClaw, Codex, DeepSeek, WorkBuddy, and more

Use Cases

• Generate a full lesson from a topic or uploaded document
• Run interactive classroom sessions with AI teachers and AI classmates
• Create project-based learning activities and interactive simulations
• Generate classrooms from messaging apps or an IDE through agent workbench integration

Getting Started

• Prerequisites are Node.js 22.19 or newer, pnpm 10 or newer, and PostgreSQL 16. Clone the repository and run pnpm install. Copy .env.example to .env.local and openmaic.example.yml to openmaic.yml, then provide OPENAI_API_KEY or configure another provider. Start the database with

Deployment & Requirements

• OpenMAIC requires PostgreSQL and a DATABASE_URL; the server refuses to start without one. From 1.2.0 it needs a long-running Node.js process with PostgreSQL because course generation runs on the server and survives closed tabs. Docker Compose runs the app and PostgreSQL as two

Before You Adopt

• License: MIT. Review its terms before using, modifying, or distributing the project.
• Upgrading to v1.3.0 has release conditions: stop all old instances first, and rollback below 1.3.0 is not supported.
• From 1.2.0, deployment needs a long-running Node.js process with PostgreSQL rather than serverless hosting.
• If ACCESS_CODE is unset, the deployment is not gated and every route, including the API, is reachable.
• Docker Compose runs in single-user mode, so every browser shares one library.