How thu-maic/openmaic works
OpenMAIC turns a learner’s topic or documents into an interactive, multi-agent classroom, then supports learning, editing, and export. The primary path is request → durable server-side generation run → persisted classroom → classroom playback; the README also describes previews, knowledge-base materials, agentic chat, PBL, and export. Paths for major capabilities come from the tree; edges rely on README statements or SOURCE INDEX references, so unsampled implementation details and wiring are omitted.
Main entry points: engine.ts Durable generation run · page.tsx Classroom playback · route.ts Generation API · index.ts Document store
Components 20
Learner experience
- Workbench request
app/workbench/new/client.tsx - Generation preview
app/generation-preview/page.tsx
Generation
- Generation API
app/api/generate-classroom/route.ts - Durable generation run
lib/server/generation/run/engine.ts - Run status and events
app/api/generation-runs/[id]/route.ts
Classroom runtime
- Classroom playback
app/classroom/[id]/page.tsx - Playback engine
lib/playback/engine.ts - Action execution
lib/action/engine.ts - Classroom editor
components/edit/EditShell/EditShell.tsx - PBL experience
components/scene-renderers/pbl-renderer.tsx - Classroom export
lib/video-export/index.ts
Knowledge and agents
- Material library
app/api/materials/route.ts - Material extraction
app/api/materials/[id]/extraction/route.ts - Classroom agent chat
app/api/chat/pi/route.ts - Agent runtime
app/api/agent/runtime/route.ts
Persistence and integrations
- Document store
lib/document-store/index.ts - Persistence API
app/api/persistence/[...path]/route.ts - Server persistence
lib/persistence/server-provider.ts - Provider settings
components/settings/index.tsx
Other components
- Learner
Connections 19
- Learner → Workbench request: requests course
README.md - Workbench request → Generation API: starts generation
- Generation API → Durable generation run: runs pipeline
README.md - Durable generation run → Run status and events: reports progress
- Durable generation run → Document store: persists classroom
lib/server/generation/run/engine.ts - Durable generation run → Generation preview: provides preview
README.md - Learner → Material library: uploads materials
README.md - Material library → Material extraction: parses attachments
README.md - Learner → Classroom playback: opens lesson
README.md - Classroom playback → Playback engine: plays scenes
- Playback engine → Action execution: executes actions
lib/playback/engine.ts - Learner → Classroom editor: edits classroom
README.md - Classroom playback → PBL experience: renders PBL scenes
- Learner → Classroom agent chat: asks questions
README.md - Classroom agent chat → Agent runtime: uses agent runtime
- Learner → Classroom export: exports classroom
README.md - Persistence API → Document store: reads and writes
app/api/persistence/[...path]/route.ts - Server persistence → Document store: constructs store
lib/persistence/server-provider.ts - Provider settings → Generation API: configures models