Get an immersive, multi-agent learning experience in just one click

English | 简体中文
Fork Notice · Quick Start · Features · Use Cases · Open Source Notice

This repository contains DeepWit's OpenMAIC-based edition.

It keeps the upstream OpenMAIC license and attribution, and the source code for this edition is available in this repository. To run it yourself, configure your own model provider keys and deployment settings.

For details, see LICENSE, NOTICE, and OPEN_SOURCE_COMPLIANCE.md. Do not commit API keys, production credentials, or user data to this repository.

• 2026-04-26 — v0.2.1 released! Integrated VoxCPM2 TTS with voice cloning and on-the-fly auto-generated voices; added per-model thinking config; added end-of-course completion page with persistent quiz state; added latest released models including DeepSeek-V4 / GPT-5.5 / GPT-Image-2 / Xiaomi MiMo / Hy3. See changelog.
• 2026-04-20 — v0.2.0 released! Deep Interactive Mode — 3D visualization, simulations, games, mind maps, and online programming for hands-on learning. See features for details.
• 2026-04-14 — v0.1.1 released! Automatic language inference, ACCESS_CODE authentication, classroom ZIP export/import, custom TTS/ASR providers, Ollama support, and more. See changelog.
• 2026-03-26 — v0.1.0 released! Discussion TTS, immersive mode, keyboard shortcuts, whiteboard enhancements, new providers, and more. See changelog.

OpenMAIC (Open Multi-Agent Interactive Classroom) is an open-source AI platform that turns any topic or document into a rich, interactive classroom experience. Powered by multi-agent orchestration, it generates slides, quizzes, interactive simulations, and project-based learning activities — all delivered by AI teachers and AI classmates who can speak, draw on a whiteboard, and engage in real-time discussions with you. With built-in OpenClaw integration, you can generate classrooms directly from messaging apps like Feishu, Slack, or Telegram.

https://github.com/user-attachments/assets/b4ab35ac-f994-46b1-8957-e82fe87ff0e9

• One-click lesson generation — Describe a topic or attach your materials; the AI builds a full lesson in minutes
• Multi-agent classroom — AI teachers and peers lecture, discuss, and interact with you in real time
• Rich scene types — Slides, quizzes, interactive HTML simulations, and project-based learning (PBL)
• Whiteboard & TTS — Agents draw diagrams, write formulas, and explain out loud
• Export anywhere — Download editable .pptx slides or interactive .html pages
• OpenClaw integration — Generate classrooms from Feishu, Slack, Telegram, and 20+ messaging apps via your AI assistant

• Node.js >= 20
• pnpm >= 10

git clone https://cnb.cool/deepwitedu/deepwit-OpenMAIC.git
cd deepwit-OpenMAIC
pnpm install

cp .env.example .env.local

Fill in at least one LLM provider key:

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
GROK_API_KEY=xai-...
OPENROUTER_API_KEY=sk-or-...
TENCENT_API_KEY=sk-...
XIAOMI_API_KEY=...

You can also configure providers via server-providers.yml:

providers:
  openai:
    apiKey: sk-...
  anthropic:
    apiKey: sk-ant-...

Supported providers: OpenAI, Anthropic, Google Gemini, DeepSeek, Qwen, Kimi, MiniMax, Grok (xAI), OpenRouter, Doubao, Tencent Hunyuan/TokenHub, Xiaomi MiMo, GLM (Zhipu), Ollama (local), and any OpenAI-compatible API.

OpenAI quick example:

OPENAI_API_KEY=sk-...
DEFAULT_MODEL=openai:gpt-5.5

MiniMax quick examples:

MINIMAX_API_KEY=...
MINIMAX_BASE_URL=https://api.minimaxi.com/anthropic/v1
DEFAULT_MODEL=minimax:MiniMax-M2.7-highspeed

TTS_MINIMAX_API_KEY=...
TTS_MINIMAX_BASE_URL=https://api.minimaxi.com

IMAGE_MINIMAX_API_KEY=...
IMAGE_MINIMAX_BASE_URL=https://api.minimaxi.com

IMAGE_OPENAI_API_KEY=...
IMAGE_OPENAI_BASE_URL=https://api.openai.com/v1

