🇮🇳 OpenTutor

Step-by-step AI tutoring for Indian students
AI se seekho — step by step, in your language

📚 Subjects: Class 10 Math | Science | English Grammar | History

🤝 Your Study Squad: AI Teacher | AI Assistant | Sawaal King

Try asking:
"Class 9 Maths - Triangles samjhao"
"Photosynthesis whiteboard pe explain karo"
"History of India batao"

🚀 Class Shuru Karo

Live Demo · Quick Start · Features · Use Cases

📖 Overview

OpenTutor (Open Multi-Agent Interactive Classroom) is an open-source AI platform that turns any topic or document into a rich, interactive classroom experience. Powered by multi-agent orchestration, it generates slides, quizzes, interactive simulations, and project-based learning activities — all delivered by AI teachers and AI classmates who can speak, draw on a whiteboard, and engage in real-time discussions with you. With built-in OpenClaw integration, you can generate classrooms directly from messaging apps like Feishu, Slack, or Telegram.

Highlights

• One-click lesson generation — Describe a topic or attach your materials; the AI builds a full lesson in minutes
• Multi-agent classroom — AI teachers and peers lecture, discuss, and interact with you in real time
• Rich scene types — Slides, quizzes, interactive HTML simulations, and project-based learning (PBL)
• Whiteboard & TTS — Agents draw diagrams, write formulas, and explain out loud
• Export anywhere — Download editable .pptx slides or interactive .html pages
• OpenTutor integration — Generate classrooms from Feishu, Slack, Telegram, and 20+ messaging apps via your AI assistant

---

Tip

OpenClaw — Use OpenTutor from your chat app, zero setup

With OpenClaw, you can generate classrooms directly from Feishu, Slack, Discord, Telegram, and 20+ messaging apps.

1. clawhub install openmaic or just ask your Claw "install OpenMAIC skill"
2. Pick a mode:
   • Hosted mode — Get an access code at open.maic.chat, no local setup needed
   • Self-hosted — The skill walks you through clone, config, and startup step by step
3. Tell your assistant "teach me quantum physics" — done!

🐾 Learn more →

---

🚀 Quick Start

Prerequisites

• Node.js >= 20
• pnpm >= 10

2. Configure

cp .env.example .env.local

Fill in at least one LLM provider key:

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...

For local-first usage with Ollama (no quota limits):

OLLAMA_BASE_URL=http://127.0.0.1:11434/v1
OLLAMA_MODELS=qwen3.5:4b,deepseek-r1:8b,qwen2.5-coder:7b
DEFAULT_MODEL=ollama:qwen3.5:4b

You can also configure providers via server-providers.yml:

providers:
  openai:
    apiKey: sk-...
  anthropic:
    apiKey: sk-ant-...

Supported providers: OpenAI, Anthropic, Google Gemini, DeepSeek, and any OpenAI-compatible API.

Recommended model: Gemini 3 Flash — best balance of quality and speed. For highest quality (at slower speed), try Gemini 3.1 Pro.

If you want OpenMAIC server APIs to use Gemini by default, also set DEFAULT_MODEL=google:gemini-3-flash-preview.

For hybrid reliability, keep one cloud key configured and use DEFAULT_MODEL=ollama:qwen3.5:4b; scene generation will auto-fallback to Ollama when cloud quota/rate limits are hit.

3. Run

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
pnpm dev

Open http://localhost:3000 and start learning!

4. Build for Production

pnpm build && pnpm start

Docker Deployment

cp .env.example .env.local
# Edit .env.local with your API keys, then:
docker compose up --build

Optional: MinerU (Advanced Document Parsing)

MinerU provides enhanced parsing for complex tables, formulas, and OCR. You can use the MinerU official API or self-host your own instance.

Set PDF_MINERU_BASE_URL (and PDF_MINERU_API_KEY if needed) in .env.local.

---

✨ Features

Lesson Generation

Describe what you want to learn or attach reference materials. OpenMAIC's two-stage pipeline handles the rest:

Stage	What Happens
Outline	AI analyzes your input and generates a structured lesson outline
Scenes	Each outline item becomes a rich scene — slides, quizzes, interactive modules, or PBL activities

Classroom Components

🎓 Slides AI teachers deliver lectures with voice narration, spotlight effects, and laser pointer animations — just like a real classroom.	🧪 Quiz Interactive quizzes (single / multiple choice, short answer) with real-time AI grading and feedback.
🔬 Interactive Simulation HTML-based interactive experiments for visual, hands-on learning — physics simulators, flowcharts, and more.	🏗️ Project-Based Learning (PBL) Choose a role and collaborate with AI agents on structured projects with milestones and deliverables.

Multi-Agent Interaction

Classroom Discussion — Agents proactively initiate discussions; you can jump in anytime or get called on Roundtable Debate — Multiple agents with different personas discuss a topic, with whiteboard illustrations Q&A Mode — Ask questions freely; the AI teacher responds with slides, diagrams, or whiteboard drawings Whiteboard — AI agents draw on a shared whiteboard in real time — solving equations step by step, sketching flowcharts, or illustrating concepts visually.

OpenClaw Integration

OpenMAIC integrates with OpenClaw — a personal AI assistant that connects to messaging platforms you already use (Feishu, Slack, Discord, Telegram, WhatsApp, etc.). With this integration, you can generate and view interactive classrooms directly from your chat app without ever touching a terminal.

Just tell your OpenClaw assistant what you want to learn — it handles everything else:

• Generate a classroom outline