Or configure Amazon Bedrock with AWS credentials and BEDROCK_REGION.

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

English | Simplified Chinese
Live Demo · Quick Start · Lemonade · FunASR · Features · Use Cases · OpenClaw

🎉 OpenMAIC v1.0.0 — Build courses with an agent

One prompt in, a whole course out — and now you can steer. Released August 27, 2026, OpenMAIC v1.0.0 adds a Pro workbench alongside the classic one-click generator: chat with an agent that plans your curriculum, builds and revises every page, and works straight from your materials.

• 🤖 Agent workbench — a chat-first workspace that plans, builds, and revises whole courses
• 💾 Durable sessions — server-backed runs survive restarts; cancel, resume, and steer anytime
• 📎 Session materials — upload documents, audio, and video, or pull from web search; the agent builds from them
• 🧰 Course tools + 20 built-in skills — slides, quizzes, interactives, PBL, images, video, voices, .pptx import
• 🔌 Neutral by design — bring your own models, media, search providers, and storage backend

Take the full tour in Features, then set it up with Agent workbench and runtime.

🗞️ News

• 2026-08-27 — OpenMAIC v1.0.0: an agent workbench, durable course-building sessions, reusable skills, session materials, provider-neutral server capabilities, and a pluggable persistence stack.
• 2026-08-14 — v0.3.2 released! Video export hardening (deterministic Quiz/PBL covers, fidelity polish, interactive HTML capture, CPU resource profiles); server-backed persistence completed (full document cutover, one-command Postgres stack, incremental saves) plus the asset registry; the @openmaic/generation package; four new locales; Amazon Bedrock, Atlas Cloud, and Claude search providers; FunASR ASR. See changelog.
• 2026-07-21 — v0.3.1 released! One-click MP4 video export; server-backed runtime storage with a Postgres reference server; direct slide manipulation in the editor (drag, resize, rotate, multi-select); smarter "Edit with AI" (validated JSON Patch edits, multi-session history); expanded Document Parsing (multi-format upload, audio/video extraction, AliDocMind, MinerU); new providers (Azure OpenAI, SearXNG, ComfyUI) and the GPT-5.6 model family; action-level playback navigation; SSRF hardening. See changelog.
• 2026-06-28 — v0.3.0 released! Project-Based Learning (PBL) v2 with classroom UI; "Edit with AI" Pro-mode editor agent; the @openmaic/* SDK family (DSL/renderer/importer) published to npm; optional per-stage model routing; new models (GLM-5.2, Kimi K2.7 Code, Qwen3.7 Plus/Max); a vocational-learning task engine; Korean (ko-KR) locale; and relicensing from AGPL-3.0 to MIT. See changelog.
• 2026-06-02 — v0.2.2 released! MAIC Editor (v0) Pro Mode for editing generated slides; editable outline before generation; offline-ready classroom export; new search providers (Brave/Baidu/Bocha/MiniMax) and Azure STT; new models (Claude Opus 4.8, MiniMax M3, Gemini 3.5 Flash); Traditional Chinese (zh-TW) and Brazilian Portuguese (pt-BR) locales. See changelog.
• 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.

📖 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. 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

Highlights

• 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

🚀 Quick Start

Prerequisites

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

1. Clone & Install

git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install

2. Configure

cp .env.example .env.local

Fill in at least one LLM provider key:

OPENAI_API_KEY=sk-...
AZURE_OPENAI_API_KEY=...
AZURE_OPENAI_BASE_URL=https://YOUR-RESOURCE.openai.azure.com/openai
AZURE_OPENAI_MODELS=YOUR-DEPLOYMENT-NAME
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
GROK_API_KEY=xai-...
OPENROUTER_API_KEY=sk-or-...
TENCENT_API_KEY=sk-...
XIAOMI_API_KEY=...
# Or configure Amazon Bedrock with AWS credentials and BEDROCK_REGION.

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

providers:
  openai:
    apiKey: sk-...
  azure:
    apiKey: ...
    baseUrl: https://YOUR-RESOURCE.openai.azure.com/openai
    models:
      - YOUR-DEPLOYMENT-NAME
  anthropic:
    apiKey: sk-ant-...
  bedrock:
    models:
      - us.anthropic.claude-sonnet-5
      - us.anthropic.claude-opus-4-8

Supported providers: OpenAI, Azure OpenAI, Anthropic, Amazon Bedrock, Google Gemini, DeepSeek, Qwen, Kimi, MiniMax, Grok (xAI), OpenRouter, Doubao, Tencent Hunyuan/TokenHub, Xiaomi MiMo, GLM (Zhipu), Ollama (local), Lemonade (local LLM / image / TTS / ASR), FunASR (local ASR), and any OpenAI-compatible API.

Amazon Bedrock quick example:

BEDROCK_REGION=us-east-1
BEDROCK_MODELS=us.anthropic.claude-sonnet-5,us.anthropic.claude-opus-4-8
DEFAULT_MODEL=bedrock:us.anthropic.claude-sonnet-5

Bedrock uses AWS environment credentials or the AWS SDK credential provider chain. For temporary credentials, set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_SESSION_TOKEN, or use an AWS profile / role available to the runtime.

Optional: Lemonade (Local AI Provider)

OpenMAIC supports Lemonade as a local, OpenAI-compatible provider for LLMs, image generation, TTS, and ASR. No API key is required.

Run Lemonade locally, then point OpenMAIC to it:

LEMONADE_BASE_URL=http://localhost:13305/v1
TTS_LEMONADE_BASE_URL=http://localhost:13305/v1
ASR_LEMONADE_BASE_URL=http://localhost:13305/v1
IMAGE_LEMONADE_BASE_URL=http://localhost:13305/v1

Optional: FunASR (Local Speech Recognition)

OpenMAIC can transcribe locally through FunASR's OpenAI-compatible server. The built-in provider supports SenseVoiceSmall, Paraformer, and Fun-ASR-Nano and requires no API key.

python -m pip install torch torchaudio
python -m pip install "funasr==1.4.0" fastapi uvicorn python-multipart
# Add vLLM for Fun-ASR-Nano on NVIDIA GPUs
python -m pip install vllm
funasr-server --device cuda --model fun-asr-nano

Point OpenMAIC at the server:

ASR_FUNASR_BASE_URL=http://localhost:8000/v1

Use funasr-server --device cpu --model sensevoice for a CPU-only setup. See the FunASR deployment guide for production options.

Optional: Local Audio and Video Extraction

OpenMAIC can extract timestamped transcripts and prepared video keyframes locally. Install the system ffmpeg package so both ffmpeg and ffprobe are executable on PATH, then configure one server ASR provider (for example FunASR, Lemonade, or OpenAI) using the variables above. The application resolves the executables at extraction time; ffmpeg is not an npm dependency and is not required to start or use OpenMAIC.

If the executables are unavailable, the local extractor is skipped. A configured AliDocMind provider remains available as the cloud extraction path. When neither local ffmpeg extraction nor AliDocMind is available, audio/video materials are marked failed with an actionable setup message instead of hanging or completing with an empty transcript.

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

Xiaomi MiMo Token Plan quick example:

MIMO_API_KEY=tp-...
MIMO_BASE_URL=https://token-plan-cn.xiaomimimo.com/v1
DEFAULT_MODEL=xiaomi:mimo-v2.5-pro

Use https://token-plan-sgp.xiaomimimo.com/v1 or https://token-plan-ams.xiaomimimo.com/v1 for the Singapore or Europe Token Plan clusters.

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.

3. Run

pnpm dev

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

4. Build for Production

pnpm build && pnpm start

Optional: ACCESS_CODE (Shared Deployments)

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.

Vercel Deployment

Or manually:

1. Fork this repository
2. Import into Vercel
3. Set environment variables (at minimum one LLM API key)
4. Deploy

Docker Deployment

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

Slow-network / China build acceleration

Docker builds support two optional build arguments. Both are empty by default, so the standard command above keeps using the upstream Alpine and npm registries.

• ALPINE_MIRROR is an Alpine mirror hostname without https://.
• NPM_REGISTRY is a complete npm registry URL.

Use public mirror endpoints only. Do not embed usernames, passwords, or access tokens in these build arguments because Docker may record them in image metadata or build provenance.

With Docker Compose:

ALPINE_MIRROR=mirrors.tuna.tsinghua.edu.cn \
NPM_REGISTRY=https://registry.npmmirror.com \
docker compose up --build

For a direct image build:

docker build \
  --build-arg ALPINE_MIRROR=mirrors.tuna.tsinghua.edu.cn \
  --build-arg NPM_REGISTRY=https://registry.npmmirror.com \
  -t openmaic:local .

These arguments do not accelerate Docker Hub pulls, including the Dockerfile frontend and the node:22-alpine base image. Configure a Docker daemon registry mirror separately if those pulls are slow. The pnpm store cache is reused by the same BuildKit builder across builds, subject to normal cache garbage collection; the cache only improves performance and is not required for a correct build.

Server-backed persistence (PostgreSQL)

The server-persistence profile runs exactly two containers: the OpenMAIC app and PostgreSQL. The persistence HTTP server is embedded in the app at /api/persistence; there is no standalone persistence service.

cp .env.example .env.local
printf '\nDATABASE_URL=postgres://openmaic:openmaic-dev@postgres:5432/openmaic\nPERSISTENCE_DEV_TOKEN=openmaic-local-dev\n' >> .env.local
NEXT_PUBLIC_PERSISTENCE=1 NEXT_PUBLIC_PERSISTENCE_TOKEN=openmaic-local-dev docker compose --profile server-persistence up --build

Add your provider API keys to .env.local as usual. Runtime sessions and course documents become server-backed; device-scoped KV data (including the anonymous device learner key and playback position) remains in the browser. Existing browser course data is copied into the configured server store lazily, one course at a time when it is first accessed, using the same verified migration path as browser persistence.

NEXT_PUBLIC_PERSISTENCE is a build-time switch compiled into the browser bundle. A build with it enabled must be deployed with a working runtime DATABASE_URL and PERSISTENCE_DEV_TOKEN, while NEXT_PUBLIC_PERSISTENCE_TOKEN must match that server token at build time. Otherwise the browser selects HTTP persistence but the embedded endpoint returns configuration/authentication/initialization errors; the home page shows a persistence-unavailable toast and keeps the prior course list instead of misleadingly displaying an empty library.

PERSISTENCE_DEV_TOKEN and NEXT_PUBLIC_PERSISTENCE_TOKEN are not a secret in any meaningful sense: the NEXT_PUBLIC_ token is compiled into the public JavaScript bundle, fully visible to every visitor, and therefore provides no confidentiality and no user isolation whatsoever — anyone who can load the page can extract it and read or write every learner partition and all documents by choosing an x-learner-key. Its only purpose is to keep unrelated network scanners out of an endpoint on a trusted network. This is suitable only for localhost or trusted-network, single-user deployments. Before production, replace lib/persistence/server-auth.ts with real session verification that derives the learner partition from server-controlled identity, and change the document/merge/admin authorization policies as appropriate.

PERSISTENCE_POSTGRES_PASSWORD initializes the PostgreSQL role only when the data directory is empty; changing it later does not rotate an existing openmaic-postgres volume. For a disposable local database, run docker compose --profile server-persistence down -v, set the new password and matching DATABASE_URL, then start the profile again. To preserve data, connect as an administrator and run ALTER ROLE openmaic WITH PASSWORD 'new-password';, then update DATABASE_URL.

Compose cannot attach depends_on to openmaic only when this optional profile is active without also affecting the default deployment. Startup therefore relies on the embedded route's retry-on-next-request behavior while PostgreSQL becomes healthy.

Deleting or replacing an asset only drops its registry entry; the bytes behind it are reclaimed afterwards by an offline collector. This deployment runs that collector by default, so nothing has to be configured for asset storage to stop growing. A pass runs every ASSET_COLLECTION_INTERVAL_MS (default 15 minutes) over bytes that have been unreferenced for longer than ASSET_COLLECTION_GRACE_MS (default 1 hour); the grace period is the retention window a user's deleted bytes actually get, so raise it deliberately. Set ASSET_COLLECTION_ENABLED=0 to switch collection off in a process. A horizontally scaled deployment may leave it on in every instance — each blob row is locked and re-checked before its bytes go, so concurrent collectors serialize rather than race — or disable it everywhere and run its own.

Asset byte egress is direct by default: the embedded route materializes the bytes in the response body. Setting ASSET_BYTE_EGRESS=redirect opts into indirect egress, under which a byte GET answers with a short-lived signed S3 URL when the byte layer can sign (S3 can; the PostgreSQL byte column cannot and falls back to direct bytes). Two object-store prerequisites make that safe: the bucket must allow this app's origin via CORS and expose Content-Type on the signed response, and the signing identity must hold s3:ListBucket on the bucket so a missing key answers 404 NoSuchKey rather than 403 — a client can only read a reclaimed asset as a miss when the store confirms it by code. The tradeoffs this opts into are specified in the asset HTTP contract.

The embedded endpoint implements the package's RuntimeStore HTTP contract and DocumentStore HTTP contract. Leave NEXT_PUBLIC_PERSISTENCE unset to retain the existing browser-only behavior.

Optional: Agent workbench and runtime

The Pro workbench is a usable course-building surface entered from the home page. Its collapsible navigation rail, conversation pane, and tabbed classroom pane share /api/agent/* control-plane routes and an in-process session runner. It is off by default. Enable its build-time entry point and the server runtime with the same PostgreSQL connection used by server-backed persistence:

NEXT_PUBLIC_PRO_WORKBENCH_ENABLED=true
OPENMAIC_AGENT_RUNTIME_ENABLED=true
DATABASE_URL=postgres://openmaic:openmaic-dev@postgres:5432/openmaic
MODEL_ROUTES='{"maic-agent-driver":{"model":"openai:gpt-5.5","api":"openai-completions"}}'

While the flag is off, the /api/agent/sessions* and /api/agent/owner-events routes answer 404. Enabling it without a DATABASE_URL never starts the runner and makes the session routes error, so the runtime is server-backed by design. MODEL_ROUTES must explicitly route maic-agent-driver to a provider-prefixed model with an openai-completions or openai-responses api/dialect; there is intentionally no fallback.

To make the browser use the same server-backed document and runtime stores, also build with NEXT_PUBLIC_PERSISTENCE=1 and configure the matching development tokens described in Server-backed persistence. Without these opt-ins, OpenMAIC retains its existing browser-only behavior. Runner cadence (scan interval, heartbeat, lease TTL, concurrency, attempts) and the reserved compaction knobs are listed in .env.example.

Optional: MP4 Video Export (Render Service)

The "Export Video" menu builds a self-contained Hyperframes project entirely in the browser. Turning that into an MP4 needs Chromium + FFmpeg on Node 22, so it runs in an isolated render-service container rather than the app.

It's opt-in. Start it with the video-export compose profile:

docker compose --profile video-export up --build

The app auto-detects the service via RENDER_SERVICE_URL (preset in docker-compose.yml) and enables one-click MP4 rendering. Without the profile — or when RENDER_SERVICE_URL is unset — export degrades to downloading the project ZIP for local CLI rendering. See render-service/README.md for standalone setup and tuning (RENDER_MAX_CONCURRENCY, etc.).

Optional: MinerU (Advanced Document Parsing)

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.

Optional: VoxCPM2 (Self-Hosted TTS with Voice Cloning)

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.

✨ Features

Agent Workbench and Pro Mode (v1.0.0)

The workbench adds a conversational course-building agent to OpenMAIC. Its durable sessions can be resumed after a worker restart, accept follow-up instructions while running, and stream a replayable event history to the chat surface.

Open it from the Pro control on the home page. The workspace combines a transient, collapsible folders/conversations rail with a chat pane and a classroom pane whose open courses stay in tabs. Workspace controls return to classic mode, and either entry remains gated by the public workbench flag plus the configured server runtime.

The agent works through explicit, validated tools rather than editing opaque blobs:

Twenty built-in skills cover curriculum planning, deep research, interactive, lecture, workshop, vocational, and other teaching styles, slide/stage craft, PPTX import, editing, and style reuse. User-authored skills are stored per owner and can be created, read, and patched through the same runtime.

The server-backed workbench also exposes owner-scoped folder routes and a per-viewer stage metadata sidecar for ownership, publication, and generation-complete state. A stage ID acts as the capability for reading a non-deleted course, but stage mutations remain restricted to its owner. The material upload contract stores supported source bytes before lease-fenced document or media extraction records derived text and images; media extraction can select AliDocMind or the optional local ffmpeg/ffprobe provider.

Under the hood, agent sessions are database-backed with leases, heartbeats, crash resume, cancellation, and follow-up steering, and database-maintained revision counters keep per-stage and per-scene freshness monotonic so the workbench refetches only the scenes that changed. Server routes resolve LLM, media, ASR/TTS, and search configuration provider-neutrally: credentials never reach the browser, uniform <CAP>_<PREFIX>_ENABLED=false switches can force off any served capability, startup validation warns about bad model configuration, and unresolved model routes fail loudly instead of guessing a vendor.

Pluggable Storage

OpenMAIC runs without a database by default: course documents, learner runtime records, device/account KV values, and assets use browser storage. The @openmaic/storage package defines swappable stores for those primitives and adds PostgreSQL-backed documents, learner runtime, assets, durable agent sessions, session materials, and user skills. HTTP clients connect the browser to the embedded persistence endpoint, while the server asset layer can keep bytes in PostgreSQL or S3.

Deep Interactive Mode (New!)

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.

Five Types of Interactive UI

🌐 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.

AI Teacher Guidance

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.

Available on Any Device

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

Desktop	Mobile
iPad

Need a More Complete and Professional UI Generation Experience?

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.

Lesson Generation

Describe what you want to learn or attach reference materials. PDF, Word, PowerPoint, spreadsheet, text, image, audio, and video inputs can enter the material pipeline; configured extractors turn supported sources into content for generation. OpenMAIC's classic two-stage pipeline handles the rest:

Classroom Components

🎓 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.

Multi-Agent Interaction

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.

OpenClaw Integration

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"
        }
      }
    }
  }
}

Export

Offline / intranet classrooms: When you export a classroom (.maic.zip) or a Resource Pack, OpenMAIC inlines the external assets referenced by interactive scenes (KaTeX, Three.js incl. three/addons, Tailwind CDN, Google Fonts, images) into the exported HTML as data: URIs. The exported course then plays fully offline after import into an air-gapped/intranet instance — no public CDN is contacted at playback time. Assets that can't be fetched at export time (e.g. CORS-restricted image hosts) are reported and left as URLs. Classrooms exported before this feature still reference CDNs and must be re-exported to gain offline support.

And More

• 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
• Provider controls — Server-side capability discovery, model resolution, force-off switches, and fail-loud routing keep deployments explicit
• Course freshness — Database-triggered per-scene revision counters, freshness events, and targeted scene fetches keep workbench views synchronized
• i18n — Interface supports 12 locales across 11 languages: Simplified Chinese, Traditional Chinese, English, Japanese, Korean, Russian, Arabic, Portuguese (Brazil), Spanish (Mexico), French, Vietnamese, and German
• Dark Mode — Easy on the eyes for late-night study sessions

💡 Use Cases

"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"

🤝 Contributing

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

Project Structure

OpenMAIC/
├── app/                        # Next.js App Router
│   ├── api/                    #   Generation, media, persistence, and agent APIs
│   │   ├── agent/              #     Durable session, event, material, and skill control plane
│   │   ├── stages/             #     Owner-scoped course reads, writes, manifests, and scene fetches
│   │   ├── 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
│   ├── persistence/            #   Browser/server persistence wiring and PostgreSQL provider
│   ├── server/agent-runtime/   #   Durable runner, skills, materials, and course-building tools
│   ├── export/                 #   PPTX & HTML export
│   ├── hooks/                  #   React custom hooks (55+)
│   ├── i18n/                   #   Internationalization (zh-CN, zh-TW, en-US, ja-JP, ko-KR, ru-RU, ar-SA, pt-BR, es-MX, fr-FR, vi-VN, de-DE)
│   └── ...                     #   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
│   ├── workbench/              #   Pro workbench conversation and course-reference UI
│   ├── 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
│   ├── @openmaic/dsl/          #   Versioned course/slide data contract and validators
│   ├── @openmaic/renderer/     #   React renderer for the slide DSL
│   ├── @openmaic/editor/       #   Composable slide editing core and React surface
│   ├── @openmaic/importer/     #   PPTX → OpenMAIC slide importer
│   ├── @openmaic/generation/   #   Generation contracts, pipeline, and prompt assets
│   ├── @openmaic/storage/      #   Browser, HTTP, PostgreSQL, and S3 persistence primitives
│   ├── 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)

Key Architecture

• Generation Pipeline (@openmaic/generation) — Two-stage: outline generation → scene content generation
• Agent Runtime (lib/server/agent-runtime/) — PostgreSQL-backed sessions with leased execution, resume/steer semantics, skills, materials, and validated course tools
• Persistence Layer (@openmaic/storage) — Swappable document, runtime, KV, asset, agent-session, material, and user-skill stores
• 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 …)

How to Contribute

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

💼 Partnerships

This project is licensed under the MIT License, so commercial use is permitted free of charge. For partnership or collaboration inquiries, please contact: thu_maic@mail.tsinghua.edu.cn

📝 Citation

If you find OpenMAIC 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}
}

⭐ Star History

📄 License

This project is licensed under the MIT License.

Third-Party Components

The repository bundles workspace packages that are not covered by the root MIT license and keep their own terms:

• packages/mathml2omml — LGPL-3.0-or-later
• packages/pptxgenjs — MIT (third-party)

When redistributing the repository as a whole, the terms of each bundled package above apply to that package's files.