VIDEO_MINIMAX_API_KEY=...
VIDEO_MINIMAX_BASE_URL=https://api.minimaxi.com

GLM (Zhipu) quick examples:

# China (default)
GLM_API_KEY=...
GLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4

# International (z.ai)
GLM_API_KEY=...
GLM_BASE_URL=https://api.z.ai/api/paas/v4

DEFAULT_MODEL=glm:glm-5.1

Recommended model: Gemini 3 Flash — best balance of quality and speed. For highest quality (at slower speed), try Gemini 3.1 Pro.

If you want OpenMAIC server APIs to use Gemini by default, also set DEFAULT_MODEL=google:gemini-3-flash-preview.

If you want to use MiniMax as the default server model, set DEFAULT_MODEL=minimax:MiniMax-M2.7-highspeed.

pnpm dev

Open http://localhost:3000 and start learning!

pnpm build && pnpm start

To protect your deployment with a site-level password, set ACCESS_CODE in .env.local:

ACCESS_CODE=your-secret-code

When set, visitors see a password prompt before accessing the app. All API routes are also protected. If not set, the app works as before.

This public fork does not ship a one-click Vercel button because the canonical source repository is hosted on CNB Cool rather than a Vercel-native Git provider.

If you want to deploy on Vercel:

1. Fork or mirror this repository to a Git provider supported by Vercel
2. Import the mirrored repository into Vercel
3. Set environment variables (at minimum one LLM API key)
4. Deploy

cp .env.example .env.local
# Edit .env.local with your API keys, then:
docker compose up --build

MinerU provides enhanced parsing for complex tables, formulas, and OCR. You can use the MinerU official API or self-host your own instance.

Set PDF_MINERU_BASE_URL (and PDF_MINERU_API_KEY if needed) in .env.local.

VoxCPM2 is an open-source TTS model from OpenBMB with voice cloning. OpenMAIC ships an adapter; run VoxCPM on your own hardware and OpenMAIC will talk to it.

1. Run a VoxCPM backend. Three deployment styles, all behind the same OpenMAIC adapter. You toggle which one in Settings.

See the VoxCPM repo for backend setup.

2. Point OpenMAIC at it. Open Settings → Text-to-Speech → VoxCPM2, pick the backend, and paste your Base URL. The Request URL preview confirms OpenMAIC will hit the right endpoint.

Or pre-configure it via env var (no API key required):

TTS_VOXCPM_BASE_URL=http://localhost:8000/v1

3. Manage voices. Three voice modes, all under Settings → Text-to-Speech → VoxCPM2 → VoxCPM Voices.

• Auto Voice (default): OpenMAIC generates a voice prompt from each agent's persona at synthesis time. No setup required.
• Prompt voice: describe the voice in natural language, e.g. "warm female teacher voice, calm and encouraging, mid-pitch".
• Clone voice: upload a short reference audio clip or record one in the browser. The clip is stored in IndexedDB and sent to your VoxCPM backend on each synthesis.

Passive listening? ❌ Hands-on exploration! ✅

As Einstein said: "Play is the highest form of research."

While Standard Mode focuses on quickly generating classroom content, Deep Interactive Mode goes further — creating interactive, explorable, hands-on learning experiences. Students don't just watch knowledge; they adjust experiments, observe simulations, and actively explore how things work.

🌐 3D Visualization Three-dimensional visual representations that make abstract structures more intuitive.	⚙️ Simulation Process simulations and experimental environments for observing dynamic changes and outcomes.
🎮 Game Knowledge-based mini-games that reinforce understanding and memory through interactive challenges.	🧭 Mind Map Structured knowledge organization to help learners build an overall conceptual framework.
💻 Online Programming In-browser coding and instant execution for learning by writing, testing, and iterating.

The AI teacher can actively operate the UI to guide students — highlighting key areas, setting conditions, providing hints, and directing attention at the right moments.

All generated interactive UI is fully responsive — desktop, tablet, or mobile.

Desktop	Mobile
iPad

If you are looking for a version with richer functionality, stronger interactivity, and deeper optimization for high-quality educational UI production, please visit MAIC-UI.

