Openmaic Classroom
Clone, configure, and deploy OpenMAIC to turn documents or topics into multi-agent interactive lessons with slides, quizzes, and simulations.
Overview
openmaic-classroom is an agent skill for the Build phase that sets up and extends OpenMAIC—a LangGraph-powered Next.js platform for multi-agent interactive lessons from documents or topics.
Install
npx skills add https://github.com/aradotso/trending-skills --skill openmaic-classroomWhat is this skill?
- Next.js 16 App Router, React 19, TypeScript 5, Tailwind CSS 4, LangGraph 1.1 agent pipeline
- Generates slides, quizzes, HTML simulations, and project activities with AI teachers and classmates (TTS, whiteboard)
- pnpm install flow, .env.local from .env.example, Node.js ≥20
- Deploy path includes Vercel; triggers cover OpenClaw integration and quiz/simulation scenes
- Document-to-lesson pipeline for immersive classroom experiences
- Stack table lists Next.js 16, React 19, LangGraph 1.1, TypeScript 5, pnpm >= 10, Node.js >= 20
Adoption & trust: 1.3k installs on skills.sh; 31 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want immersive AI classroom experiences with slides, quizzes, and simulations but lack a documented path to install, configure LLMs, and deploy OpenMAIC.
Who is it for?
Indie builders shipping EdTech demos, internal training tools, or agent-forward learning products on OpenMAIC’s documented stack.
Skip if: Teams that only need static course PDFs with no multi-agent runtime or LangGraph maintenance.
When should I use this skill?
set up OpenMAIC classroom; create multi-agent interactive classroom; generate AI lesson with OpenMAIC; configure OpenMAIC with LLM providers; deploy OpenMAIC to Vercel; build interactive classroom from documents; integra
What do I get? / Deliverables
You get a local or Vercel-deployed OpenMAIC instance with providers configured and guidance to add quiz, simulation, and integration scenes.
- Running OpenMAIC dev or Vercel deployment
- Configured .env.local for providers
- Lesson flows with slides, quizzes, or simulation scenes
Recommended Skills
Journey fit
OpenMAIC is a full-stack interactive classroom you assemble and wire to LLM providers—primary work is building the agent-powered learning product. LangGraph multi-agent orchestration, scene types, and provider configuration are core agent-tooling concerns on the build shelf.
How it compares
Full-stack classroom platform skill—not a single-prompt lesson writer or generic LMS plugin.
Common Questions / FAQ
Who is openmaic-classroom for?
Developers and solo founders building AI-powered interactive classrooms who will run Node 20+, pnpm 10+, and configure LLM API keys.
When should I use openmaic-classroom?
Use it when triggers match: set up OpenMAIC, create a multi-agent classroom, generate AI lessons, configure LLM providers, deploy to Vercel, build from documents, integrate with OpenClaw, or add quiz/simulation scenes.
Is openmaic-classroom safe to install?
Following the skill implies cloning a public repo and setting API secrets in .env.local; check Prism Security Audits for this listing and rotate keys you use in production.
SKILL.md
READMESKILL.md - Openmaic Classroom
# OpenMAIC — Multi-Agent Interactive Classroom > Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection. OpenMAIC (Open Multi-Agent Interactive Classroom) is a Next.js 16 / React 19 / TypeScript platform that converts any topic or document into a full interactive lesson. A multi-agent pipeline (LangGraph 1.1) generates slides, quizzes, HTML simulations, and project-based learning activities delivered by AI teachers and AI classmates with voice (TTS) and whiteboard support. --- ## Project Stack | Layer | Technology | |---|---| | Framework | Next.js 16 (App Router) | | UI | React 19, Tailwind CSS 4 | | Agent orchestration | LangGraph 1.1 | | Language | TypeScript 5 | | Package manager | pnpm >= 10 | | Runtime | Node.js >= 20 | --- ## Installation ```bash git clone https://github.com/THU-MAIC/OpenMAIC.git cd OpenMAIC pnpm install ``` ### Environment Configuration ```bash cp .env.example .env.local ``` Edit `.env.local` — at minimum one LLM provider key is required: ```env # LLM Providers (configure at least one) OPENAI_API_KEY=$OPENAI_API_KEY ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY GOOGLE_API_KEY=$GOOGLE_API_KEY # Recommended default model (Gemini 3 Flash = best speed/quality balance) DEFAULT_MODEL=google:gemini-3-flash-preview # Optional: MinerU for advanced PDF/table/formula parsing PDF_MINERU_BASE_URL=https://mineru.net PDF_MINERU_API_KEY=$MINERU_API_KEY # Optional: access code for hosted mode ACCESS_CODE=$OPENMAIC_ACCESS_CODE ``` ### Provider Config via YAML (alternative to env vars) Create `server-providers.yml` in the project root: ```yaml providers: openai: apiKey: $OPENAI_API_KEY anthropic: apiKey: $ANTHROPIC_API_KEY google: apiKey: $GOOGLE_API_KEY deepseek: apiKey: $DEEPSEEK_API_KEY # Any OpenAI-compatible endpoint custom: baseURL: https://your-proxy.example.com/v1 apiKey: $CUSTOM_API_KEY ``` --- ## Running the App ```bash # Development pnpm dev # → http://localhost:3000 # Production build pnpm build && pnpm start # Type checking pnpm tsc --noEmit # Linting pnpm lint ``` --- ## Docker Deployment ```bash cp .env.example .env.local # Edit .env.local with your API keys docker compose up --build # → http://localhost:3000 ``` --- ## Vercel Deployment ```bash # Fork the repo, then import at https://vercel.com/new # Set env vars in Vercel dashboard: # OPENAI_API_KEY or ANTHROPIC_API_KEY or GOOGLE_API_KEY # DEFAULT_MODEL (optional, e.g. google:gemini-3-flash-preview) ``` One-click deploy button is available in the README; it pre-fills env var descriptions automatically. --- ## Lesson Generation Pipeline OpenMAIC uses a two-stage pipeline: | Stage | Description | |---|---| | **Outline** | AI analyzes topic/document and produces a structured lesson outline | | **Scenes** | Each outline item is expanded into a typed scene: `slides`, `quiz`, `interactive`, or `pbl` | ### Scene Types | Type | Description | |---|---| | `slides` | AI teacher lectures with TTS narration, spotlight, laser pointer | | `quiz` | Single/multiple choice or short-answer with AI grading | | `interactive` | HTML-based simulation (physics, flowcharts, etc.) | | `pbl` | Project-Based Learning — choose a role, collaborate with agents | --- ## API Usage — Generating a Classroom ### REST: Start Generation Job ```typescript // POST /api/generate const response = await fetch('/api/generate', { method: 'POST', headers: { 'Content-Type': 'a