Frequently Asked Questions

Everything you need to know about OpenMAIC

Common Questions

What is OpenMAIC? +

OpenMAIC (Open Multi-Agent Interactive Classroom) is an open-source AI platform that transforms any topic or document into a rich, interactive classroom experience. It uses multi-agent orchestration to generate slides, quizzes, interactive simulations, and project-based learning activities delivered by AI teachers and AI classmates.

Key features include:

  • One-click lesson generation
  • Multi-agent classroom interactions
  • Rich content types (slides, quizzes, simulations)
  • Whiteboard & text-to-speech capabilities
  • Export options (PowerPoint, HTML)
What are the technical requirements? +

OpenMAIC requires:

  • Node.js ≥ 22.19
  • pnpm ≥ 10
  • At least one LLM provider API key (OpenAI, Anthropic, Azure OpenAI, etc.)
  • For local deployment: Docker or direct Node.js installation

Optional components:

  • PostgreSQL for server-backed persistence
  • FFmpeg for local audio/video extraction
  • VoxCPM2 for self-hosted TTS with voice cloning
  • FunASR for local speech recognition
How do I set up OpenMAIC? +

Follow these steps to get started:

# 1. Clone the repository git clone https://github.com/THU-MAIC/OpenMAIC.git cd OpenMAIC # 2. Install dependencies pnpm install # 3. Configure environment variables cp .env.example .env.local # Edit .env.local with your API keys # 4. Run the development server pnpm dev

Open http://localhost:3000 to access the application.

What LLM providers are supported? +

OpenMAIC supports numerous LLM providers:

  • OpenAI (GPT-3.5, GPT-4, GPT-5)
  • Anthropic (Claude 3, Claude 2)
  • Azure OpenAI
  • Google Gemini
  • Amazon Bedrock
  • DeepSeek
  • Qwen
  • Kimi
  • MiniMax
  • Grok (xAI)
  • GLM (Zhipu)
  • Ollama (local models)
  • Lemonade (local LLM/image/TTS/ASR)
  • OpenRouter

You can configure providers via environment variables or the server-providers.yml file.

Can I use OpenMAIC commercially? +

Yes! OpenMAIC is licensed under the MIT License, which permits commercial use free of charge. You can use, modify, and distribute the software for any purpose, including commercial applications.

For partnership or collaboration inquiries, please contact: thu_maic@mail.tsinghua.edu.cn

How does the multi-agent system work? +

OpenMAIC's multi-agent system uses LangGraph orchestration to create interactive classrooms:

  • AI Teachers: Deliver lectures, facilitate discussions, and guide learning
  • AI Classmates: Participate in discussions, ask questions, and collaborate on projects
  • Director Agent: Orchestrates the classroom flow and manages agent interactions
  • Specialist Agents: Handle specific tasks like whiteboarding, quiz grading, and content generation

Agents can communicate, share a whiteboard, and respond to student input in real-time, creating an immersive learning environment.

What content types can OpenMAIC generate? +

OpenMAIC can create diverse learning content:

  • Slides: Voice-narrated presentations with spotlight effects
  • Quizzes: Interactive assessments with real-time grading
  • Simulations: HTML-based interactive experiments
  • Project-Based Learning (PBL): Collaborative projects with milestones
  • 3D Visualizations: Three-dimensional representations of concepts
  • Mind Maps: Structured knowledge organization
  • Coding Environments: In-browser programming exercises
How can I contribute to OpenMAIC? +

We welcome community contributions! Here's how you can help:

  • Report bugs via GitHub issues
  • Suggest features in the discussions section
  • Submit pull requests for code improvements
  • Translate the interface to new languages
  • Contribute documentation and tutorials
  • Share use cases and success stories

The project structure includes:

  • Core business logic in lib/
  • React components in components/
  • TypeScript packages in packages/
  • OpenClaw integration in skills/
What deployment options are available? +

OpenMAIC offers multiple deployment methods:

  • Local Development: Run locally with Node.js
  • Docker: Containerized deployment
  • Vercel: One-click cloud deployment
  • Server-backed Persistence: PostgreSQL for session storage
  • Self-hosted with OpenClaw: Deploy as a messaging app skill
  • Video Export Service: Dedicated rendering container

Choose the option that best fits your needs - from local development to production-grade deployments.

Is there a demo I can try? +

Yes! You can try OpenMAIC online:

For the hosted demo, visit open.maic.chat and request an access code to start creating interactive classrooms.