Describe what you want to learn or attach reference materials. OpenMAIC's two-stage pipeline handles the rest:

🎓 Slides AI teachers deliver lectures with voice narration, spotlight effects, and laser pointer animations — just like a real classroom.	🧪 Quiz Interactive quizzes (single / multiple choice, short answer) with real-time AI grading and feedback.
🔬 Interactive Simulation HTML-based interactive experiments for visual, hands-on learning — physics simulators, flowcharts, and more.	🏗️ Project-Based Learning (PBL) Choose a role and collaborate with AI agents on structured projects with milestones and deliverables.

Classroom Discussion — Agents proactively initiate discussions; you can jump in anytime or get called on Roundtable Debate — Multiple agents with different personas discuss a topic, with whiteboard illustrations Q&A Mode — Ask questions freely; the AI teacher responds with slides, diagrams, or whiteboard drawings Whiteboard — AI agents draw on a shared whiteboard in real time — solving equations step by step, sketching flowcharts, or illustrating concepts visually.

OpenMAIC integrates with OpenClaw — a personal AI assistant that connects to messaging platforms you already use (Feishu, Slack, Discord, Telegram, WhatsApp, etc.). With this integration, you can generate and view interactive classrooms directly from your chat app without ever touching a terminal.

Just tell your OpenClaw assistant what you want to learn — it handles everything else:

• Hosted mode — Grab an access code from open.maic.chat, save it in your config, and generate classrooms instantly — no local setup required
• Self-hosted mode — Clone, install dependencies, configure API keys, and start the server — the skill guides you through each step
• Track progress — Poll the async generation job and send you the link when ready

Every step asks for your confirmation first. No black-box automation.

clawhub install openmaic

mkdir -p ~/.openclaw/skills
cp -R /path/to/OpenMAIC/skills/openmaic ~/.openclaw/skills/openmaic

{
  "skills": {
    "entries": {
      "openmaic": {
        "config": {
          // Hosted mode: paste your access code from open.maic.chat
          "accessCode": "sk-xxx",
          // Self-hosted mode: local repo path and URL
          "repoDir": "/path/to/OpenMAIC",
          "url": "http://localhost:3000"
        }
      }
    }
  }
}

• Text-to-Speech — Multiple voice providers with customizable voices
• Speech Recognition — Talk to your AI teacher using your microphone
• Web Search — Agents search the web for up-to-date information during class
• i18n — Interface supports Chinese, English, Japanese, and Russian
• Dark Mode — Easy on the eyes for late-night study sessions

"Teach me Python from scratch in 30 min"	"How to play the board game Avalon"
"Analyze the stock prices of Zhipu and MiniMax"	"Break down the latest DeepSeek paper"

We welcome contributions from the community! Whether it's bug reports, feature ideas, or pull requests, every bit helps.

Before opening changes, please read CONTRIBUTING.md and OPEN_SOURCE_COMPLIANCE.md. Please keep pull requests focused, describe the user-facing impact, and avoid committing secrets or private data.

