The official repository: github.com/THU-MAIC/OpenMAIC. This site, OpenMAIC.pro, is an independent service and is not part of that repository.
The repository at a glance
| Owner | THU-MAIC, the MAIC team at Tsinghua University |
|---|---|
| License | MIT (relicensed from AGPL-3.0 in v0.3.0, June 28, 2026) |
| Language | TypeScript |
| Stack | Next.js 16, React 19, LangGraph 1.1, Tailwind CSS 4, PostgreSQL 16 |
| Popularity | More than 39,000 stars and 6,000 forks |
| Created | March 11, 2026 |
| Latest release | v1.1.2, September 28, 2026 (a security release) |
| Live demo | open.maic.chat |
Because the name is popular, searches also surface forks and look-alike repositories. Check that the owner is THU-MAIC before you clone or run anything.
License: MIT, with two notes
OpenMAIC started under AGPL-3.0 and moved to the MIT License with v0.3.0. Older articles still call it AGPL; the LICENSE file in the repository is the authority. The README states that commercial use is permitted free of charge.
- The root MIT license does not cover every bundled package.
packages/mathml2ommlis LGPL-3.0-or-later, andpackages/pptxgenjsis third-party MIT code. - The license covers the software. The models you connect, and the content they generate, fall under your model provider’s terms.
What is inside
The README’s architecture notes describe these main parts:
| Part | What it does |
|---|---|
| Generation pipeline | The @openmaic/generation package: outline generation, then scene content generation. |
| Multi-agent orchestration | A LangGraph state machine in lib/orchestration/ that manages agent turns and discussions. |
| Playback engine | A state machine in lib/playback/ that drives classroom playback and live interaction. |
| Action engine | lib/action/ executes 21 action types: speech, whiteboard drawing, text, shapes and charts, spotlight, laser pointer and more. |
| Agent runtime | PostgreSQL-backed sessions for the v1.0.0 agent workbench, with resume and steering, skills, materials and validated course tools. |
| Storage | The @openmaic/storage package: swappable stores for documents, learner runtime, assets, sessions and materials. |
The @openmaic/* SDK family is published to npm, so you can build your own application on the generation, rendering and storage packages rather than forking the whole app.
The OpenMAIC Skill
The skills/openmaic/ folder holds a standard SKILL.md package. It works with OpenClaw and with other agent workbenches such as Codex, DeepSeek and WorkBuddy. With OpenClaw you can generate a classroom from Feishu, Slack, Discord or Telegram without opening a terminal. On OpenClaw it installs from ClawHub:
clawhub install openmaicIn other workbenches, import the skills/openmaic/ folder from the repository. The skill then offers two modes: a hosted mode that uses an access code from the official demo (see Open MAIC Chat explained), and a self-hosted mode that walks you through clone, configuration and start-up, asking for confirmation at each step.
Release history
| Version | Date | Headline changes |
|---|---|---|
| v0.1.0 | Mar 26, 2026 | Discussion text-to-speech, immersive mode, keyboard shortcuts, whiteboard enhancements. |
| v0.1.1 | Apr 14, 2026 | Automatic language inference, ACCESS_CODE authentication, classroom ZIP export and import, Ollama support. |
| v0.2.0 | Apr 20, 2026 | Deep Interactive Mode: 3D visualisation, simulations, games, mind maps, online programming. |
| v0.2.2 | Jun 2, 2026 | MAIC Editor Pro Mode, an editable outline before generation, offline-ready classroom export. |
| v0.3.0 | Jun 28, 2026 | Project-based learning v2, “Edit with AI”, the @openmaic/* SDK on npm, MIT relicense. |
| v0.3.1 | Jul 21, 2026 | One-click MP4 video export, server-backed storage, direct slide manipulation, wider document parsing. |
| v1.0.0 | Aug 27, 2026 | Agent workbench, durable course-building sessions, 24 built-in skills, session materials. |
| v1.1.0 | Sep 24, 2026 | Classroom chat on an agent loop. |
| v1.1.2 | Sep 28, 2026 | Security release. |
Several releases since v1.0.0 are security fixes. If you run your own copy, follow the releases page and read each release’s breaking-changes notes before upgrading.
Getting started from the repository
The README’s quick start needs Node.js 22.19 or newer, pnpm 10 or newer and PostgreSQL 16:
git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm installFrom there you copy the example configuration, add a model API key and start the database and the app. The full sequence, plus the Docker Compose route, is in our OpenMAIC Docker setup guide.
To contribute, the README asks for the usual flow: fork, create a feature branch, commit, push and open a pull request.
Not planning to run code?
The repository is the right place if you want to study, modify or self-host the system. If you only want a lesson, you do not need it: the official demo and the classroom builder on this site both work in a browser. What is OpenMAIC? compares the three routes.
Frequently asked questions
What is the official OpenMAIC GitHub repository?
The official repository is github.com/THU-MAIC/OpenMAIC, published by the THU-MAIC organisation. Copies under other owners are forks or unrelated projects.
What license does OpenMAIC use?
The repository is licensed under the MIT License. It was relicensed from AGPL-3.0 to MIT in v0.3.0 on June 28, 2026. One bundled package, packages/mathml2omml, keeps its own LGPL-3.0-or-later license.
Can I use OpenMAIC commercially?
The README states that the project is MIT-licensed, so commercial use is permitted free of charge. Read the LICENSE file and the third-party component notes in the repository before you redistribute it.
What is the OpenMAIC Skill?
The OpenMAIC Skill is a SKILL.md-format package in the repository’s skills/openmaic folder. It lets agent workbenches such as OpenClaw, Codex, DeepSeek and WorkBuddy set up OpenMAIC and generate classrooms, either against the hosted demo with an access code or against a self-hosted copy.
What is OpenMAIC built with?
The repository is written in TypeScript and uses Next.js 16, React 19, LangGraph 1.1 and Tailwind CSS 4, with PostgreSQL 16 for server-side storage.
Is OpenMAIC.pro part of the GitHub project?
No. OpenMAIC.pro is an independent hosted service inspired by the project. It is not maintained by THU-MAIC and its code is not the upstream repository.