Library / SDK
THU-MAIC/OpenMAIC avatar
THU-MAIC/OpenMAIC

OpenMAIC: A one-click multi-agent classroom builder with a new agent workbench

Open Multi-Agent Interactive Classroom, Get an immersive, multi-agent learning experience in just one click.

37,070 stars5,849 forksTypeScriptMIT

At a glance

What is it?
OpenMAIC turns a topic or document into slides, quizzes, simulations, and PBL activities via multi-agent orchestration. The v1.0.0 release adds a chat-driven agent workbench for planning and revising whole courses.
Who is it for?
Adopt OpenMAIC if you need a self-hosted, provider-neutral way to generate interactive course materials from documents or prompts, especially if you want AI teachers and classmates in a classroom UI. Do not adopt it if you require a stable, mature product: the project is under active development, the documentation is thin on operational details, and the v1.0.0 agent workbench is new.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What OpenMAIC actually does

OpenMAIC is an open-source platform that converts a topic description or an uploaded document into a full interactive classroom experience. The README describes it as a multi-agent orchestration system that generates slides, quizzes, interactive simulations, and project-based learning (PBL) activities. The generated content is delivered by AI teachers and AI classmates who can speak, draw on a whiteboard, and discuss with the learner in real time. This is not a simple slide generator. The target user is an educator, trainer, or content creator who wants to produce engaging, interactive lessons without manually assembling each component. The project is built in TypeScript and is licensed under MIT. The v1.0.0 release, dated August 27, 2026, introduces a Pro workbench that adds a chat-driven agent for planning and revising courses, which is a significant shift from the earlier one-click generator.

The multi-agent mechanism and the agent workbench

The core mechanism is multi-agent orchestration. The README does not detail the internal agent communication, but the visible behavior is that a single prompt or document triggers a pipeline that produces multiple content types. In v1.0.0, the agent workbench is a chat-first workspace. You can plan a curriculum, build every page, and revise it through conversation. Sessions are durable and server-backed, meaning they survive restarts. You can cancel, resume, and steer the generation at any time. The agent can work from uploaded materials: documents, audio, and video, or from web search results. The system includes 20 built-in skills, which cover slides, quizzes, interactives, PBL, images, video, voices, and.pptx import. The design is provider-neutral: you can bring your own models, media, search providers, and storage backend. This suggests a modular architecture where each skill is a pluggable unit, though the exact interfaces are not documented in the README.

Getting it running: one-click deploy and configuration

The README provides a Vercel deployment link that clones the repository and asks you to configure at least one LLM provider API key, such as OPENAI_API_KEY or ANTHROPIC_API_KEY. All providers are optional, but you need at least one for generation. The .env.example file is referenced as the configuration reference. The quick start section is not fully visible in the truncated README, but the deployment path is clear: you clone the repo, set environment variables, and deploy. For local development, the project uses a Next.js framework, as indicated by the Vercel deployment link. There is also a mention of a Postgres reference server for server-backed persistence, introduced in v0.3.1 and completed in v0.3.2. The README mentions a one-command Postgres stack, but the exact command is not provided in the visible text. You should check the .env.example and the changelog for the precise setup steps.

The provider landscape and built-in integrations

OpenMAIC supports a wide range of LLM providers, search providers, and speech services. The changelog lists OpenAI, Anthropic, Azure OpenAI, Amazon Bedrock, Atlas Cloud, Claude search, SearXNG, Brave, Baidu, Bocha, MiniMax, and more. For speech, it integrates FunASR for speech recognition and VoxCPM2 for text-to-speech with voice cloning. The README also mentions Ollama support for local models, which was added in v0.1.1. This provider neutrality is a strong point: you are not locked into a single vendor. However, the sheer number of integrations also means more configuration surface. The README notes that all providers are optional, but the practical reality is that you need at least one LLM provider for generation. The project also mentions OpenClaw integration, which lets you generate classrooms from messaging apps like Feishu, Slack, or Telegram. That is a different entry point than the web UI.

Durability and persistence: server-backed sessions

Before v0.3.1, the system likely relied on local storage. The v0.3.1 release introduced server-backed runtime storage with a Postgres reference server. By v0.3.2, server-backed persistence was completed, with a full document cutover and incremental saves. This is a major architectural change. The v1.0.0 release builds on this by making sessions durable: they survive restarts, and you can cancel and resume them. This is important for long course-building sessions, which could take minutes or more. The downside is that you now need to run a Postgres instance, which adds operational overhead. The README mentions a one-command Postgres stack, but the exact command is not shown. If you are deploying on Vercel, you will need a managed Postgres service. The persistence layer is also pluggable, so you could use a different backend, but the reference implementation is Postgres.

Limitations and failure modes

The most obvious limitation is that the project is young. The first release was in March 2026, and v1.0.0 is only five months later. The changelog shows rapid iteration, which means breaking changes are likely. The relicensing from AGPL-3.0 to MIT in v0.3.0 is a positive sign for adopters, but it also indicates that the licensing terms changed mid-stream. Another limitation is the lack of detailed documentation in the README. The README is heavy on feature lists and light on architecture diagrams, API references, or troubleshooting guides. The agent workbench is new, and its reliability is unproven. The README mentions SSRF hardening in v0.3.1, which suggests that the system fetches external URLs, and that can be a security risk if misconfigured. If you are using web search as a material source, you need to be careful about what URLs the agent can access. The system also generates interactive HTML simulations, which could introduce XSS risks if not properly sanitized, though the README does not mention this.

Alternatives and how they differ

The most direct alternative is a general-purpose course authoring tool like Articulate Rise or Adobe Captivate, but those do not use AI generation. A closer alternative is an AI-powered slide generator like Gamma or Tome, which can create presentations from a prompt. However, those tools focus on slides, not on multi-agent classrooms with quizzes, simulations, and PBL. Another alternative is to use a generic LLM orchestration framework like LangChain or LlamaIndex to build a custom course generator. That gives you full control but requires significant development effort. The key difference with OpenMAIC is that it provides a ready-made classroom UI with AI teachers and classmates, which is a unique feature. No other open-source project here offers this combination. If you only need slides, a simpler tool would be lighter. If you need the full interactive classroom, OpenMAIC is the only option presented.

Maintenance and upgrade cost

The project is actively maintained, with releases roughly every two to four weeks. This is a double-edged sword: you get new features and fixes, but you also need to keep up with changes. The v0.3.2 release notes mention video export hardening, which suggests that earlier versions had bugs in that area. The upgrade path from v0.3.x to v1.0.0 is not documented in the README, but the introduction of the agent workbench and server-backed sessions likely requires database migrations. The project is licensed under MIT, which means you can use it commercially without paying royalties, but you must include the original copyright notice. There are no contributor guidelines or code of conduct mentioned in the README, but the project has a Discord server and a Feishu community. For an engineer, the main maintenance cost is staying on top of the rapid release cycle and testing your custom integrations against each new version.

Editorial conclusion

Adopt OpenMAIC if you need a self-hosted, provider-neutral way to generate interactive course materials from documents or prompts, especially if you want AI teachers and classmates in a classroom UI. Do not adopt it if you require a stable, mature product: the project is under active development, the documentation is thin on operational details, and the v1.0.0 agent workbench is new. Before committing, verify the exact LLM provider configuration, the Postgres persistence requirements, and whether the 20 built-in skills cover your content types. Also check the MIT license terms and the current changelog for breaking changes. The project's value lies in its breadth, not its polish.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Community notes

Community notes