OpenMAIC/
├── app/                        # Next.js App Router
│   ├── api/                    #   Server API routes (~18 endpoints)
│   │   ├── generate/           #     Scene generation pipeline (outlines, content, images, TTS …)
│   │   ├── generate-classroom/ #     Async classroom job submission + polling
│   │   ├── chat/               #     Multi-agent discussion (SSE streaming)
│   │   ├── pbl/                #     Project-Based Learning endpoints
│   │   └── ...                 #     quiz-grade, parse-pdf, web-search, transcription, etc.
│   ├── classroom/[id]/         #   Classroom playback page
│   └── page.tsx                #   Home page (generation input)
│
├── lib/                        # Core business logic
│   ├── generation/             #   Two-stage lesson generation pipeline
│   ├── orchestration/          #   LangGraph multi-agent orchestration (director graph)
│   ├── playback/               #   Playback state machine (idle → playing → live)
│   ├── action/                 #   Action execution engine (speech, whiteboard, effects)
│   ├── ai/                     #   LLM provider abstraction
│   ├── api/                    #   Stage API facade (slide/canvas/scene manipulation)
│   ├── store/                  #   Zustand state stores
│   ├── types/                  #   Centralized TypeScript type definitions
│   ├── audio/                  #   TTS & ASR providers
│   ├── media/                  #   Image & video generation providers
│   ├── export/                 #   PPTX & HTML export
│   ├── hooks/                  #   React custom hooks (55+)
│   ├── i18n/                   #   Internationalization (zh-CN, en-US)
│   └── ...                     #   prosemirror, storage, pdf, web-search, utils
│
├── components/                 # React UI components
│   ├── slide-renderer/         #   Canvas-based slide editor & renderer
│   │   ├── Editor/Canvas/      #     Interactive editing canvas
│   │   └── components/element/ #     Element renderers (text, image, shape, table, chart …)
│   ├── scene-renderers/        #   Quiz, Interactive, PBL scene renderers
│   ├── generation/             #   Lesson generation toolbar & progress
│   ├── chat/                   #   Chat area & session management
│   ├── settings/               #   Settings panel (providers, TTS, ASR, media …)
│   ├── whiteboard/             #   SVG-based whiteboard drawing
│   ├── agent/                  #   Agent avatar, config, info bar
│   ├── ui/                     #   Base UI primitives (shadcn/ui + Radix)
│   └── ...                     #   audio, roundtable, stage, ai-elements
│
├── packages/                   # Workspace packages
│   ├── pptxgenjs/              #   Customized PowerPoint generation
│   └── mathml2omml/            #   MathML → Office Math conversion
│
├── skills/                     # OpenClaw / ClawHub skills
│   └── openmaic/               #   Guided OpenMAIC setup & generation SOP
│       ├── SKILL.md            #   Thin router with confirmation rules
│       └── references/         #   On-demand SOP sections
│
├── configs/                    # Shared constants (shapes, fonts, hotkeys, themes …)
└── public/                     # Static assets (logos, avatars)

• Generation Pipeline (lib/generation/) — Two-stage: outline generation → scene content generation
• Multi-Agent Orchestration (lib/orchestration/) — LangGraph state machine managing agent turns and discussions
• Playback Engine (lib/playback/) — State machine driving classroom playback and live interaction
• Action Engine (lib/action/) — Executes 28+ action types (speech, whiteboard draw/text/shape/chart, spotlight, laser …)

1. Fork the repository or create a branch in your own mirror
2. Create your feature branch (git checkout -b docs/your-change or fix/your-change)
3. Commit your changes (git commit -m 'docs: improve setup guide')
4. Push the branch to your remote
5. Open a pull request or merge request on the hosting platform

This fork is distributed under AGPL-3.0 only. This repository does not grant any additional proprietary or commercial license beyond what is stated in LICENSE.

If you need separate commercial terms for upstream OpenMAIC itself, contact the upstream project maintainers. For questions about this DeepWit edition, contact the current repository owner through the hosting platform.

If the upstream OpenMAIC research project is useful in your research, please consider citing:

@Article{JCST-2509-16000,
  title = {From MOOC to MAIC: Reimagine Online Teaching and Learning through LLM-driven Agents},
  journal = {Journal of Computer Science and Technology},
  volume = {},
  number = {},
  pages = {},
  year = {2026},
  issn = {1000-9000(Print) /1860-4749(Online)},
  doi = {10.1007/s11390-025-6000-0},
  url = {https://jcst.ict.ac.cn/en/article/doi/10.1007/s11390-025-6000-0},
  author = {Ji-Fan Yu and Daniel Zhang-Li and Zhe-Yuan Zhang and Yu-Cheng Wang and Hao-Xuan Li and Joy Jia Yin Lim and Zhan-Xin Hao and Shang-Qing Tu and Lu Zhang and Xu-Sheng Dai and Jian-Xiao Jiang and Shen Yang and Fei Qin and Ze-Kun Li and Xin Cong and Bin Xu and Lei Hou and Man-Li Li and Juan-Zi Li and Hui-Qin Liu and Yu Zhang and Zhi-Yuan Liu and Mao-Song Sun}
}

This project is licensed under the GNU Affero General Public License v3.0. See NOTICE and OPEN_SOURCE_COMPLIANCE.md for attribution and open source notes.