█

AI/TLDR

OpenMAIC

Turn a topic or a document into an agent-taught interactive lesson

Learning & TutoringOpen source
Latest
v1.0.2
Updated
13 Sep 2026
Language
TypeScript
License
MIT
Coverage
2 stories
$git clone https://github.com/THU-MAIC/OpenMAIC.git

What's new

v1.0.213 Sep 2026

A security release fixing three advisories: two ways past the outbound URL guard on /api/proxy-media — a late-applied cloud metadata denylist and DNS rebinding at connect time — plus a route that let any caller overwrite a classroom. Upgrading changes two defaults: POST /api/classroom ignores a client-supplied stage.id, and CGNAT addresses are blocked unless ALLOW_LOCAL_NETWORKS=true.

Latest news

Overview

OpenMAIC (Open Multi-Agent Interactive Classroom) is an open-source app from THU-MAIC, a research team at Tsinghua University, that turns a topic or an uploaded document into a lesson you can sit through. A group of agents plans the curriculum, writes the material and then delivers it: slides, quizzes, interactive HTML simulations and project-based activities, with text-to-speech narration and a whiteboard you can draw on while the lesson runs.

It is a multi-agent system rather than a single prompt-to-slides generator. Separate agents take the teacher and peer roles inside the classroom, and a Pro-mode agent workbench lets you chat with an agent that plans the curriculum and then builds and revises every page. Lessons export to PowerPoint, interactive HTML or MP4.

OpenMAIC is provider-neutral. It runs against OpenAI, Anthropic, Google and other hosted APIs through your own key, and can also point at a local model server such as Ollama or Lemonade. Persistence is pluggable, with an optional PostgreSQL backend for server-side storage, and the interface ships in twelve locales.

What it does

  • One-click lesson generation from a topic or an uploaded document
  • Multi-agent classroom with agent teachers and peer roles rather than a single generator
  • Mixed scene types — slides, quizzes, interactive HTML simulations and project-based activities
  • Text-to-speech narration plus a shared whiteboard for drawing during a lesson
  • Agent workbench (Pro mode) that plans a curriculum and revises pages through chat
  • Export to .pptx, interactive HTML or MP4
  • Bring your own key across OpenAI, Anthropic, Google and other providers, or point at a local model server
  • Twelve-locale interface and optional PostgreSQL-backed persistence

Getting started

OpenMAIC is a TypeScript app you run locally with pnpm. You supply your own model API key.

Clone and install

OpenMAIC 1.0.1 requires Node 22.19 or newer.

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

Add a model API key

Copy the example environment file and set the key for whichever provider you want the agents to call.

bashbash
cp .env.example .env.local
# then edit .env.local and add your OpenAI, Anthropic or Google key

Run the app

Start the dev server and open the classroom in a browser.

bashbash
pnpm dev
# http://localhost:3000

Pointing at a local model server

Since 1.0.1, a client-supplied base URL on a loopback or private address is rejected in development builds too, and 1.0.2 extends that to CGNAT addresses in 100.64.0.0/10 (Tailscale-style overlays). Opt back in if you are running a local Ollama or Lemonade endpoint.

bashbash
ALLOW_LOCAL_NETWORKS=true pnpm dev

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

When to use it

  • Turn a paper, a spec or a set of notes into a lesson you can actually sit through instead of skim
  • Generate slide decks and quizzes for a course and export them to PowerPoint
  • Give a self-taught learner an agent teacher plus peer agents to ask questions alongside
  • Build interactive simulations and programming exercises for a topic without hand-authoring the HTML

Version history

Every verified update to OpenMAIC that AI/TLDR tracked, newest first — each links to our coverage and the official changeset.

  1. 2026-09-13v1.0.2

    A security release fixing three advisories: two ways past the outbound URL guard on /api/proxy-media — a late-applied cloud metadata denylist and DNS rebinding at connect time — plus a route that let any caller overwrite a classroom. Upgrading changes two defaults: POST /api/classroom ignores a client-supplied stage.id, and CGNAT addresses are blocked unless ALLOW_LOCAL_NETWORKS=true.

  2. 2026-09-06v1.0.1

    A security and stability release fixing four privately reported advisories — one critical unauthenticated SSRF caused by an outbound URL guard that ran only in production builds, plus stored XSS in slide HTML, a path traversal on classroom write, and unvalidated provider redirects. Node 22.19 or newer is now required.

How OpenMAIC compares

OpenMAIC alongside other open-source learning & tutoring tools AI/TLDR tracks, ranked by GitHub stars.

ToolStarsWhat it does
DeepTutor★ 42.2kAn agent-native learning workspace from HKU's Data Intelligence Lab that runs tutoring, quizzes, research, visualisation and mastery practice over your own knowledge bases and books.
OpenMAIC★ 41.3kTurn a topic or a document into an agent-taught interactive lesson
Lathe★ 1.7kA Go CLI plus coding-agent skills that generate hands-on, multi-part technical tutorials on demand and serve them in a local reader you work through by hand.
Inno Agent★ 1.3kOpen-source personal learning agent with a learner profile, a wiki knowledge base and cross-conversation recall, plus a scheduler, Feishu/WeChat reminders and a Practice Lab terminal.