# OpenMAIC | MAIC | Knowledge Base | Instagit

Open Multi-Agent Interactive Classroom — Get an immersive, multi-agent learning experience in just one click

GitHub Stars: 23.7k

Repository: https://github.com/THU-MAIC/OpenMAIC

---

## Articles

### [How to Configure and Deploy the OpenMAIC Skill with OpenClaw Workbench Integration](/THU-MAIC/OpenMAIC/how-configure-deploy-openmaic-skill-openclaw-workbench-integration)

Learn to configure and deploy the OpenMAIC Skill with OpenClaw workbench integration. Follow our guide for seamless setup and get started quickly.

- Tags: how-to-guide
- Published: 2026-09-13

### [How Action-Level Playback Navigation Works in the OpenMAIC Classroom Player](/THU-MAIC/OpenMAIC/how-action-level-playback-navigation-works-classroom-player)

Learn how OpenMAIC's classroom player uses action-level playback navigation with a deterministic safety filter to control speech actions and prevent unsafe ones.

- Tags: internals
- Published: 2026-09-13

### [How the PBL v2 System Implements Classroom UI and Project Workflows](/THU-MAIC/OpenMAIC/how-pbl-v2-system-implements-classroom-ui-project-workflows)

Explore how the PBL v2 system's React workspace and runtime agents create an interactive classroom UI and project workflows powered by LLM streams.

- Tags: architecture
- Published: 2026-09-13

### [How to Integrate External Search Providers (Brave, Baidu, and SearXNG) in OpenMAIC](/THU-MAIC/OpenMAIC/how-to-integrate-external-search-providers-brave-baidu-searxng)

Learn how to integrate external search providers like Brave Baidu and SearXNG into OpenMAIC using the unified searchWeb API for seamless web searching across multiple platforms.

- Tags: how-to-guide
- Published: 2026-09-13

### [How Deep-Interactive Mode Renders 3D Visualizations and Simulations in OpenMAIC](/THU-MAIC/OpenMAIC/how-deep-interactive-mode-renders-3d-visualizations-simulations)

Discover how OpenMAIC's deep-interactive mode renders 3D visualizations and simulations using a lightweight Three.js engine and client-side WebGL for dynamic experiences.

- Tags: deep-dive
- Published: 2026-09-13

### [How the OpenMAIC Import Pipeline Processes PPTX Files and Legacy Whiteboard Formats](/THU-MAIC/OpenMAIC/how-import-pipeline-processes-pptx-files-legacy-whiteboard-formats)

Discover how the OpenMAIC import pipeline processes PPTX files with import_pptx and canonicalizes legacy whiteboard data for seamless integration into your projects.

- Tags: how-to-guide
- Published: 2026-09-13

### [How Per-Stage Model Routing Selects Different Models in OpenMAIC](/THU-MAIC/OpenMAIC/how-per-stage-model-routing-selects-different-models-generation-phases)

Discover how per-stage model routing in OpenMAIC selects specific LLMs for each generation phase using a JSON config. Learn about runtime resolution and default model fallback.

- Tags: internals
- Published: 2026-09-13

### [How LangGraph Integration Orchestrates Multi-Agent Classroom Interactions in OpenMAIC](/THU-MAIC/OpenMAIC/how-langgraph-integration-orchestrates-multi-agent-classroom-interactions)

Discover how LangGraph integration orchestrates multi-agent classroom interactions in OpenMAIC. Learn about its stateless StateGraph topology and real-time dialogue streaming.

- Tags: deep-dive
- Published: 2026-09-13

### [How OpenMAIC Handles Session Materials: Upload Policies and Scheduling Explained](/THU-MAIC/OpenMAIC/how-session-materials-handling-works-upload-policies-scheduling)

Learn how OpenMAIC handles session materials with its upload policies and scheduling. Discover file validation, capacity limits, and concurrency control for secure uploads.

- Tags: how-to-guide
- Published: 2026-09-13

### [How PPTX Export Works in OpenMAIC Using the pptxgenjs Library](/THU-MAIC/OpenMAIC/openmaic-pptx-export-using-pptxgenjs-library)

Discover how OpenMAIC uses the pptxgenjs library to export PPTX files. Learn about the three layer pipeline that prepares slides, resolves media, and constructs your presentation.

- Tags: how-to-guide
- Published: 2026-09-13

### [How Event Streaming Works with Capped-Stream for Render Progress in OpenMAIC](/THU-MAIC/OpenMAIC/how-event-streaming-works-capped-stream-render-progress)

Discover how event streaming with capped-stream in OpenMAIC tracks render progress in real-time. Safely limit uploads and prevent memory overflow with this efficient technique.

- Tags: internals
- Published: 2026-09-13

### [How OpenMAIC Resource Profiling Determines CPU and Memory Limits for Render Jobs](/THU-MAIC/OpenMAIC/how-resource-profiling-determines-cpu-memory-limits-render-jobs)

Discover how OpenMAIC resource profiling sets CPU and memory limits for render jobs. Learn about hardware tiers and environment variables for efficient rendering.

- Tags: how-to-guide
- Published: 2026-09-13

### [How Chunk Execution Isolates Video Rendering in Separate Processes in OpenMAIC](/THU-MAIC/OpenMAIC/how-chunk-execution-isolates-video-rendering-separate-processes)

OpenMAIC isolates video rendering using chunk execution. Learn how discrete chunks run in separate Node.js processes for robust performance and crash prevention.

- Tags: internals
- Published: 2026-09-13

### [How the OpenMAIC Preview Rendering Pipeline Uses Chromium for Scene Previews](/THU-MAIC/OpenMAIC/how-preview-rendering-pipeline-uses-chromium-scene-previews)

Discover how OpenMAIC uses Chromium and Puppeteer in its preview rendering pipeline to capture PNG screenshots of scene previews for THU-MAIC OpenMAIC.

- Tags: internals
- Published: 2026-09-13

### [How the OpenMAIC Job Store Manages Render Job Lifecycle and Cancellation](/THU-MAIC/OpenMAIC/how-job-store-manages-render-job-lifecycle-cancellation)

Learn how the OpenMAIC Job Store tracks render jobs from creation to completion and enables cancellation via AbortSignal propagation, ensuring robust lifecycle management.

- Tags: how-to-guide
- Published: 2026-09-13

### [How to Configure Server-Backed Persistence with Postgres and S3 Artifact Storage in OpenMAIC](/THU-MAIC/OpenMAIC/how-configure-server-backed-persistence-postgres-s3-artifact-storage)

Learn how to configure server-backed persistence with Postgres and S3 artifact storage in OpenMAIC. Streamline your data management and enhance scalability today.

- Tags: how-to-guide
- Published: 2026-09-13

### [How TTS/ASR Integration Works with VoxCPM2 and FunASR in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-tts-asr-integration-voxcpm2-funasr)

Learn how OpenMAIC integrates TTS/ASR using VoxCPM2 for voice cloning and FunASR for real-time recognition via WebSocket. Discover modular speech processing in action.

- Tags: deep-dive
- Published: 2026-09-13

### [How OpenMAIC Handles Multi-Format Document Parsing: PDF, Audio, and Video Extraction](/THU-MAIC/OpenMAIC/openmaic-multi-format-document-parsing-pdf-audio-video-extraction)

OpenMAIC seamlessly parses multi-format documents, extracting text, images, audio, and video from PDFs and media streams into a unified material layer for efficient data handling.

- Tags: how-to-guide
- Published: 2026-09-13

### [How OpenMAIC Implements Math Text Rendering and Grading in Its Quiz System](/THU-MAIC/OpenMAIC/how-quiz-system-implemented-math-text-rendering-grading)

Discover how OpenMAIC's quiz system renders math text using KaTeX and grades answers with string comparison and symbolic evaluation. Learn about its three-stage processing pipeline.

- Tags: internals
- Published: 2026-09-13

### [How the OpenMAIC Whiteboard Runtime Handles Viewport Rendering and Browser Projection](/THU-MAIC/OpenMAIC/how-whiteboard-runtime-handles-viewport-rendering-browser-projection)

Discover how the OpenMAIC whiteboard runtime synchronizes on-screen canvas with data using viewport rendering and browser projection. Learn about its three-stage pipeline for seamless updates.

- Tags: internals
- Published: 2026-09-13

### [How to Use OpenMAIC Built-In Skills and Create Custom Skills](/THU-MAIC/OpenMAIC/openmaic-built-in-skills-and-custom-skill-creation)

Explore OpenMAIC's 10+ built-in skills like stage-design and learn to create your own custom skills using the identical SKILL.md manifest structure for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-13

### [How the Agent Workbench Manages Durable Sessions Across Server Restarts](/THU-MAIC/OpenMAIC/how-agent-workbench-manages-durable-sessions-across-server-restarts)

Discover how the Agent Workbench ensures durable sessions persist through server restarts by using localStorage and server validation for seamless workspace continuity.

- Tags: internals
- Published: 2026-09-13

### [How to Implement a Custom LLM Provider in OpenMAIC’s Provider-Neutral Architecture](/THU-MAIC/OpenMAIC/how-to-implement-custom-llm-provider-in-provider-neutral-architecture)

Learn how to implement a custom LLM provider in OpenMAIC's provider-neutral architecture. Create an adapter, export a descriptor, and register it to extend LLM capabilities.

- Tags: how-to-guide
- Published: 2026-09-13

### [How the OpenMAIC Render-Service Coordinates Video Rendering Jobs with the RenderCoordinator](/THU-MAIC/OpenMAIC/how-render-service-coordinates-video-rendering-jobs-with-rendercoordinator)

Discover how the OpenMAIC render-service uses the RenderCoordinator to manage video rendering jobs. Learn about admission control, queueing, and execution management.

- Tags: internals
- Published: 2026-09-13

### [How to Configure Provider Settings Server-Side in OpenMAIC: A Complete Guide](/THU-MAIC/OpenMAIC/how-configure-provider-settings-server-side-openmaic)

Learn how to configure provider settings server-side in OpenMAIC by editing the config object in lib/ai/providers.ts. This guide covers metadata, endpoints, and authentication.

- Tags: how-to-guide
- Published: 2026-09-12

### [Minimum Node.js and pnpm Versions Required for Deploying OpenMAIC](/THU-MAIC/OpenMAIC/minimum-nodejs-pnpm-versions-deploying-openmaic)

Deploy OpenMAIC successfully by ensuring you have the minimum Node.js and pnpm versions. Discover the required Node.js ≥22.19.0 and pnpm ≥10 for seamless deployment.

- Tags: getting-started
- Published: 2026-09-12

### [How the Action Engine Is Implemented in OpenMAIC](/THU-MAIC/OpenMAIC/how-action-engine-implemented-openmaic)

Discover how the OpenMAIC action engine implements a three-tier architecture to translate user intents into executable operations, managing actions from DSL to runtime orchestration.

- Tags: internals
- Published: 2026-09-12

### [What Is the Purpose of the lib/generation Directory in OpenMAIC?](/THU-MAIC/OpenMAIC/purpose-lib-generation-directory-openmaic)

Discover the purpose of the lib/generation directory in OpenMAIC. This core directory powers OpenMAIC's AI content generation pipeline, transforming user inputs into slides, quizzes, and interactive content.

- Tags: internals
- Published: 2026-09-12

### [OpenMAIC Export Formats: PowerPoint, HTML, ZIP, and MP4 Explained](/THU-MAIC/OpenMAIC/export-formats-supported-openmaic)

Explore OpenMAIC export formats including PowerPoint, HTML, ZIP, and MP4. Share and back up your MAIC classrooms easily offline and across platforms.

- Tags: api-reference
- Published: 2026-09-12

### [How the OpenMAIC Render Service Facilitates Video Export: Architecture and Implementation](/THU-MAIC/OpenMAIC/render-service-facilitates-video-export-openmaic)

Learn how the OpenMAIC render service simplifies video export with its three-tier pipeline. Discover the architecture and implementation for efficient MP4 rendering and UI responsiveness.

- Tags: architecture
- Published: 2026-09-12

### [How OpenMAIC Handles Capability Discovery for External Providers: Architecture and Code Walkthrough](/THU-MAIC/OpenMAIC/openmaic-capability-discovery-external-providers)

Explore OpenMAIC's architecture and code to understand how it handles capability discovery for external providers by loading configurations and dynamically registering tools.

- Tags: architecture
- Published: 2026-09-12

### [What TTS Providers Are Available for OpenMAIC: Complete List and Setup Guide](/THU-MAIC/OpenMAIC/tts-providers-available-openmaic)

Explore OpenMAIC's TTS providers: OpenAI, Azure Speech, ElevenLabs, and more. Get a complete list and easy setup guide to integrate text-to-speech for your project.

- Tags: tutorial
- Published: 2026-09-12

### [OpenMAIC LLM Providers: Complete List of Supported AI Models and Configuration Guide](/THU-MAIC/OpenMAIC/llm-providers-supported-openmaic)

Discover all eight LLM providers supported by OpenMAIC, including OpenAI, Anthropic, and Google Gemini. Learn how to configure any OpenAI-compatible endpoint with our comprehensive guide.

- Tags: api-reference
- Published: 2026-09-12

### [How OpenMAIC Ensures Provider-Neutrality and Keeps Credentials Secure](/THU-MAIC/OpenMAIC/openmaic-provider-neutrality-credential-security)

OpenMAIC ensures provider-neutrality and credential security with a layered architecture. Swap vendors without UI changes and keep API keys secure.

- Tags: how-to-guide
- Published: 2026-09-12

### [How the OpenMAIC PostgreSQL Backend Manages Revision Counters and Access Control](/THU-MAIC/OpenMAIC/postgresql-backend-revision-counters-access-control-openmaic)

Discover how the OpenMAIC PostgreSQL backend manages revision counters and access control using revision tables, triggers, and owner-bound store instances. Learn about its robust data management.

- Tags: internals
- Published: 2026-09-12

### [Store Types in the @openmaic/storage Package: A Complete Technical Guide](/THU-MAIC/OpenMAIC/types-of-stores-openmaic-storage-package)

Explore the seven store types in the @openmaic/storage package: KV, Asset, Document, Runtime, Session, Skill, and Material stores. Get a complete technical guide to unified TypeScript APIs.

- Tags: api-reference
- Published: 2026-09-12

### [Built-In Skills Available in OpenMAIC: Complete Inventory and Usage Guide](/THU-MAIC/OpenMAIC/built-in-skills-openmaic-skills-system)

Explore OpenMAIC's ten built-in skills for classroom design, content creation, and more. This guide details their inventory and usage. Learn how to leverage these powerful tools.

- Tags: api-reference
- Published: 2026-09-12

### [OpenMAIC Agent Tools for Planning and Building: Complete Capabilities Guide](/THU-MAIC/OpenMAIC/agent-tools-capabilities-planning-building-openmaic)

Explore OpenMAIC agent tools capabilities for planning and building dynamic educational content. Discover type-safe APIs for web search, voice synthesis, and more.

- Tags: capabilities-guide
- Published: 2026-09-12

### [How the Pro Workbench in OpenMAIC Implements Durable Session Architecture](/THU-MAIC/OpenMAIC/pro-workbench-durable-session-architecture-openmaic)

Discover how OpenMAIC's Pro workbench implements durable session architecture by reconstructing UI state from immutable server-persisted events and applying transient layout adjustments.

- Tags: architecture
- Published: 2026-09-12

### [Complete Guide to OpenMAIC Action Engine Types: Fire-and-Forget vs Synchronous Actions](/THU-MAIC/OpenMAIC/action-types-openmaic-action-engine)

Explore OpenMAIC action engine types. Learn about fire-and-forget and synchronous actions like spotlight, speech, and video playback to enhance your MAIC experience.

- Tags: deep-dive
- Published: 2026-09-12

### [How OpenMAIC Uses LangGraph for Multi-Agent Orchestration](/THU-MAIC/OpenMAIC/how-openmaic-uses-langgraph-multi-agent-orchestration)

Discover how OpenMAIC leverages LangGraph for efficient multi-agent orchestration. Learn about its stateless architecture and single-pass conversation routing for deterministic coordination.

- Tags: how-to-guide
- Published: 2026-09-12

### [Four Content Kinds Supported Within the Scene Generic in OpenMAIC: Complete TypeScript Reference](/THU-MAIC/OpenMAIC/four-content-kinds-scene-generic-openmaic)

Discover the four content kinds supported in OpenMAIC's Scene generic: Slide, Quiz, Interactive, and PBL. Explore this TypeScript reference for detailed implementation.

- Tags: api-reference
- Published: 2026-09-12

### [What Is the Purpose of the @openmaic/dsl Package in OpenMAIC?](/THU-MAIC/OpenMAIC/purpose-of-openmaic-dsl-package)

Discover the purpose of the @openmaic/dsl package, the contract-keystone of OpenMAIC SDK. It provides zero-dependency TypeScript specifications for data structures, validation, and migration.

- Tags: deep-dive
- Published: 2026-09-12

### [Key Files for Outline Generation in OpenMAIC: Architecture and Implementation](/THU-MAIC/OpenMAIC/key-files-outline-generation-openmaic)

Discover the six key files for outline generation in OpenMAIC. Understand the architecture and implementation driving this essential feature from command to classroom structure.

- Tags: architecture
- Published: 2026-09-12

### [Understanding the Two-Stage Generation Pipeline in OpenMAIC: From Raw Material to Interactive Lessons](/THU-MAIC/OpenMAIC/explain-two-stage-generation-pipeline-openmaic)

Explore OpenMAIC's two-stage generation pipeline. Learn how LLM planning transforms documents into interactive lessons with quizzes, simulations, and voice-overs.

- Tags: internals
- Published: 2026-09-12

### [What Technologies Are Used in the OpenMAIC Presentation Layer: A Complete Stack Breakdown](/THU-MAIC/OpenMAIC/what-technologies-are-used-in-openmaic-presentation-layer)

Discover the technologies powering OpenMAIC's presentation layer. Explore React 19, Next.js 16, TypeScript, Tailwind CSS v4, and Radix UI/shadcn/ui for an accessible stack.

- Tags: deep-dive
- Published: 2026-09-12

### [How OpenMAIC Transforms Documents into Interactive Classroom Experiences: A Complete Technical Guide](/THU-MAIC/OpenMAIC/how-openmaic-transforms-documents-into-interactive-classroom-experiences)

Discover how OpenMAIC transforms documents into interactive classroom experiences. This technical guide explores its six-stage pipeline for dynamic AI-powered content.

- Tags: how-to-guide
- Published: 2026-09-12

### [How OpenMAIC Manages LLM Provider Configuration: Server-Side Architecture Explained](/THU-MAIC/OpenMAIC/how-is-llm-provider-configuration-managed-in-openmaic)

OpenMAIC server-side architecture centralizes LLM provider configuration via YAML files and environment variables. Discover how it secures API keys and exposes resolver APIs.

- Tags: architecture
- Published: 2026-09-11

### [Which LLM Providers Are Supported by OpenMAIC? A Complete Technical Guide](/THU-MAIC/OpenMAIC/which-llm-providers-are-supported-by-openmaic)

Explore LLM providers supported by OpenMAIC: OpenAI, Anthropic, Azure OpenAI, Gemini, and more. Discover how to integrate custom endpoints easily.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Export OpenMAIC Content as a PowerPoint (.pptx) File](/THU-MAIC/OpenMAIC/how-can-i-export-openmaic-content-as-a-powerpoint-file)

Easily export OpenMAIC content to PowerPoint (.pptx) files using the built-in export pipeline and the buildPptxBlob function. Transform your slides, media, and annotations into shareable presentations.

- Tags: how-to-guide
- Published: 2026-09-11

### [Export Capabilities of OpenMAIC: Multi-Modal Video and Interactive Content Packaging](/THU-MAIC/OpenMAIC/what-are-the-export-capabilities-of-openmaic)

Discover OpenMAIC export capabilities. Generate MP4 videos, interactive HTML, and skill packages via a deterministic TypeScript pipeline.

- Tags: getting-started
- Published: 2026-09-11

### [Can AI Teachers Actively Operate the UI in OpenMAIC? Deep Interactive Mode Explained](/THU-MAIC/OpenMAIC/can-ai-teachers-actively-operate-the-ui-in-openmaic)

Discover how AI teachers in OpenMAIC actively operate the UI. Learn about Deep Interactive Mode, LangGraph orchestration, and guided learner attention.

- Tags: deep-dive
- Published: 2026-09-11

### [What Types of Interactive UI Elements Does OpenMAIC Support Beyond Standard Slides?](/THU-MAIC/OpenMAIC/what-types-of-interactive-ui-elements-does-openmaic-support)

Discover OpenMAIC's advanced interactive UI elements beyond slides: dynamic HTML scenes, iframe element references, and static offline widgets. Enhance your dashboards now.

- Tags: getting-started
- Published: 2026-09-11

### [OpenMAIC Material Management for Agents: File Upload and Extraction Pipeline](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-material-management-for-agents)

Discover how OpenMAIC handles agent material management. Learn about its six-phase file upload and extraction pipeline, including MIME validation, slot accounting, and automatic retries.

- Tags: how-to-guide
- Published: 2026-09-11

### [What Built-In Skills Does the OpenMAIC Agent System Provide?](/THU-MAIC/OpenMAIC/what-built-in-skills-does-the-openmaic-agent-system-provide)

Explore OpenMAIC's 22 built-in skills designed to automate educational workflows. Discover how to leverage these skills for curriculum design, content creation, and research.

- Tags: deep-dive
- Published: 2026-09-11

### [How OpenMAIC Manages and Persists Agent Sessions: Client-Side Durability Architecture](/THU-MAIC/OpenMAIC/how-are-agent-sessions-managed-and-made-durable-in-openmaic)

Discover how OpenMAIC ensures agent session durability client-side using localStorage and URL parameters. Learn about its robust session management architecture.

- Tags: architecture
- Published: 2026-09-11

### [OpenMAIC Agent Runtime Features: A Complete Technical Guide](/THU-MAIC/OpenMAIC/what-are-the-features-of-the-openmaic-agent-runtime)

Explore OpenMAIC agent runtime features: durable server engine, persistent sessions, pluggable storage, AI access, and tool integrity. Your guide to multi-agent classrooms.

- Tags: technical-guide
- Published: 2026-09-11

### [Can OpenMAIC Use PostgreSQL for Its Document Store? Complete Implementation Guide](/THU-MAIC/OpenMAIC/can-openmaic-use-postgresql-for-its-document-store)

Discover how OpenMAIC integrates with PostgreSQL for its document store. This guide provides a complete implementation with automatic activation via DATABASE_URL.

- Tags: how-to-guide
- Published: 2026-09-11

### [How the OpenMAIC Storage Layer Handles KV Pairs, Documents, and Assets](/THU-MAIC/OpenMAIC/how-does-openmaics-storage-layer-handle-different-types-of-data)

Discover how OpenMAIC's storage layer efficiently manages KV pairs, documents, and assets using specialized orthogonal layers for optimized data handling and consistency.

- Tags: architecture
- Published: 2026-09-11

### [OpenMAIC Storage Backends: IndexedDB, PostgreSQL, and In-Memory Support](/THU-MAIC/OpenMAIC/what-storage-backends-does-openmaic-support)

Discover OpenMAIC storage backends: IndexedDB for offline, PostgreSQL for server data, and in-memory for testing. Optimize your application's data management.

- Tags: architecture
- Published: 2026-09-11

### [Which Package Powers OpenMAIC's Generation Contracts and Pipeline?](/THU-MAIC/OpenMAIC/which-package-is-used-for-openmaics-generation-contracts-and-pipeline)

Discover which package powers OpenMAIC's generation contracts and pipeline. Learn how @openmaic/generation handles typings, orchestration, and the lesson generation flow.

- Tags: deep-dive
- Published: 2026-09-11

### [What Are the Two Stages of the Lesson Generation Process in OpenMAIC?](/THU-MAIC/OpenMAIC/what-are-the-two-stages-of-the-lesson-generation-process-in-openmaic)

Discover the two stages of lesson generation in OpenMAIC: Outline Generation for structure and Scene Generation for rich content. Learn how OpenMAIC builds effective lessons.

- Tags: deep-dive
- Published: 2026-09-11

### [How the OpenMAIC Lesson Generation Pipeline Is Structured: A Deep Dive into the Agent-Runtime Architecture](/THU-MAIC/OpenMAIC/how-is-the-lesson-generation-pipeline-structured-in-openmaic)

Explore the OpenMAIC lesson generation pipeline's five-layer server-side orchestration. Learn how it turns prompts into skills and builds lessons with crash resilience.

- Tags: deep-dive
- Published: 2026-09-11

### [What Types of Actions Are Supported by the OpenMAIC Orchestration System?](/THU-MAIC/OpenMAIC/what-types-of-actions-are-supported-by-the-openmaic-orchestration-system)

Discover the diverse action types supported by the OpenMAIC orchestration system, including speech synthesis, video playback, and session control. Learn how OpenMAIC streamlines complex workflows.

- Tags: api-reference
- Published: 2026-09-11

### [How the OpenMAIC Orchestration System Uses LLMs for Agent Decision-Making](/THU-MAIC/OpenMAIC/does-the-openmaic-orchestration-system-use-llms-for-agent-decision-making)

Discover how the OpenMAIC orchestration system leverages LLMs for intelligent agent decision-making. Learn about its innovative approach to generating actions, skills, and voice designs.

- Tags: deep-dive
- Published: 2026-09-11

### [How the OpenMAIC Director Graph Decides Which Agent Speaks Next](/THU-MAIC/OpenMAIC/how-does-the-director-graph-decide-which-agent-speaks-next)

Discover how the OpenMAIC Director Graph selects the next speaking agent. Learn about fast-path evaluation and LLM-based decision making for efficient AI conversation flow.

- Tags: internals
- Published: 2026-09-11

### [Where to Find the Core Orchestration Logic in the OpenMAIC Codebase](/THU-MAIC/OpenMAIC/where-can-i-find-the-core-orchestration-logic-in-the-openmaic-codebase)

Discover the core orchestration logic in the OpenMAIC codebase. Find key files like stateless-generate.ts and director-graph.ts within the lib orchestration directory.

- Tags: internals
- Published: 2026-09-11

### [How OpenMAIC Handles Turn-Based Interactions Between AI Agents](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-turn-based-interactions-between-ai-agents)

OpenMAIC handles turn-based interactions with a dual-layer event architecture separating turns and exchanges for responsive UI and efficient replay via Server-Sent Events.

- Tags: internals
- Published: 2026-09-11

### [Director Graph in OpenMAIC: Orchestrating Multi-Agent Workflows with LangGraph](/THU-MAIC/OpenMAIC/what-is-the-role-of-the-director-graph-in-openmaics-orchestration)

Discover the Director Graph in OpenMAIC, the LangGraph StateGraph that orchestrates multi-agent workflows by managing state, aggregating evidence, and invoking tools for the Director agent.

- Tags: deep-dive
- Published: 2026-09-11

### [How Multi-Agent Orchestration Works in OpenMAIC: A Technical Deep Dive](/THU-MAIC/OpenMAIC/how-is-multi-agent-orchestration-implemented-in-openmaic)

Learn how OpenMAIC implements multi-agent orchestration using a stateless LangGraph state machine. Discover how it routes requests to specialized agents and streams structured JSON output for efficient UI events.

- Tags: deep-dive
- Published: 2026-09-11

### [How to Run Playwright E2E Tests for OpenMAIC: Complete Setup Guide](/THU-MAIC/OpenMAIC/how-can-i-run-playwright-e2e-tests-for-openmaic)

Learn to run Playwright E2E tests for OpenMAIC. Install dependencies, configure the server, and execute tests with our complete setup guide.

- Tags: how-to-guide
- Published: 2026-09-10

### [How OpenMAIC Manages Document Updates with Versioning: Optimistic Concurrency Deep Dive](/THU-MAIC/OpenMAIC/how-does-openmaic-manage-document-updates-with-versioning)

OpenMAIC versioning prevents lost updates using optimistic concurrency. Learn how OpenMAIC rejects stale writes and ensures data integrity for your document management.

- Tags: deep-dive
- Published: 2026-09-10

### [What Are the Main Scene Types Supported by OpenMAIC? A Complete Guide](/THU-MAIC/OpenMAIC/what-are-the-main-scene-types-supported-by-openmaic)

Explore OpenMAIC scene types: slide, quiz, interactive, and pbl. Understand how these structures organize educational content within the THU-MAIC/OpenMAIC platform. Your complete guide.

- Tags: getting-started
- Published: 2026-09-10

### [Build-Time Feature Flags in OpenMAIC: Complete Configuration Guide](/THU-MAIC/OpenMAIC/what-are-the-build-time-feature-flags-in-openmaic)

Discover OpenMAIC build-time feature flags, controlling optional features via environment variables. Safely inline values for server and client bundles without exposing secrets.

- Tags: complete-guide
- Published: 2026-09-10

### [How to Configure Providers for OpenMAIC: A Complete Guide](/THU-MAIC/OpenMAIC/how-to-configure-providers-for-openmaic)

Learn how to configure providers for OpenMAIC. Customize client-side settings or enforce server-wide policies with a simple YAML file for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-10

### [How to Enable PPTX Import in OpenMAIC: A Complete Implementation Guide](/THU-MAIC/OpenMAIC/how-to-enable-pptx-import-in-openmaic)

Unlock PPTX import in OpenMAIC with our guide. Learn how the importer package and JSZip convert PowerPoint to JSON for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-10

### [How to Use the PPTX Import Pipeline in @openmaic/importer](/THU-MAIC/OpenMAIC/how-to-use-the-pptx-import-pipeline-in-openmaic-importer)

Learn how to use the PPTX import pipeline in @openmaic/importer. Convert PowerPoint files to structured JSON by following our step by step guide and unlock powerful data extraction.

- Tags: how-to-guide
- Published: 2026-09-10

### [How @openmaic/generation Orchestrates AI Model Calls: Inside the OpenMAIC Engine](/THU-MAIC/OpenMAIC/how-does-the-openmaic-generation-package-orchestrate-ai-model-calls)

Discover how OpenMAIC generation orchestrates AI model calls via a seven-stage pipeline. Learn about prompt templating, AI function calls, JSON repair, and output normalization.

- Tags: internals
- Published: 2026-09-10

### [How to Enable and Use the @openmaic/editor Package: A Complete Guide](/THU-MAIC/OpenMAIC/how-to-enable-and-use-the-openmaic-editor-package)

Learn to enable and use the @openmaic/editor package. Install, import CSS, and wrap your app with EditorProvider for a powerful ProseMirror editor.

- Tags: how-to-guide
- Published: 2026-09-10

### [How the Three-Layer Asset Model Works in OpenMAIC Storage](/THU-MAIC/OpenMAIC/how-does-the-three-layer-asset-model-work-in-openmaic-storage)

Learn how the three-layer asset model in OpenMAIC Storage separates metadata, binary storage, and garbage collection for portable references, crash-safe transactions, and deadlock-free reclamation.

- Tags: architecture
- Published: 2026-09-10

### [HTTP Contracts for the @openmaic/storage Package: Complete API Reference](/THU-MAIC/OpenMAIC/what-are-the-http-contracts-for-the-openmaic-storage-package)

Explore the HTTP contracts for the @openmaic/storage package. Discover Runtime, Document, and Asset APIs with the unified createStorageHttpHandler composable.

- Tags: api-reference
- Published: 2026-09-10

### [How @openmaic/dsl Handles Versioning and Migrations: A Complete Guide to the DSL Migration System](/THU-MAIC/OpenMAIC/how-does-openmaic-dsl-handle-versioning-and-migrations)

Discover how OpenMAIC DSL manages versioning and migrations. Learn about its automatic document upgrades from stored dslVersion to the current DSL_VERSION using a pure migration runner and ordered transforms.

- Tags: how-to-guide
- Published: 2026-09-10

### [How to Use the @openmaic/dsl Package in OpenMAIC: Complete Developer's Guide](/THU-MAIC/OpenMAIC/how-to-use-the-openmaic-dsl-package)

Master the @openmaic/dsl package with this developer's guide. Learn to validate normalize and migrate MAIC lesson documents using TypeScript utilities for seamless project integration.

- Tags: how-to-guide
- Published: 2026-09-10

### [How the Render Service Is Isolated in OpenMAIC: Architecture and Security Mechanisms](/THU-MAIC/OpenMAIC/how-is-the-render-service-isolated-in-openmaic)

Discover how OpenMAIC isolates its render service using containerization, worker threads, and resource profiling. Learn about its microservice architecture and security measures.

- Tags: architecture
- Published: 2026-09-10

### [Understanding the Persistence Strategy in OpenMAIC: Hybrid Client-Server Architecture](/THU-MAIC/OpenMAIC/what-is-the-persistence-strategy-in-openmaic)

Discover OpenMAIC's hybrid persistence strategy. Learn how it stores user data in the browser via IndexedDB and localStorage, with optional PostgreSQL sync.

- Tags: deep-dive
- Published: 2026-09-10

### [How OpenMAIC Manages Feature Flags: A Centralized TypeScript Pattern](/THU-MAIC/OpenMAIC/how-are-feature-flags-managed-in-openmaic)

Learn how OpenMAIC manages feature flags using a centralized TypeScript pattern. Discover how predicate functions enable consistent feature gating across your application.

- Tags: architecture
- Published: 2026-09-10

### [How OpenMAIC Handles LLM, TTS, and ASR Provider Integrations: A Technical Deep Dive](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-llm-tts-asr-and-other-provider-integrations)

Explore OpenMAIC's technical approach to integrating LLM, TTS, and ASR providers. Learn how its unified architecture securely connects external services without exposing credentials.

- Tags: deep-dive
- Published: 2026-09-10

### [OpenMAIC Monorepo Directory Structure: A Complete Guide to the Codebase Organization](/THU-MAIC/OpenMAIC/what-is-the-directory-structure-of-the-openmaic-monorepo)

Explore the OpenMAIC monorepo directory structure. Understand the organization of packages components lib configs scripts tests assets and documentation for efficient development and independent publishing.

- Tags: how-to-guide
- Published: 2026-09-10

### [How to Build on Top of OpenMAIC's Published npm Packages: A Complete Guide](/THU-MAIC/OpenMAIC/how-to-build-on-top-of-openmaics-published-npm-packages)

Learn how to build on top of OpenMAIC's published npm packages to create custom slide-editing experiences, render presentations, and run AI pipelines without reinventing core logic. Get started today!

- Tags: how-to-guide
- Published: 2026-09-10

### [How to Self-Host OpenMAIC: A Complete Deployment Guide](/THU-MAIC/OpenMAIC/how-to-self-host-openmaic)

Learn to self-host OpenMAIC by cloning the THU-MAIC/OpenMAIC repo, configuring API keys, and running docker compose up. Deploy your AI instance easily today.

- Tags: how-to-guide
- Published: 2026-09-10

### [How to Configure OpenMAIC for Local Development with Ollama: Complete Setup Guide](/THU-MAIC/OpenMAIC/how-to-configure-openmaic-for-local-development-with-ollama)

Easily set up OpenMAIC for local development using Ollama. Follow this guide to configure the Ollama daemon, keyless provider, model routing, and run the development server for seamless local AI deployment.

- Tags: how-to-guide
- Published: 2026-09-09

### [What Is the OpenMAIC Renderer SDK Used For?](/THU-MAIC/OpenMAIC/what-is-the-openmaic-renderer-sdk-used-for)

Explore the OpenMAIC Renderer SDK's capabilities. This powerful tool converts internal data into visual output, enabling real-time previews and efficient export for videos PDFs and snapshots.

- Tags: how-to-guide
- Published: 2026-09-09

### [How to Use the OpenMAIC DSL SDK for Type-Safe Lesson Documents](/THU-MAIC/OpenMAIC/how-to-use-the-openmaic-dsl-sdk)

Discover the OpenMAIC DSL SDK a zero-dependency TypeScript library. Master type-safe lesson documents with validation, normalization, migration, and asset enumeration APIs.

- Tags: how-to-guide
- Published: 2026-09-09

### [What Are the @openmaic SDKs? A Deep Dive into OpenMAIC's Modular Architecture](/THU-MAIC/OpenMAIC/what-are-the-openmaic-sdks)

Explore the @openmaic SDKs: six npm packages for creating, rendering, editing, and managing lesson content in the OpenMAIC platform. Discover their modular architecture and functionalities.

- Tags: deep-dive
- Published: 2026-09-09

### [How OpenMAIC Handles Real-Time SSE Delivery: A Three-Pipeline Architecture](/THU-MAIC/OpenMAIC/how-is-real-time-sse-delivery-handled-in-openmaic)

Discover how OpenMAIC ensures reliable real-time SSE delivery with its three-pipeline architecture, native EventSource API, replay buffers, and health monitoring for live data synchronization.

- Tags: architecture
- Published: 2026-09-09

### [What Events Are Streamed by the Director Graph in OpenMAIC?](/THU-MAIC/OpenMAIC/what-kind-of-events-are-streamed-by-director-graph)

Explore director graph events in OpenMAIC. Learn about directorState and directorToolTrace for real-time updates on turn progression, agent responses, tool invocations, and session lifecycle signals.

- Tags: internals
- Published: 2026-09-09

### [Understanding the LangGraph Director Graph in OpenMAIC](/THU-MAIC/OpenMAIC/what-is-the-langgraph-director-graph-in-openmaic)

Discover the LangGraph Director Graph in OpenMAIC. Learn how this stateless StateGraph orchestrates multi-agent conversations by directing requests to agents, users, or ending the chat.

- Tags: deep-dive
- Published: 2026-09-09

### [How to Define Custom Skills for OpenMAIC Agents: A Complete Developer Guide](/THU-MAIC/OpenMAIC/how-to-define-custom-skills-for-openmaic-agents)

Learn how to define custom skills for OpenMAIC agents. This developer guide shows you how to create and register new skills for your agents, extending their capabilities.

- Tags: how-to-guide
- Published: 2026-09-09

### [How Many Built-In Skills Does OpenMAIC Have? A Complete Guide to the 23-Agent Runtime](/THU-MAIC/OpenMAIC/how-many-built-in-skills-does-openmaic-have)

Discover the 23 built-in skills in OpenMAIC's agent runtime. This guide details each skill and how the framework automatically discovers and exposes them for enhanced chatbot capabilities.

- Tags: how-to-guide
- Published: 2026-09-09

### [What Is the Maximum Session Prompt Length in OpenMAIC?](/THU-MAIC/OpenMAIC/maximum-session-prompt-length-in-openmaic)

Discover the maximum session prompt length in OpenMAIC. Learn about the 2048 character limit and where it's defined in the workbench source code to optimize your interactions.

- Tags: api-reference
- Published: 2026-09-09

### [How OpenMAIC Manages Agent Sessions: Client-Side Persistence and Deep Linking](/THU-MAIC/OpenMAIC/how-are-agent-sessions-managed-in-openmaic)

Discover how OpenMAIC manages agent sessions client-side with localStorage persistence and deep linking for uninterrupted workspace continuity.

- Tags: internals
- Published: 2026-09-09

### [Agent Workbench Runtime Requirements: OpenMAIC Setup Guide](/THU-MAIC/OpenMAIC/requirements-for-agent-workbench-runtime)

Discover the Agent Workbench runtime requirements for OpenMAIC setup. Learn about Node.js, Docker Compose, PostgreSQL, and essential environment variables to get started.

- Tags: getting-started
- Published: 2026-09-09

### [How to Enable the Pro Workbench in OpenMAIC: Complete Configuration Guide](/THU-MAIC/OpenMAIC/how-to-enable-the-pro-workbench-in-openmaic)

Easily enable the Pro workbench in OpenMAIC with our complete configuration guide. Learn to set feature flags and runtime variables for full access.

- Tags: how-to-guide
- Published: 2026-09-09

### [What Is the OpenMAIC Agent Workbench? A Deep Dive into the Pro Interface for AI Course Generation](/THU-MAIC/OpenMAIC/what-is-the-openmaic-agent-workbench)

Discover the OpenMAIC Agent Workbench, a chat-first workspace that lets AI plan build and revise courses in real time. Explore the pro interface for AI course generation.

- Tags: deep-dive
- Published: 2026-09-09

### [How to Configure Asset Storage in OpenMAIC: PostgreSQL vs S3 Setup Guide](/THU-MAIC/OpenMAIC/how-is-asset-storage-configured-in-openmaic)

Configure OpenMAIC asset storage with PostgreSQL or S3. Learn how to set up your environment variable for seamless binary asset management in your OpenMAIC deployment.

- Tags: how-to-guide
- Published: 2026-09-09

### [PostgreSQL Persistence in OpenMAIC: Trade-offs, Benefits, and Implementation](/THU-MAIC/OpenMAIC/tradeoffs-of-postgresql-persistence-in-openmaic)

Explore PostgreSQL persistence in OpenMAIC. Understand tradeoffs like latency and scalability, benefits of ACID durability, and implementation details. Optimize your data management.

- Tags: deep-dive
- Published: 2026-09-09

### [Environment Variables for LLM Providers in OpenMAIC: Complete Configuration Guide](/THU-MAIC/OpenMAIC/environment-variables-for-llm-providers)

Configure LLM provider environment variables in OpenMAIC. Learn to set up API keys and default models for seamless integration and efficient request routing.

- Tags: how-to-guide
- Published: 2026-09-09

### [Supported LLM Providers for OpenMAIC: Complete Configuration Guide](/THU-MAIC/OpenMAIC/supported-llm-providers-for-openmaic)

Discover the eight supported LLM providers for OpenMAIC, including OpenAI, Anthropic, and Google Gemini. This guide details their configuration for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-09

### [How OpenMAIC's Two-Stage Generation Pipeline Works: Draft-to-Refine Architecture](/THU-MAIC/OpenMAIC/how-openmaics-two-stage-generation-pipeline-works)

Discover OpenMAIC's two-stage generation pipeline. Learn how its draft-to-refine architecture minimizes LLM calls for factual, safe outputs.

- Tags: internals
- Published: 2026-09-09

### [OpenMAIC Server-Backed Persistence Security Model: Three-Layer Defense Explained](/THU-MAIC/OpenMAIC/what-is-the-security-model-for-server-backed-persistence-in-openmaic)

Discover OpenMAIC's server-backed persistence security model. Learn about its three-layer defense: feature gates, token auth, and stage-scoped authorization for robust data isolation.

- Tags: architecture
- Published: 2026-09-08

### [How to Configure OpenMAIC for China and Slow Network Environments: Complete Setup Guide](/THU-MAIC/OpenMAIC/how-to-configure-openmaic-for-china-or-slow-network-environments)

Configure OpenMAIC for China and slow networks. Learn to set AI providers, proxyFetch, MAX_PROXY_BYTES, and feature flags for optimal performance in restricted environments.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Enable Video Export in OpenMAIC Docker Deployment](/THU-MAIC/OpenMAIC/how-to-enable-video-export-in-openmaic-docker-deployment)

Easily enable video export in your OpenMAIC Docker deployment. Set NEXT_PUBLIC_ENABLE_VIDEO_EXPORT=true and use the --profile video-export flag.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Set Up PostgreSQL Persistence for OpenMAIC Docker Deployment](/THU-MAIC/OpenMAIC/how-to-set-up-postgresql-persistence-for-openmaic-docker-deployment)

Set up PostgreSQL persistence for your OpenMAIC Docker deployment. Learn to run a database container and enable server persistence for robust data storage.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Deploy OpenMAIC Using Docker: A Complete Production Setup Guide](/THU-MAIC/OpenMAIC/how-to-deploy-openmaic-using-docker)

Easily deploy OpenMAIC using Docker with this complete production setup guide. Clone the repo, set env variables, and run a single command for a seamless installation.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Set the Default Model in OpenMAIC: Token Plans, Settings UI, and Code-Level Configuration](/THU-MAIC/OpenMAIC/how-to-set-the-default-model-in-openmaic)

Easily set the default model in OpenMAIC using token plans or the Settings UI. Learn to configure your default model permanently for seamless AI interactions.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Configure Amazon Bedrock Models in OpenMAIC](/THU-MAIC/OpenMAIC/how-to-configure-bedrock-models-in-openmaic)

Learn how to configure Amazon Bedrock models in OpenMAIC by setting environment variables or defining a server-providers.yml block. Easily integrate powerful AI models.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Configure Azure OpenAI for OpenMAIC: Complete Environment Variable Setup](/THU-MAIC/OpenMAIC/how-to-configure-azure-openai-for-openmaic)

Configure Azure OpenAI for OpenMAIC by setting essential environment variables. Learn how to set AZURE_OPENAI_ENDPOINT, AZURE_OPENAI_API_KEY, and AZURE_OPENAI_<DEPLOYMENT> for seamless integration and model selection.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Set Up OpenAI API Key for OpenMAIC: Complete Configuration Guide](/THU-MAIC/OpenMAIC/how-to-set-up-openai-api-key-for-openmaic)

Learn how to set up your OpenAI API key for OpenMAIC by configuring the .env.local file. Follow this guide to enable all OpenAI features and enhance your MAIC experience.

- Tags: how-to-guide
- Published: 2026-09-08

### [What Actions Can the OpenMAIC Action Engine Execute?](/THU-MAIC/OpenMAIC/what-actions-can-the-openmaic-action-engine-execute)

Explore 18 action types supported by the OpenMAIC action engine including text-to-speech video control whiteboard drawing and more Discover its versatile capabilities.

- Tags: api-reference
- Published: 2026-09-08

### [What Is the Role of the Playback Engine in OpenMAIC? A Deep Dive Into the Core Orchestrator](/THU-MAIC/OpenMAIC/what-is-the-role-of-the-playback-engine-in-openmaic)

Discover the OpenMAIC playback engine role. This core orchestrator manages lecture playback, live discussions, audio, interruptions, and state persistence for seamless lecture delivery.

- Tags: deep-dive
- Published: 2026-09-08

### [Swappable Stores in OpenMAIC's Persistence Layer: 8 Store Types Explained](/THU-MAIC/OpenMAIC/what-are-the-swappable-stores-in-openmaics-persistence-layer)

Explore OpenMAIC's eight swappable persistence stores like Document, Runtime, and Asset. Learn how to easily switch between PostgreSQL, S3, and IndexedDB backends.

- Tags: internals
- Published: 2026-09-08

### [How OpenMAIC Handles Model Routing: Per-Stage LLM Configuration Explained](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-model-routing)

OpenMAIC routes LLM calls using per-stage configuration via the MODEL_ROUTES environment variable. Learn how different conversation stages map to distinct LLM providers.

- Tags: internals
- Published: 2026-09-08

### [How the Materials Pipeline Works in OpenMAIC: From Upload to AI Extraction](/THU-MAIC/OpenMAIC/how-does-the-materials-pipeline-work-in-openmaic)

Understand the OpenMAIC materials pipeline from file upload to AI extraction. Learn how OpenMAIC manages user files, enforces limits, and extracts content for AI lesson generation.

- Tags: deep-dive
- Published: 2026-09-08

### [What Are the Built-In Skills in OpenMAIC? A Complete Guide to Agent Capabilities](/THU-MAIC/OpenMAIC/what-are-the-built-in-skills-in-openmaic)

Explore 23 built-in agent skills in OpenMAIC. This guide details agent capabilities and their functionality accessible via the slash-menu interface.

- Tags: how-to-guide
- Published: 2026-09-08

### [How to Enable Cancellation and Steering for OpenMAIC Agent Sessions](/THU-MAIC/OpenMAIC/how-can-i-enable-cancellation-and-steering-for-openmaic-agent-sessions)

Learn to enable cancellation and steering for OpenMAIC agent sessions. Call cancelWorkbenchSession or send steer messages for mid-run instructions.

- Tags: how-to-guide
- Published: 2026-09-08

### [What Is Leased Execution in the OpenMAIC Agent Runtime?](/THU-MAIC/OpenMAIC/what-is-leased-execution-in-openmaic-agent-runtime)

Understand leased execution in OpenMAIC agent runtime. Learn how PostgreSQL leases ensure fault-tolerant, exactly-once execution for distributed worker processes.

- Tags: deep-dive
- Published: 2026-09-08

### [How the OpenMAIC Agent Runtime Handles Sessions: Architecture and Lifecycle](/THU-MAIC/OpenMAIC/how-does-the-agent-runtime-in-openmaic-handle-sessions)

Discover how the OpenMAIC agent runtime handles sessions, managing user conversations and classroom states through server-side creation, URL routing, and localStorage persistence for isolated contexts.

- Tags: architecture
- Published: 2026-09-08

### [The OpenMAIC Generation Process: 5 Stages to Build Interactive Classrooms](/THU-MAIC/OpenMAIC/what-are-the-stages-in-the-openmaic-generation-process)

Discover the 5 stages of the OpenMAIC generation process. Transform lesson outlines into interactive classrooms with Outline, Scene, TTS, Media, and Consolidation.

- Tags: how-to-guide
- Published: 2026-09-08

### [How the OpenMAIC Generation Pipeline Works: From Prompt to Persistent Media Scene](/THU-MAIC/OpenMAIC/how-does-the-openmaic-generation-pipeline-work)

Explore the OpenMAIC generation pipeline from prompt to media scene. Discover its eight-stage architecture including Next.js, Agent Runtime, and PostgreSQL for efficient media creation.

- Tags: how-to-guide
- Published: 2026-09-08

### [Understanding the Monorepo Structure of OpenMAIC: A Complete Guide](/THU-MAIC/OpenMAIC/what-is-the-monorepo-structure-of-openmaic)

Explore the OpenMAIC monorepo structure. Learn how pnpm, apps, packages, configs, and components streamline Next.js frontend, AI agent libraries, and shared configs.

- Tags: architecture
- Published: 2026-09-08

### [How OpenMAIC Architecture Works: A Modular AI Classroom System](/THU-MAIC/OpenMAIC/how-does-openmaic-architecture-work)

Discover the OpenMAIC architecture a modular AI classroom system. Learn how Next.js LangGraph orchestrate LLM agents for dynamic content generation with pluggable services.

- Tags: architecture
- Published: 2026-09-08

### [OpenMAIC Agent Driver Model Configuration: How It Works](/THU-MAIC/OpenMAIC/openmaic-agent-driver-model-configuration)

Discover how the OpenMAIC agent driver model is configured. Learn about its stage based routing system, model identifier, API override, dialect, and context window for powerful agent operations.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Find and Configure Agent Runtime Settings in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-agent-runtime-configuration-settings)

Discover how to find and configure agent runtime settings in OpenMAIC. Learn to manage server-side environment variables in .env files and access them via the agentRuntimeConfig object.

- Tags: how-to-guide
- Published: 2026-09-06

### [OpenMAIC Agent Runtime Tools: Complete Guide to Built-In Tools and Skills](/THU-MAIC/OpenMAIC/openmaic-agent-runtime-built-in-tools-skills)

Explore OpenMAIC agent runtime tools and skills. Discover nine categories including generation, audio, and UI utilities to enhance your agent's capabilities.

- Tags: how-to-guide
- Published: 2026-09-06

### [How OpenMAIC Ensures Tool Integrity in the Agent Runtime: A Technical Deep Dive](/THU-MAIC/OpenMAIC/openmaic-agent-runtime-tool-integrity)

OpenMAIC ensures tool integrity at agent runtime using orphan detection, interrupted result synthesis, and contiguity repair for reliable LLM interactions. Discover the technical details.

- Tags: deep-dive
- Published: 2026-09-06

### [How the OpenMAIC Agent Runtime Handles Event Replay for Session History](/THU-MAIC/OpenMAIC/openmaic-agent-runtime-event-replay)

Learn how the OpenMAIC agent runtime replays session history by reading immutable PostgreSQL events, compacting no-ops, and folding them into session state using monotonic seq ordering.

- Tags: internals
- Published: 2026-09-06

### [How OpenMAIC Achieves Crash Recovery and Cancellation for Agent Sessions](/THU-MAIC/OpenMAIC/openmaic-agent-runtime-crash-recovery-cancellation)

OpenMAIC ensures agent session crash recovery and cancellation using persistent event streams, periodic reconciliation, and stream-health monitoring. Learn how OpenMAIC guarantees reliable agent sessions.

- Tags: internals
- Published: 2026-09-06

### [How OpenMAIC Handles Lease Coordination for Session Claims in the Agent Runtime](/THU-MAIC/OpenMAIC/openmaic-agent-runtime-lease-coordination)

Learn how OpenMAIC ensures exclusive session access with its token-based lease coordination mechanism. Discover how it validates leases and handles interruptions for robust agent runtime operations.

- Tags: internals
- Published: 2026-09-06

### [Agent Runtime in OpenMAIC's Pro Workbench: Core Execution Engine Explained](/THU-MAIC/OpenMAIC/openmaic-agent-runtime-pro-workbench)

Discover the agent runtime, OpenMAIC Pro workbench's core execution engine. Understand its role in AI capabilities, session orchestration, LLM invocation, and state synchronization.

- Tags: internals
- Published: 2026-09-06

### [How PBL Scenes Are Handled in the OpenMAIC Generation Pipeline](/THU-MAIC/OpenMAIC/openmaic-pbl-scenes-generation-pipeline)

Discover how OpenMAIC handles PBL scenes in its generation pipeline. Learn about design-time planning and runtime hydration for efficient project creation and learner state management.

- Tags: internals
- Published: 2026-09-06

### [How Does the `generateSceneActions` Function Work in OpenMAIC?](/THU-MAIC/OpenMAIC/openmaic-generatesceneactions-function)

Discover how OpenMAIC's generateSceneActions function transforms scenes into interactive actions. Learn about its LLM pipeline, retry logic, and validation.

- Tags: deep-dive
- Published: 2026-09-06

### [How the `generateSceneContent` Function Works in OpenMAIC: Deep Dive into Lesson Content Generation](/THU-MAIC/OpenMAIC/openmaic-generatescenecontent-function)

Explore the `generateSceneContent` function in OpenMAIC. This deep dive reveals how it dispatches scene outlines to specialized generators for slides, quizzes, widgets, and PBL lessons via a single async API.

- Tags: deep-dive
- Published: 2026-09-06

### [OpenMAIC Two-Stage Pipeline for Content Generation: From Outline to Interactive Lessons](/THU-MAIC/OpenMAIC/openmaic-content-generation-two-stage-pipeline)

Discover OpenMAIC's two stage pipeline for content generation. Transform raw materials into interactive lessons, starting with an outline and ending with rich multimedia scenes.

- Tags: how-to-guide
- Published: 2026-09-06

### [How to Configure Indirect Egress for Assets in OpenMAIC Production Deployments](/THU-MAIC/OpenMAIC/openmaic-configure-indirect-asset-egress)

Learn to configure indirect egress for assets in OpenMAIC production deployments. Optimize performance by setting ASSET_BYTE_EGRESS to redirect and following best practices for signed URLs.

- Tags: how-to-guide
- Published: 2026-09-06

### [OpenMAIC Production Asset Management Settings: Configuring Asset Collection Intervals and Storage Backends](/THU-MAIC/OpenMAIC/openmaic-production-asset-management-settings)

Configure OpenMAIC production asset management settings like ASSET_COLLECTION_INTERVAL_MS and storage backends. Optimize your asset collection frequency and storage solutions with environment variables.

- Tags: how-to-guide
- Published: 2026-09-06

### [How OpenMAIC Synchronizes Workbench Views in Server-Backed Deployments](/THU-MAIC/OpenMAIC/openmaic-workbench-sync-server-backed)

Discover how OpenMAIC synchronizes workbench views using its three-layer architecture. Learn about real-time updates and state persistence in server-backed deployments. Maximize your team's collaboration now.

- Tags: internals
- Published: 2026-09-06

### [How Server‑Backed Deployment in OpenMAIC Handles Persistence](/THU-MAIC/OpenMAIC/openmaic-server-backed-persistence)

Discover how OpenMAIC server-backed deployment ensures data persistence using compile-time flags and a central PostgreSQL database for reliable storage.

- Tags: how-to-guide
- Published: 2026-09-06

### [How the OpenMAIC Asset Pool Architecture Works with AssetIds and Content Hashes](/THU-MAIC/OpenMAIC/openmaic-asset-pool-architecture)

Explore the OpenMAIC asset pool architecture. Discover how AssetIds and content hashes handle duplicate detection and deduplication in this browser-based IndexedDB system.

- Tags: internals
- Published: 2026-09-06

### [OpenMAIC Storage Layer Primitives: The 7 Core Building Blocks Explained](/THU-MAIC/OpenMAIC/openmaic-storage-primitives)

Discover the 7 core OpenMAIC storage layer primitives including KV store, asset store, and document store. Understand the persistence foundation for higher level APIs.

- Tags: deep-dive
- Published: 2026-09-06

### [OpenMAIC Runtime DSL vs Document DSL: Understanding the Two DSL Line Types](/THU-MAIC/OpenMAIC/openmaic-runtime-vs-document-dsl-line)

Understand the difference between OpenMAIC's runtime DSL and document DSL. Learn how separate versioning ensures safe, phased migrations for session state and document content.

- Tags: deep-dive
- Published: 2026-09-06

### [How OpenMAIC Handles DSL Versioning and Migration: A Deep-Dive Guide](/THU-MAIC/OpenMAIC/openmaic-dsl-versioning-migration)

Learn how OpenMAIC manages DSL versioning and migration with separate persistent and runtime versions. Discover its pure, side-effect-free upgrade transforms for seamless document updates.

- Tags: deep-dive
- Published: 2026-09-06

### [OpenMAIC JSON Schema Artifacts for Non-TypeScript Consumers: Complete Guide](/THU-MAIC/OpenMAIC/openmaic-dsl-json-schema-artifacts)

Explore OpenMAIC JSON Schema artifacts stage.schema.json, scene.schema.json, and action.schema.json. Validate MAIC documents without TypeScript dependencies for any runtime.

- Tags: how-to-guide
- Published: 2026-09-06

### [How OpenMAIC DSL Contract Enforcement Works at Runtime: A Technical Deep Dive](/THU-MAIC/OpenMAIC/openmaic-dsl-contract-runtime-enforcement)

Discover how OpenMAIC DSL contract enforcement works at runtime. Learn about zero-dependency validator functions in the @openmaic/dsl package that ensure data integrity before storage.

- Tags: deep-dive
- Published: 2026-09-06

### [OpenMAIC DSL Contract: The 8 Core Primitives Explained](/THU-MAIC/OpenMAIC/openmaic-dsl-core-primitives)

Discover the 8 core primitives in the OpenMAIC DSL contract: Stage, SceneCore, Action, Slide, QuizContent, AssetMeta, and RuntimeSession. Understand the stage-first data model.

- Tags: deep-dive
- Published: 2026-09-06

### [How OpenMAIC Transforms Documents into Interactive Classroom Experiences: The 6-Step Pipeline Explained](/THU-MAIC/OpenMAIC/how-openmaic-transforms-documents-interactive-classroom)

Discover how OpenMAIC transforms documents into interactive classroom experiences with its 6-step pipeline. Learn to create engaging React-based lessons powered by AI.

- Tags: how-to-guide
- Published: 2026-09-06

### [Complete Guide to the Technologies Used in the OpenMAIC Platform](/THU-MAIC/OpenMAIC/what-technologies-are-used-in-the-openmaic-platform)

Explore the OpenMAIC platform's core technologies including Next.js, React, TypeScript, and LangGraph. Learn about its modular architecture and AI integration.

- Tags: deep-dive
- Published: 2026-09-05

### [How to Customize Agent Behavior with agentConfigOverrides in OpenMAIC](/THU-MAIC/OpenMAIC/how-can-i-customize-agent-behavior-with-agentconfigoverrides-in-openmaic)

Customize agent behavior in OpenMAIC using agentConfigOverrides. Override name, persona, voice, and actions to persist custom configurations for runtime materialization.

- Tags: how-to-guide
- Published: 2026-09-05

### [Understanding entry-tree-storage.ts in OpenMAIC: The Agent Session State Manager](/THU-MAIC/OpenMAIC/what-is-the-role-of-entry-tree-storage-ts-in-openmaic)

Discover how entry-tree-storage.ts in OpenMAIC manages agent conversation state using a hierarchical tree. Learn to persist, retrieve, and maintain session data effectively.

- Tags: internals
- Published: 2026-09-05

### [How OpenMAIC Handles Crash Recovery for Agent Sessions](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-crash-recovery-for-agent-sessions)

Discover how OpenMAIC ensures agent session continuity with robust crash recovery. Learn about its three-stage pipeline: detection, event emission, and client-side repair.

- Tags: how-to-guide
- Published: 2026-09-05

### [How to Integrate Custom Storage Solutions with OpenMAIC: A Complete Guide](/THU-MAIC/OpenMAIC/can-i-integrate-custom-storage-solutions-with-openmaic)

Integrate custom storage with OpenMAIC easily. Implement the StorageProvider interface and register your solution to leverage flexible, personalized data management. Learn how now.

- Tags: how-to-guide
- Published: 2026-09-05

### [What Are the Supported Speech and Whiteboard Actions in OpenMAIC?](/THU-MAIC/OpenMAIC/what-are-the-supported-speech-and-whiteboard-actions-in-openmaic)

Explore supported speech and whiteboard actions in OpenMAIC. Discover how JSON-serializable speech and vector-based whiteboard primitives enable synchronized multimedia playback and real-time collaboration.

- Tags: api-reference
- Published: 2026-09-05

### [How the `play_video` Action Works in OpenMAIC: A Technical Deep Dive](/THU-MAIC/OpenMAIC/how-does-the-play_video-action-work-in-openmaic)

Explore OpenMAIC's play_video action. Learn how generative AI triggers video playback via JSON commands, updating a Zustand store for reactive UI rendering of HTML5 video.

- Tags: deep-dive
- Published: 2026-09-05

### [Which OpenMAIC Action Types Block Until Completion? Complete Technical Guide](/THU-MAIC/OpenMAIC/which-action-types-in-openmaic-block-until-completion)

Discover which OpenMAIC action types block until completion. This guide details the 19 synchronous actions in OpenMAIC, including speech synthesis, video playback, and more.

- Tags: deep-dive
- Published: 2026-09-05

### [OpenMAIC Fire-and-Forget Action Types: Spotlight and Laser Effects Explained](/THU-MAIC/OpenMAIC/what-are-the-fire-and-forget-action-types-supported-by-openmaics-actionengine)

Explore OpenMAIC's fire-and-forget action types spotlight and laser. Trigger visual effects without blocking playback in your presentations.

- Tags: deep-dive
- Published: 2026-09-05

### [ActionEngine Unified Execution Layer in OpenMAIC: Technical Deep Dive](/THU-MAIC/OpenMAIC/what-is-the-unified-execution-layer-provided-by-the-actionengine-in-openmaic)

Explore the ActionEngine unified execution layer in OpenMAIC. Discover how it streamlines agent actions for live streaming and offline playback, offering a single entry point for enhanced efficiency.

- Tags: deep-dive
- Published: 2026-09-05

### [How `engine.jumpToAction()` Enables Random-Access Navigation in the OpenMAIC Playback Engine](/THU-MAIC/OpenMAIC/what-does-engine-jumptoaction-do-in-the-openmaic-playback-engine)

Discover how engine.jumpToAction() in OpenMAIC enables random-access navigation. Jump to specific actions and resume playback while safely rebuilding visual state.

- Tags: internals
- Published: 2026-09-05

### [How OpenMAIC Works Around Browser TTS Audio Bugs: Chrome Speech Synthesis Fixes](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-browser-tts-workarounds-for-audio-bugs)

OpenMAIC fixes Chrome TTS audio bugs by canceling utterances and syncing results, preventing desynchronization. Learn how this speech synthesis workaround works.

- Tags: how-to-guide
- Published: 2026-09-05

### [Understanding the OpenMAIC Playback Engine State Machine: Four Core Modes Explained](/THU-MAIC/OpenMAIC/what-are-the-different-states-in-the-openmaic-playback-engine-state-machine)

Explore the OpenMAIC playback engine state machine and its four core modes: idle, playing, paused, and live. Understand how these states manage lecture playback and live discussion.

- Tags: internals
- Published: 2026-09-05

### [How the OpenMAIC Playback Engine Works as a State Machine: A Deep Dive into the Core Architecture](/THU-MAIC/OpenMAIC/how-does-the-openmaic-playback-engine-work-as-a-state-machine)

Explore the OpenMAIC playback engine's state machine architecture. Understand its four core modes idle playing paused and live managing lecture playback discussions and interrupts via guarded async transitions.

- Tags: deep-dive
- Published: 2026-09-05

### [Understanding the Role of `buildDirectorPrompt` and `parseDirectorDecision` in OpenMAIC](/THU-MAIC/OpenMAIC/what-is-the-role-of-builddirectorprompt-and-parsedirectordecision-in-openmaic)

Explore how buildDirectorPrompt and parseDirectorDecision in OpenMAIC control the Director agent, an LLM-based system that dynamically routes conversations and manages agent turns for efficient AI interaction.

- Tags: deep-dive
- Published: 2026-09-05

### [How OpenMAIC Handles Multi-Turn Discussions With Its Director Graph](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-multi-turn-discussions-with-its-director-graph)

Discover how OpenMAIC manages multi-turn discussions using its Director Graph. Learn how stateless, single-round execution enables clients to serialize turns efficiently.

- Tags: internals
- Published: 2026-09-05

### [Where to Find the LangGraph StateGraph Implementation in OpenMAIC](/THU-MAIC/OpenMAIC/where-can-i-find-the-langgraph-stategraph-implementation-in-openmaic)

Locate the LangGraph StateGraph implementation in OpenMAIC within director-graph.ts and stateless-generate.ts. Explore graph structure and execution logic.

- Tags: how-to-guide
- Published: 2026-09-05

### [How to Stream Results from the OpenMAIC Orchestration Graph](/THU-MAIC/OpenMAIC/how-can-i-stream-results-from-the-openmaic-orchestration-graph)

Learn how to stream results from the OpenMAIC orchestration graph by attaching a streaming handler to LangGraph's StateGraph. See real time agent results via WebSocket or SSE.

- Tags: how-to-guide
- Published: 2026-09-05

### [OpenMAIC Agent Execution Events: Complete Guide to Director Graph Event Emission](/THU-MAIC/OpenMAIC/what-events-are-emitted-during-agent-execution-in-the-openmaic-director-graph)

Explore OpenMAIC agent execution events. Understand the seven StatelessEvent types emitted from core nodes for real-time multi-agent orchestration in the director graph.

- Tags: deep-dive
- Published: 2026-09-05

### [How the Director Node Adapts Its Strategy in OpenMAIC Based on Agent Count](/THU-MAIC/OpenMAIC/how-does-the-director-node-adapt-its-strategy-in-openmaic-based-on-agent-count)

Discover how the OpenMAIC director node adapts its strategy based on agent count. Learn how turn budgets, agent lists, and rules change to optimize conversations.

- Tags: internals
- Published: 2026-09-05

### [OrchestratorState Annotation in OpenMAIC: The Complete LangGraph State Schema Guide](/THU-MAIC/OpenMAIC/what-is-the-state-annotation-for-the-orchestratorstate-in-openmaic)

Explore the OrchestratorState annotation in OpenMAIC. Understand how LangGraph's Annotation.Root creates a type-safe state schema for multi-agent orchestration, separating inputs from mutable node updates.

- Tags: api-reference
- Published: 2026-09-05

### [How OpenMAIC Uses LangGraph for Multi-Agent Orchestration: A Deep Dive into Stateless StateGraph Design](/THU-MAIC/OpenMAIC/how-does-openmaic-use-langgraph-for-multi-agent-orchestration)

Discover how OpenMAIC leverages LangGraph's StateGraph for efficient multi-agent orchestration. Learn about its stateless design and event streaming for deterministic workflows.

- Tags: deep-dive
- Published: 2026-09-05

### [OpenMAIC Research Paper Title and Academic Citation Guide](/THU-MAIC/OpenMAIC/research-paper-associated-openmaic)

Discover the research paper behind OpenMAIC, titled "From MOOC to MAIC: Reimagine Online Teaching and Learning through LLM-driven Agents." Learn how LLM agents are transforming online education.

- Tags: academic-paper
- Published: 2026-09-04

### [OpenMAIC License: Understanding the MIT Licensing and Usage Terms](/THU-MAIC/OpenMAIC/licensing-openmaic-project)

Explore the OpenMAIC License details. Understand MIT licensing for free commercial use, modification, and distribution of the core codebase. Review terms now.

- Tags: licensing
- Published: 2026-09-04

### [OpenMAIC LLM Backends: Complete Supported Provider Guide](/THU-MAIC/OpenMAIC/llm-backends-supported-openmaic)

Explore OpenMAIC LLM backends including OpenAI, Claude, Gemini, Bedrock, and more. Discover compatible providers like DeepSeek and Qwen for seamless integration.

- Tags: api-reference
- Published: 2026-09-04

### [OpenMAIC StorageProvider Interface: A Backend-Agnostic Contract for Asset Persistence](/THU-MAIC/OpenMAIC/storageprovider-interface-openmaic-persistence)

Explore OpenMAIC's StorageProvider interface, a backend-agnostic contract for asset persistence. Learn how put, resolve, and remove methods enable stable references across diverse storage solutions like IndexedDB and cloud CDNs.

- Tags: api-reference
- Published: 2026-09-04

### [How OpenMAIC Handles Document Validation and Migration Using Zod Validators](/THU-MAIC/OpenMAIC/document-validation-migration-openmaic-zod)

OpenMAIC ensures data integrity during document validation and migration using Zod. Discover how its write-time validation and lazy migration pipeline safely convert legacy data to the current DSL schema.

- Tags: how-to-guide
- Published: 2026-09-04

### [Complete Guide to OpenMAIC Playback Action Types: 28+ Presentation Control Commands Defined in action.ts](/THU-MAIC/OpenMAIC/openmaic-action-types-playback)

Explore over 28 OpenMAIC playback action types in action.ts for AI presentation control. Master commands for visuals, audio, and interactivity.

- Tags: api-reference
- Published: 2026-09-04

### [How the OpenMAIC VoiceDesign Interface Ensures Agent Voices Travel with Exported Courses](/THU-MAIC/OpenMAIC/voicedesign-agent-voice-travel-exported-course)

Learn how OpenMAIC's VoiceDesign interface keeps agent voices with exported courses by serializing and re-hydrating voice configuration metadata. Seamlessly transfer your voiceovers.

- Tags: internals
- Published: 2026-09-04

### [OpenMAIC VoiceDesign Interface: A Provider-Neutral Vocal Descriptor for Document Contracts](/THU-MAIC/OpenMAIC/voicedesign-interface-openmaic-document-contract)

Explore OpenMAIC VoiceDesign interface, a provider-neutral vocal descriptor embedding voice identity and delivery into document contracts for portable, cross-device voice configuration without vendor lock-in.

- Tags: deep-dive
- Published: 2026-09-04

### [How to Extend Widget Payloads and Action Sets Using Scene's Generic Parameters in OpenMAIC](/THU-MAIC/OpenMAIC/extending-widget-payloads-action-sets-openmaic-dsl)

Learn how to extend OpenMAIC widget payloads and action sets using Scene's generic parameters. Augment content contracts and playback actions type-safely without modifying core code.

- Tags: how-to-guide
- Published: 2026-09-04

### [OpenMAIC DSL SlideContent Type Structure: A Complete Guide](/THU-MAIC/OpenMAIC/slidecontent-type-structure-openmaic-dsl)

Discover the SlideContent type structure in the OpenMAIC DSL. Learn how it represents slides with PPTCanvas drawings, background metadata, and version tracking.

- Tags: deep-dive
- Published: 2026-09-04

### [OpenMAIC Course DSL Scene Types: The 6 Core Variants Explained](/THU-MAIC/OpenMAIC/scene-types-openmaic-course-dsl)

Explore the 6 core Scene types in OpenMAIC's Course DSL: text, image, audio, video, quiz, and slide. Learn how OpenMAIC structures course content with these essential variants.

- Tags: deep-dive
- Published: 2026-09-04

### [How the Course DSL in OpenMAIC Defines Lesson Data Structure: A Complete Technical Guide](/THU-MAIC/OpenMAIC/course-dsl-lesson-data-structure-openmaic)

Discover how the Course DSL in OpenMAIC defines lesson data structure with typed CourseDocument, stages, outlines, scenes, and version-aware validation. A complete technical guide.

- Tags: deep-dive
- Published: 2026-09-04

### [What Is the `@openmaic/dsl` Package in OpenMAIC?](/THU-MAIC/OpenMAIC/openmaic-dsl-package-role)

Discover the @openmaic/dsl package, the zero-dependency contract keystone of OpenMAIC. Learn about its pure TypeScript types, validators, and normalizers for slide data structures.

- Tags: api-reference
- Published: 2026-09-04

### [How Agent Configuration Overrides Are Applied to OpenMAIC's Initial State](/THU-MAIC/OpenMAIC/agent-configuration-overrides-openmaic-initial-state)

Learn how OpenMAIC applies agent configuration overrides to the initial state. Discover the merge order of defaults environment variables and request overrides for precise control.

- Tags: internals
- Published: 2026-09-04

### [Understanding the `buildInitialState` Function in OpenMAIC Orchestration](/THU-MAIC/OpenMAIC/purpose-buildinitialstate-function-openmaic-orchestration)

Discover how OpenMAIC's buildInitialState function creates the initial state for LangGraph orchestration, converting client requests into execution contexts with messages, config, and models.

- Tags: internals
- Published: 2026-09-04

### [How the LangGraph StateGraph is Constructed in OpenMAIC's Director Graph](/THU-MAIC/OpenMAIC/langgraph-stategraph-construction-openmaic-director-graph)

Discover how OpenMAIC builds its LangGraph StateGraph for multi-agent conversations. Learn about typed states, pure-function nodes, and conditional edges in director graph construction.

- Tags: internals
- Published: 2026-09-04

### [OpenMAIC Orchestration and Director Graph Implementation: Key Files Explained](/THU-MAIC/OpenMAIC/key-files-openmaic-orchestration-director-graph)

Explore OpenMAIC orchestration and director graph implementation. Understand key files like director-graph.ts and prompt-builder.ts to manage multi-agent systems effectively.

- Tags: internals
- Published: 2026-09-04

### [How OpenMAIC Records and Replays Whiteboard Actions for Cross-Turn Consistency](/THU-MAIC/OpenMAIC/whiteboard-action-recording-replay-consistency-openmaic)

OpenMAIC records whiteboard actions as immutable objects with sequence numbers, storing and replaying them to ensure consistent visual states across agent turns. Learn how this ensures cross-turn consistency.

- Tags: internals
- Published: 2026-09-04

### [How OpenMAIC Implements Defensive Action Filtering to Ensure Scene-Appropriateness](/THU-MAIC/OpenMAIC/openmaic-defensive-action-filtering-scene-appropriateness)

Discover how OpenMAIC implements defensive action filtering to ensure scene-appropriateness. Learn about its multi-layered pipeline for validating and securing AI-generated scene modifications.

- Tags: how-to-guide
- Published: 2026-09-04

### [Handling Interleaved Structured JSON Actions and Freeform Text in OpenMAIC's Stateless Generate Process](/THU-MAIC/OpenMAIC/handling-interleaved-json-actions-and-text-openmaic)

OpenMAIC's stateless generate process handles interleaved JSON actions and freeform text via a streaming parser. Learn how it extracts complete items and preserves order.

- Tags: deep-dive
- Published: 2026-09-04

### [How LangGraph's Custom Stream Mode Powers Real-Time SSE Delivery in OpenMAIC](/THU-MAIC/OpenMAIC/langgraph-custom-stream-mode-openmaic-sse)

Discover how LangGraph's custom stream mode empowers OpenMAIC to deliver real-time SSE updates from graph nodes, enhancing AI interaction delivery.

- Tags: deep-dive
- Published: 2026-09-04

### [How the Director Node Adapts Its Strategy Based on Agent Count in OpenMAIC](/THU-MAIC/OpenMAIC/director-node-strategy-adaptation-agent-count)

Discover how the OpenMAIC director node intelligently adapts its strategy by adjusting maxAgentTurns based on agent count, optimizing dialogue pacing and preventing early termination for smoother operation.

- Tags: internals
- Published: 2026-09-04

### [Understanding Director Graph Topology in OpenMAIC: Single vs. Multi-Agent Orchestration](/THU-MAIC/OpenMAIC/director-graph-topology-openmaic-single-vs-multi-agent)

Explore OpenMAIC's director graph topology. Learn how it orchestrates single-agent linear chains and multi-agent parallel collaboration for unified output.

- Tags: deep-dive
- Published: 2026-09-04

### [What Store Types Are Available in the OpenMAIC Persistence Layer?](/THU-MAIC/OpenMAIC/what-are-the-different-store-types-in-openmaic-persistence-layer)

Explore the OpenMAIC persistence layer's store types: InMemoryStore, IndexedDBStore, and ServerStore. Discover how they manage data efficiently for your projects.

- Tags: api-reference
- Published: 2026-09-03

### [Where to Find Animation Timing Constants in OpenMAIC's Action Engine](/THU-MAIC/OpenMAIC/where-can-i-find-animation-timing-constants-for-openmaic-action-engine)

Discover where OpenMAIC's Action Engine stores animation timing constants. Find all animation timing constants in configs/animation.ts for default durations and triggers.

- Tags: api-reference
- Published: 2026-09-03

### [How the OpenMAIC Action Engine Handles Synchronous Speech Actions](/THU-MAIC/OpenMAIC/how-action-engine-handles-synchronous-actions-like-speech)

Discover how the OpenMAIC Action Engine manages synchronous speech actions by returning Promises that resolve after audio playback, ensuring smooth sequential execution.

- Tags: internals
- Published: 2026-09-03

### [OpenMAIC Action Engine Action Categories: Fire-and-Forget vs Synchronous](/THU-MAIC/OpenMAIC/what-are-the-different-action-categories-in-openmaic-action-engine)

Discover OpenMAIC Action Engine's two action categories: Fire-and-Forget for instant execution and Synchronous for sequential completion. Learn how they streamline your AI playback.

- Tags: internals
- Published: 2026-09-03

### [How to Use the jumpToAction Method in OpenMAIC's Playback Engine](/THU-MAIC/OpenMAIC/how-to-use-jumptoaction-method-in-openmaics-playback-engine)

Master the jumpToAction method in OpenMAIC's Playback Engine. Effortlessly move the playback cursor to any action index without replaying. Learn how to optimize your lecture playback now.

- Tags: how-to-guide
- Published: 2026-09-03

### [OpenMAIC Playback Engine State Machine: The Four Core EngineMode States](/THU-MAIC/OpenMAIC/what-are-the-different-states-in-playback-engine-state-machine)

Explore the OpenMAIC Playback Engine state machine and its four core states idle playing paused and live Understand how these engine modes manage lecture streaming and live discussions

- Tags: internals
- Published: 2026-09-03

### [Where Is the Playback Engine Code Located in OpenMAIC?](/THU-MAIC/OpenMAIC/where-is-the-playback-engine-code-located-in-openmaic)

Find the Playback Engine code in OpenMAIC at lib/playback/engine.ts. Discover how the PlaybackEngine class manages lecture playback and audio synchronization.

- Tags: internals
- Published: 2026-09-03

### [How OpenMAIC Uses partial-json for Incremental Parsing of LLM Output](/THU-MAIC/OpenMAIC/how-does-openmaic-use-partial-json-for-incremental-parsing)

Learn how OpenMAIC uses partial-json for incremental parsing of LLM output. Extract valid JSON from incomplete responses in real-time for efficient processing.

- Tags: how-to-guide
- Published: 2026-09-03

### [OpenMAIC Streaming Interface Event Types: Complete SSE Reference Guide](/THU-MAIC/OpenMAIC/what-event-types-are-emitted-by-openmaics-streaming-interface)

Explore OpenMAIC's 25 distinct Server-Sent Events (SSE) covering host lifecycle signals, compatibility frames, and Pi-AI runtime messages. Get the complete SSE reference.

- Tags: api-reference
- Published: 2026-09-03

### [How the Director Node Makes Routing Decisions in OpenMAIC](/THU-MAIC/OpenMAIC/what-logic-does-director-node-use-for-routing-decisions-in-openmaic)

Discover how the OpenMAIC Director Node makes routing decisions using nine explicit rules and runtime limits to manage multi-agent conversations, prevent loops, and avoid redundancy.

- Tags: internals
- Published: 2026-09-03

### [How OrchestratorState Is Defined in OpenMAIC's LangGraph Implementation](/THU-MAIC/OpenMAIC/how-is-orchestratorstate-defined-in-openmaics-langgraph-implementation)

Discover how OpenMAIC defines OrchestratorState using LangGraph's Annotation.Root API to manage immutable inputs and mutable conversation state in multi-agent orchestration.

- Tags: internals
- Published: 2026-09-03

### [Where Are the Core Files for the LangGraph Architecture Located in OpenMAIC?](/THU-MAIC/OpenMAIC/where-are-the-core-files-for-langgraph-architecture-in-openmaic)

Discover where LangGraph architecture files reside in OpenMAIC. Find the main entry point director-graph.ts within the lib/orchestration/ directory and understand its role in state machine construction.

- Tags: internals
- Published: 2026-09-03

### [How LangGraph Powers Multi‑Agent Orchestration in OpenMAIC](/THU-MAIC/OpenMAIC/what-is-the-role-of-langgraph-in-openmaics-multi-agent-orchestration)

Discover how LangGraph powers multi-agent orchestration in OpenMAIC. Learn how its stateful graph engine coordinates AI agent conversations for seamless request routing and streaming responses.

- Tags: how-to-guide
- Published: 2026-09-03

### [How OpenMAIC Implements Generation Retry Logic: A Code-Deep Analysis](/THU-MAIC/OpenMAIC/how-is-generation-retry-logic-implemented-in-openmaic)

Explore OpenMAIC's generation retry logic implementation. Discover how a centralized helper uses exponential back-off and intelligent error handling for robust async operations.

- Tags: deep-dive
- Published: 2026-09-03

### [How AICallFn Enables Provider Neutrality in OpenMAIC Generation](/THU-MAIC/OpenMAIC/how-aicallfn-abstraction-enables-provider-neutrality-in-openmaic-generation)

Learn how AICallFn provides provider neutrality in OpenMAIC generation. Effortlessly switch between AI providers like OpenAI and Anthropic without code changes.

- Tags: deep-dive
- Published: 2026-09-03

### [Where to Find the Scene Content Generation Code in OpenMAIC: Complete Architecture Guide](/THU-MAIC/OpenMAIC/where-can-i-find-the-code-for-scene-content-generation-in-openmaic)

Locate the scene content generation code in OpenMAIC at app/api/generate/scene-content/route.ts. This guide details the architecture and LLM processing for scene generation.

- Tags: architecture
- Published: 2026-09-03

### [How OpenMAIC Generates and Uses SceneOutline Objects in Its Two-Stage Pipeline](/THU-MAIC/OpenMAIC/how-are-sceneoutline-objects-generated-and-used-in-openmaic)

Discover how OpenMAIC generates SceneOutline objects using an LLM pipeline to create structured course blueprints and drive content generation. Learn about its two-stage process.

- Tags: internals
- Published: 2026-09-03

### [Understanding the UserRequirements Structure for Outline Generation in OpenMAIC](/THU-MAIC/OpenMAIC/what-is-the-structure-of-userrequirements-for-outline-generation)

Explore the UserRequirements structure in OpenMAIC for outline generation. Understand the `requirement` field and optional parameters like `userNickname` and `webSearch` to customize AI educational outlines.

- Tags: internals
- Published: 2026-09-03

### [OpenMAIC Outline Generation Entry Point: Where It Starts and How It Works](/THU-MAIC/OpenMAIC/where-is-the-entry-point-for-outline-generation-in-openmaic)

Discover the OpenMAIC outline generation entry point. Learn how the generateOutlineTool function in curriculum-tools.ts orchestrates the outline creation workflow for your agent.

- Tags: internals
- Published: 2026-09-03

### [How OpenMAIC Handles Structured Output Parsing for Streaming LLM Responses](/THU-MAIC/OpenMAIC/how-structured-output-parsing-works-in-openmaic-for-streaming-data)

Discover how OpenMAIC handles structured output parsing for streaming LLM responses. Learn about its four-stage pipeline from raw chunks to LangGraph injection.

- Tags: deep-dive
- Published: 2026-09-03

### [How OpenMAIC Implements Durable Sessions with PostgreSQL](/THU-MAIC/OpenMAIC/how-openmaic-handles-durable-sessions-with-postgresql)

OpenMAIC ensures durable sessions with PostgreSQL by persisting classroom state to atomic CRUD operations across runtime_sessions and runtime_records tables, guaranteeing ACID compliance and survival after server restarts.

- Tags: how-to-guide
- Published: 2026-09-03

### [How to Set Up PostgreSQL Persistence for OpenMAIC: A Complete Docker Guide](/THU-MAIC/OpenMAIC/how-to-set-up-postgresql-persistence-for-openmaic)

Set up PostgreSQL persistence for OpenMAIC with this Docker guide. Configure your DATABASE_URL, build flags, and launch the server-persistence profile for reliable data storage.

- Tags: how-to-guide
- Published: 2026-09-03

### [How to Integrate Custom TTS or ASR Providers with OpenMAIC](/THU-MAIC/OpenMAIC/how-to-integrate-custom-tts-or-asr-providers-with-openmaic)

Learn how to integrate custom TTS or ASR providers with OpenMAIC using its flexible prefix-based system. Centralize configuration and manage providers easily.

- Tags: how-to-guide
- Published: 2026-09-03

### [How to Configure Different LLM Providers in OpenMAIC: A Complete Environment-Based Guide](/THU-MAIC/OpenMAIC/how-to-configure-different-llm-providers-in-openmaic)

Easily configure various LLM providers in OpenMAIC using environment variables. This guide simplifies setup and integration for a seamless AI experience.

- Tags: how-to-guide
- Published: 2026-09-03

### [How the Multi-Agent Discussion API with SSE Streaming Works in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-api-multi-agent-discussion-sse)

Explore the OpenMAIC multi-agent discussion API and learn how SSE streaming delivers real-time LLM tokens, tool calls, and state patches for autonomous agents.

- Tags: how-to-guide
- Published: 2026-09-02

### [How to Trigger the Scene Generation Pipeline via the OpenMAIC API](/THU-MAIC/OpenMAIC/openmaic-api-scene-generation-pipeline)

Trigger the OpenMAIC scene generation pipeline using the API. Send an authenticated POST request to /api/v1/scenes with your course or session ID and instruction.

- Tags: how-to-guide
- Published: 2026-09-02

### [OpenMAIC Durable Session API Endpoints: Complete Reference](/THU-MAIC/OpenMAIC/openmaic-api-durable-sessions-management)

Explore the nine OpenMAIC durable session API endpoints for complete agent session management. Create monitor steer cancel resume and stream events in real time.

- Tags: api-reference
- Published: 2026-09-02

### [How to Export OpenMAIC Content to PPTX and HTML Using `lib/export`](/THU-MAIC/OpenMAIC/openmaic-export-pptx-html)

Easily export OpenMAIC content to PPTX and HTML using the lib/export module. Generate editable PowerPoint decks and interactive HTML packages from your classroom scenes.

- Tags: how-to-guide
- Published: 2026-09-02

### [OpenMAIC lib/media Image and Video Generation Providers: Complete 2024 Guide](/THU-MAIC/OpenMAIC/openmaic-image-video-generation-providers)

Explore OpenMAIC lib/media's supported image and video generation providers in this 2024 guide. Discover 11 image and 3 video providers with a unified adapter architecture.

- Tags: guide
- Published: 2026-09-02

### [OpenMAIC Audio Providers: Complete Guide to TTS and ASR Integrations in lib/audio](/THU-MAIC/OpenMAIC/openmaic-tts-asr-providers-audio)

Explore OpenMAIC's lib/audio for TTS and ASR integrations. Discover 10 TTS and 7 ASR providers including OpenAI, Azure, Qwen, Doubao, and FunASR.

- Tags: complete-guide
- Published: 2026-09-02

### [State Stores in OpenMAIC's lib/store: How Classroom and Agent Data Are Managed](/THU-MAIC/OpenMAIC/openmaic-state-stores-classroom-agents)

Discover how OpenMAIC's lib/store manages classroom and agent data using distinct Zustand stores. Learn about useStageStore for classroom lifecycle and useSettingsStore for agent configuration.

- Tags: internals
- Published: 2026-09-02

### [How to Configure LLM Providers and Model Routing in OpenMAIC's lib/ai](/THU-MAIC/OpenMAIC/openmaic-llm-provider-model-routing)

Learn to configure LLM providers and model routing in OpenMAIC's lib/ai. Edit PROVIDERS registry, extend getCompatThinkingBodyParams, and inject custom configurations for flexible AI integration.

- Tags: how-to-guide
- Published: 2026-09-02

### [How Persistence Is Wired for Browser and Server in OpenMAIC's lib/persistence](/THU-MAIC/OpenMAIC/openmaic-persistence-browser-server-wiring)

Discover how OpenMAIC's lib/persistence wires browser and server for transparent data storage. Learn about HTTP-backed stores and direct PostgreSQL connections.

- Tags: internals
- Published: 2026-09-02

### [OpenMAIC Classroom Interaction Action Types: Complete Guide to lib/action](/THU-MAIC/OpenMAIC/openmaic-action-types-classroom)

Explore OpenMAIC lib/action to discover 22 classroom interaction action types. Master fire-and-forget effects, blocking operations, and widget interactions for your projects.

- Tags: api-reference
- Published: 2026-09-02

### [Classroom Playback State Machine in OpenMAIC: How `lib/playback` Manages Live Interaction](/THU-MAIC/OpenMAIC/openmaic-classroom-playback-state-machine)

Explore the OpenMAIC PlaybackEngine state machine in lib/playback. Discover how idle playing paused and live modes manage seamless lecture playback and live interaction for effective learning.

- Tags: internals
- Published: 2026-09-02

### [How the OpenMAIC Agent-Runtime Handles Leases and Crash Resumes with Server-Backed Durable Sessions](/THU-MAIC/OpenMAIC/openmaic-durable-session-runner-features)

Discover how OpenMAIC's server-backed durable session runner in lib agent-runtime manages PostgreSQL leases, detects failures, and resumes conversations after crashes via transcript replays for reliable agent operation.

- Tags: internals
- Published: 2026-09-02

### [How the Two-Stage Lesson Generation Pipeline Works in OpenMAIC's lib/generation](/THU-MAIC/OpenMAIC/openmaic-lesson-generation-pipeline)

Explore OpenMAIC's two-stage lesson generation pipeline. Discover how it creates structured outlines with LLMs and then generates slide decks, images, audio, and interactive media.

- Tags: internals
- Published: 2026-09-02

### [Agent Tool Interfaces in OpenMAIC: How `tool-schemas.ts` Shapes LLM Action Selection](/THU-MAIC/OpenMAIC/openmaic-agent-tool-interfaces)

Explore agent tool interfaces in OpenMAIC's tool-schemas.ts. Learn how getEffectiveActions and getActionDescriptions filter and describe LLM actions for better system prompts.

- Tags: api-reference
- Published: 2026-09-02

### [How OpenMAIC Implements Multi-Agent Orchestration Using LangGraph](/THU-MAIC/OpenMAIC/openmaic-multi-agent-orchestration-langgraph)

Discover how OpenMAIC implements multi-agent orchestration with LangGraph. Explore its StateGraph architecture featuring a director node for agent selection and response streaming.

- Tags: deep-dive
- Published: 2026-09-02

### [How to Configure Swappable Persistence Backends in @openmaic/storage](/THU-MAIC/OpenMAIC/openmaic-storage-persistence-backends)

Easily configure swappable persistence backends in @openmaic/storage. Implement KVStore and integrate seamlessly with Zustand using BrowserKVStore, HttpKVStore, PgKVStore, or custom solutions.

- Tags: how-to-guide
- Published: 2026-09-02

### [Generation Contracts and Pipeline Definitions in @openmaic/generation: A Complete Reference](/THU-MAIC/OpenMAIC/openmaic-generation-contracts-pipeline)

Explore @openmaic/generation's TypeScript contracts for AI content generation. Learn about retry semantics, result handling, and type-safe data structures for seamless orchestration.

- Tags: api-reference
- Published: 2026-09-02

### [How @openmaic/importer Converts PPTX to OpenMAIC Slides: Complete Pipeline Explained](/THU-MAIC/OpenMAIC/openmaic-importer-pptx-conversion)

Learn how @openmaic/importer converts PPTX to OpenMAIC slides. Explore the 10-stage pipeline that parses PPTX archives, extracts XML, and transforms content into OpenMAIC's native format.

- Tags: how-to-guide
- Published: 2026-09-02

### [Core Functionalities of @openmaic/editor Package: Three-Layer Architecture Explained](/THU-MAIC/OpenMAIC/openmaic-editor-package-functionalities)

Discover the core functionalities of the @openmaic/editor package. Understand its three-layer architecture: core, React, and UI, all powered by a unified transaction system for modular editing.

- Tags: deep-dive
- Published: 2026-09-02

### [How to Use @openmaic/renderer to Render OpenMAIC Slides: A Complete Guide](/THU-MAIC/OpenMAIC/using-openmaic-renderer-to-render-slides)

Learn how to use the @openmaic/renderer component to render OpenMAIC slides. This guide explains transforming Slide JSON objects into responsive canvas renderings with ease.

- Tags: how-to-guide
- Published: 2026-09-02

### [How the @openmaic/dsl Package Defines Course and Slide Data Contracts](/THU-MAIC/OpenMAIC/openmaic-dsl-package-contracts)

Discover how the @openmaic/dsl package uses TypeScript interfaces to define course and slide data contracts, ensuring runtime validation and versioned serialization for educational content.

- Tags: api-reference
- Published: 2026-09-02

### [OpenMAIC Architecture Layers: A Deep Dive into the Modular AI Education Stack](/THU-MAIC/OpenMAIC/openmaic-architecture-layers)

Explore the OpenMAIC architecture layers: Generation Pipeline, Agent Runtime, Storage, Orchestration, Playback, Action, and UI. Understand this modular AI education stack for flexible, interactive experiences.

- Tags: deep-dive
- Published: 2026-09-02

### [How to Set Up the OpenMAIC Monorepo with pnpm Workspaces: A Complete Guide](/THU-MAIC/OpenMAIC/how-to-setup-openmaic-monorepo-pnpm-workspaces)

Learn to set up the OpenMAIC monorepo with pnpm workspaces. Follow this guide to install dependencies, clone the repo, and link packages for seamless development.

- Tags: how-to-guide
- Published: 2026-09-02

### [What Is the OpenMAIC Render-Service Container and How Does It Work?](/THU-MAIC/OpenMAIC/what-is-role-of-render-service-container)

Discover the OpenMAIC render-service container, a micro-service converting Hyperframes projects to MP4 videos with Chromium and FFmpeg. Learn its essential role.

- Tags: how-to-guide
- Published: 2026-09-01

### [OpenMAIC Built-In Skills: Complete Guide to Agent Runtimes and Pedagogical Workflows](/THU-MAIC/OpenMAIC/what-are-the-built-in-skills-available-in-openmaic)

Explore OpenMAIC's 25 built-in skills covering agent runtimes and pedagogical workflows. This guide details core setup, content creation, and SDK extensions for efficient AI agent development.

- Tags: complete-guide
- Published: 2026-09-01

### [How to Configure LLM Providers in OpenMAIC: Environment Variables vs. YAML Setup](/THU-MAIC/OpenMAIC/how-to-configure-llm-providers-in-openmaic)

Configure LLM providers in OpenMAIC using environment variables or YAML. Securely manage API keys on the server for seamless integration with OpenAI-compatible models. Learn how now.

- Tags: how-to-guide
- Published: 2026-09-01

### [How OpenMAIC Handles Multi-Agent Discussions and SSE Streaming: A Deep Dive](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-multi-agent-discussions-sse-streaming)

Discover how OpenMAIC manages multi-agent discussions with its turn-based runtime and streams outputs using SSE. Explore its event handling and SSE streaming capabilities.

- Tags: deep-dive
- Published: 2026-09-01

### [Project-Based Learning (PBL) Endpoints in OpenMAIC: Complete API Reference](/THU-MAIC/OpenMAIC/what-are-project-based-learning-pbl-endpoints-in-openmaic)

Explore OpenMAIC's Project-Based Learning PBL endpoints in this complete API reference. Discover how to manage mutations, simulations, tasks, and evaluations for PBL workflows.

- Tags: api-reference
- Published: 2026-09-01

### [Can OpenMAIC Generate Interactive Simulations? Technical Architecture and Implementation Guide](/THU-MAIC/OpenMAIC/can-openmaic-generate-interactive-simulations)

Discover how OpenMAIC generates interactive simulations. Learn the technical architecture and implementation guide for transforming text outlines into executable physics-based learning components.

- Tags: technical-architecture
- Published: 2026-09-01

### [How Slide Rendering and Editing Works in OpenMAIC: Architecture and Implementation](/THU-MAIC/OpenMAIC/how-does-slide-rendering-and-editing-work-in-openmaic)

Explore OpenMAIC's dual-layer architecture for slide rendering and editing. Learn how SlideCanvas and Canvas manage static previews and interactive states for efficient manipulation.

- Tags: architecture
- Published: 2026-09-01

### [What Is the Purpose of the `@openmaic/dsl` Package? A Deep Architectural Guide](/THU-MAIC/OpenMAIC/what-is-purpose-of-openmaic-dsl-package)

Explore the purpose of the @openmaic/dsl package. Discover its role in defining data contracts, types, validators, and migration tools for the OpenMAIC SDK.

- Tags: deep-dive
- Published: 2026-09-01

### [How to Use Next.js App Router API Routes for OpenMAIC Media Generation](/THU-MAIC/OpenMAIC/how-to-use-nextjs-app-router-api-routes-openmaic)

Learn to use Next.js App Router API routes for OpenMAIC media generation. Access video, image, and TTS features via POST requests and receive typed responses.

- Tags: how-to-guide
- Published: 2026-09-01

### [How OpenMAIC Uses Content Hashes for Secure Asset Storage](/THU-MAIC/OpenMAIC/what-is-security-measure-content-hashes-asset-storage)

Discover how OpenMAIC uses SHA-256 content hashes for secure asset storage, creating a tamper-proof system with immutable identifiers.

- Tags: how-to-guide
- Published: 2026-09-01

### [How OpenMAIC Handles Asset Management in Client-Side Storage](/THU-MAIC/OpenMAIC/how-is-asset-management-handled-in-openmaics-storage)

Discover how OpenMAIC manages client-side asset storage using IndexedDB. Learn about its three-tier architecture for blob storage, metadata tracking, and graceful eviction.

- Tags: internals
- Published: 2026-09-01

### [OpenMAIC Persistence Backends: Browser, HTTP, PostgreSQL, and S3 Explained](/THU-MAIC/OpenMAIC/what-are-different-persistence-backends-available)

Explore OpenMAIC persistence backends including Browser, HTTP, PostgreSQL, and S3. Learn how to select and configure your RuntimeStore for efficient data management.

- Tags: deep-dive
- Published: 2026-09-01

### [How Does @openmaic/storage Handle Data Persistence?](/THU-MAIC/OpenMAIC/how-does-openmaic-storage-package-handle-data-persistence)

Discover how @openmaic/storage handles data persistence with its scope-aware key-value abstraction, supporting localStorage, HTTP, and PostgreSQL backends for account and device data.

- Tags: internals
- Published: 2026-09-01

### [OpenMAIC Persistence Stack: Architecture, Configuration, and Deployment Options](/THU-MAIC/OpenMAIC/what-is-openmaic-persistence-stack-and-its-options)

Explore the OpenMAIC persistence stack architecture for flexible data storage. Learn configuration and deployment options including browser, server, or hybrid modes.

- Tags: architecture
- Published: 2026-09-01

### [How to Integrate Custom LLM Providers with OpenMAIC: A Complete Guide](/THU-MAIC/OpenMAIC/how-to-integrate-custom-llm-providers-with-openmaic)

Integrate custom LLM providers with OpenMAIC using its centralized registry. Learn how to add static code definitions or dynamic UI configurations for OpenAI-compatible APIs.

- Tags: how-to-guide
- Published: 2026-09-01

### [Supported Input Formats for Lesson Generation in OpenMAIC](/THU-MAIC/OpenMAIC/what-are-supported-input-formats-for-lesson-generation)

Discover OpenMAIC's supported input formats for lesson generation. Learn how PDFs, Word docs, PPTs, and more are processed to create engaging lessons.

- Tags: api-reference
- Published: 2026-09-01

### [How the OpenMAIC Two-Stage Lesson Generation Pipeline Works](/THU-MAIC/OpenMAIC/how-does-two-stage-lesson-generation-pipeline-work)

Explore the OpenMAIC two stage lesson generation pipeline. Learn how stage-design and slide-craft skills create structured lesson plans and visual slide content.

- Tags: internals
- Published: 2026-09-01

### [What Are the Different Scene Types Generated by OpenMAIC?](/THU-MAIC/OpenMAIC/what-are-the-different-scene-types-generated-by-openmaic)

Discover the four scene types—slide quiz interactive and pbl—generated by OpenMAIC to structure learning content and customize UI behavior for each learning stage.

- Tags: deep-dive
- Published: 2026-09-01

### [How to Extend or Add New Skills to OpenMAIC: A Complete Developer Guide](/THU-MAIC/OpenMAIC/how-to-extend-or-add-new-skills-to-openmaic)

Learn how to extend or add new skills to OpenMAIC. This developer guide details creating skill directories, SKILL.md files, and utilizing API endpoints for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-01

### [Understanding the Role of LangGraph in OpenMAIC: Multi-Agent Orchestration Engine](/THU-MAIC/OpenMAIC/what-is-the-role-of-langgraph-in-openmaic)

Discover how LangGraph powers OpenMAIC as its core orchestration engine. Learn how it manages multi-agent conversations with state-machine workflows for seamless turn-taking and real-time streaming.

- Tags: deep-dive
- Published: 2026-09-01

### [How Multi-Agent Orchestration Works in OpenMAIC](/THU-MAIC/OpenMAIC/how-does-multi-agent-orchestration-work-in-openmaic)

Discover how OpenMAIC orchestrates multi-agent systems using a stateless LangGraph for efficient, serverless agent execution and selection. Learn the architecture today.

- Tags: internals
- Published: 2026-09-01

### [What Are the Core Technologies Used in OpenMAIC? A Full‑Stack AI Classroom Breakdown](/THU-MAIC/OpenMAIC/what-are-the-core-technologies-used-in-openmaic)

Explore the core technologies powering OpenMAIC, a full-stack AI classroom. Discover how React, Next.js, TypeScript, LangGraph, and Vercel AI SDK enable real-time multi-agent orchestration and content generation.

- Tags: deep-dive
- Published: 2026-09-01

### [How to Set Up OpenMAIC Locally for Development: Complete Setup Guide](/THU-MAIC/OpenMAIC/how-to-set-up-openmaic-locally-for-development)

Set up OpenMAIC locally for development. Follow this guide to install Nodejs and pnpm, clone the repository, and configure your env file to start the dev server.

- Tags: how-to-guide
- Published: 2026-09-01

### [Requirements for Running OpenMAIC on a Slow Network or in China](/THU-MAIC/OpenMAIC/requirements-for-running-openmaic-on-slow-network-or-in-china)

Run OpenMAIC on slow networks or in China by setting Alpine mirror and npm registry build args. Deploy OpenMAIC with ease in restricted environments.

- Tags: how-to-guide
- Published: 2026-08-31

### [How to Integrate Custom LLM Providers in OpenMAIC: A Complete Developer Guide](/THU-MAIC/OpenMAIC/how-to-integrate-custom-llm-providers-not-listed-in-openmaic)

Learn to integrate custom LLM providers in OpenMAIC with this developer guide. Explore the unified configuration system and user-defined settings for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-31

### [How to Enable Next.js App Router Features in OpenMAIC](/THU-MAIC/OpenMAIC/how-to-enable-nextjs-app-router-features-in-openmaic)

Learn how to enable Next.js App Router in OpenMAIC by configuring next.config.js. Migrate pages and leverage Server Components for enhanced performance.

- Tags: how-to-guide
- Published: 2026-08-31

### [OpenMAIC Agent Workbench Built-in Skills: Complete Catalog and Developer Guide](/THU-MAIC/OpenMAIC/what-are-the-built-in-skills-for-the-agent-workbench)

Explore the OpenMAIC Agent Workbench's 22 built-in skills for workshop training and vocational development. Discover how to use and extend these skills with our comprehensive guide.

- Tags: developer-guide
- Published: 2026-08-31

### [How OpenMAIC Handles Media Generation: Images, Video, and Provider Architecture](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-media-generation-images-video)

Discover how OpenMAIC generates images and video using a provider-agnostic system, ensuring secure and unified media creation for classroom automation.

- Tags: internals
- Published: 2026-08-31

### [What Environment Variables Are Needed to Run OpenMAIC: Complete Configuration Guide](/THU-MAIC/OpenMAIC/what-environment-variables-are-needed-to-run-openmaic)

Discover essential environment variables for OpenMAIC. Learn how to configure your API keys and optional features like image generation for a seamless experience.

- Tags: how-to-guide
- Published: 2026-08-31

### [How to Deploy OpenMAIC with the Video Export Profile: Complete Setup Guide](/THU-MAIC/OpenMAIC/how-to-deploy-openmaic-with-the-video-export-profile)

Easily deploy OpenMAIC with the video export profile. Follow our complete setup guide to enable video export and activate the render service using Docker Compose.

- Tags: how-to-guide
- Published: 2026-08-31

### [What Is the render-service in OpenMAIC? Architecture and API Guide](/THU-MAIC/OpenMAIC/what-is-the-role-of-the-render-service-in-openmaic)

Discover the render-service in OpenMAIC, an isolated microservice that converts Hyperframes archives to MP4 videos, safeguarding the main app from intensive rendering demands.

- Tags: architecture
- Published: 2026-08-31

### [How to Use the React Renderer for OpenMAIC Slide DSL: Complete Implementation Guide](/THU-MAIC/OpenMAIC/how-to-use-the-react-renderer-for-openmaic-slide-dsl)

Learn to use the React renderer for OpenMAIC slide DSL. This guide details implementing `@openmaic/renderer` to convert JSON DSL into interactive React components with SlideCanvas.

- Tags: how-to-guide
- Published: 2026-08-31

### [What Is the Purpose of the @openmaic/dsl Package? Understanding OpenMAIC's Contract Foundation](/THU-MAIC/OpenMAIC/what-is-the-purpose-of-the-openmaic-dsl-package)

Explore the purpose of the @openmaic/dsl package. Discover its role in providing TypeScript definitions, runtime validation, and schema migration for a consistent OpenMAIC data language.

- Tags: deep-dive
- Published: 2026-08-31

### [How to Configure S3 Asset Storage for OpenMAIC Deployments](/THU-MAIC/OpenMAIC/how-to-configure-s3-asset-storage-for-openmaic-deployments)

Configure S3 asset storage for OpenMAIC deployments by setting the ASSET_S3_BUCKET environment variable. Persist assets to Amazon S3 without code changes.

- Tags: how-to-guide
- Published: 2026-08-31

### [How Asset Collection Works in OpenMAIC with PostgreSQL Persistence](/THU-MAIC/OpenMAIC/how-does-asset-collection-work-in-openmaic-with-postgresql-persistence)

Discover how OpenMAIC asset collection with PostgreSQL persistence automatically deletes unreferenced binary blobs using atomic transactions and efficient batching for optimized storage.

- Tags: how-to-guide
- Published: 2026-08-31

### [How to Set Up Server-Backed Persistence with PostgreSQL in OpenMAIC](/THU-MAIC/OpenMAIC/how-to-set-up-server-backed-persistence-with-postgresql-in-openmaic)

Learn to set up server-backed persistence with PostgreSQL in OpenMAIC. Configure a PostgreSQL container and the DATABASE_URL environment variable for seamless data management.

- Tags: how-to-guide
- Published: 2026-08-31

### [How Does OpenMAIC Handle Persistence? Workspace Session Storage Explained](/THU-MAIC/OpenMAIC/how-does-openmaic-handle-persistence-and-what-are-the-options)

Discover how OpenMAIC handles persistence with workspace session storage. Explore options for browser storage, custom implementations, or disabling it entirely.

- Tags: internals
- Published: 2026-08-31

### [Prerequisites for Enabling the Pro Workbench and Durable Sessions in OpenMAIC](/THU-MAIC/OpenMAIC/what-are-the-prerequisites-for-enabling-the-pro-workbench-and-durable-sessions)

Learn the essential prerequisites for OpenMAIC Pro workbench and durable sessions. Enable Pro features by setting NEXT_PUBLIC_PRO_WORKBENCH_ENABLED and configuring PostgreSQL.

- Tags: how-to-guide
- Published: 2026-08-31

### [How to Enable and Use the Agent Workbench in OpenMAIC: Complete Setup Guide](/THU-MAIC/OpenMAIC/how-to-enable-and-use-the-agent-workbench-in-openmaic)

Learn how to enable and use the Agent Workbench in OpenMAIC with our complete setup guide. Follow these simple steps to get started.

- Tags: how-to-guide
- Published: 2026-08-31

### [Which TTS and ASR Providers Are Supported by OpenMAIC? A Complete Technical Guide](/THU-MAIC/OpenMAIC/which-tts-and-asr-providers-are-supported-by-openmaic)

Discover the TTS and ASR providers supported by OpenMAIC. Explore integrations with OpenAI, Azure, ElevenLabs, Whisper, and more in this technical guide.

- Tags: technical-guide
- Published: 2026-08-31

### [How to Configure Different LLM Providers for OpenMAIC: A Complete Guide](/THU-MAIC/OpenMAIC/how-to-configure-different-llm-providers-for-openmaic)

Easily configure diverse LLM providers for OpenMAIC. This guide details switching between OpenAI, Anthropic, Google Gemini, and custom endpoints in the settings store.

- Tags: how-to-guide
- Published: 2026-08-31

### [OpenMAIC Action Types: Complete List of the Action Engine's Supported Verbs](/THU-MAIC/OpenMAIC/what-are-the-supported-action-types-in-openmaic-action-engine)

Explore OpenMAIC action types with our complete list of supported verbs. Discover Fire-and-Forget visual effects, blocking operations, and widget interactions.

- Tags: api-reference
- Published: 2026-08-31

### [How the OpenMAIC Playback Engine Manages Classroom States: A Deep Dive into the State Machine](/THU-MAIC/OpenMAIC/how-does-the-openmaic-playback-engine-manage-classroom-states)

Discover how the OpenMAIC playback engine manages classroom states using a finite state machine. Explore idle, playing, paused, and live modes for seamless lecture playback and interactive discussions.

- Tags: deep-dive
- Published: 2026-08-31

### [LangGraph Multi-Agent Orchestration in OpenMAIC: How the Director Graph Coordinates AI Agents](/THU-MAIC/OpenMAIC/what-is-langgraph-and-how-is-it-used-for-multi-agent-orchestration-in-openmaic)

Discover how LangGraph orchestrates multi-agent systems in OpenMAIC. Learn how its StateGraph and Director node enable deterministic coordination and real-time event streaming for AI agents.

- Tags: deep-dive
- Published: 2026-08-31

### [How the Two-Stage Generation Pipeline Works in OpenMAIC](/THU-MAIC/OpenMAIC/how-does-the-two-stage-generation-pipeline-work-in-openmaic)

Discover how OpenMAIC's two-stage generation pipeline transforms raw instructions into interactive classrooms, creating structured lesson outlines and rich scenes with content and actions.

- Tags: internals
- Published: 2026-08-31

### [OpenMAIC Platform Architecture: A Modular Multi-Agent Classroom System](/THU-MAIC/OpenMAIC/what-is-the-architecture-of-the-openmaic-platform)

Explore the OpenMAIC platform architecture, a modular multi-agent system. Discover its provider-neutral design, separating UI from AI orchestration for robust classroom solutions.

- Tags: architecture
- Published: 2026-08-31

### [How to Set Up OpenMAIC Locally Using Docker Compose: A Complete Guide](/THU-MAIC/OpenMAIC/how-to-set-up-openmaic-locally-using-docker-compose)

Easily set up OpenMAIC locally with Docker Compose. Clone the repo, configure your environment, and run a single command to get the web service up and running. Full guide available.

- Tags: how-to-guide
- Published: 2026-08-31

### [How ActionEngine Consumes Scene.actions in the OpenMAIC Playback Engine](/THU-MAIC/OpenMAIC/openmaic-actionengine-consume-scene-actions-playback)

Learn how ActionEngine consumes Scene actions in the OpenMAIC Playback Engine. Discover iteration, delegation, and execution patterns for seamless action management.

- Tags: internals
- Published: 2026-08-30

### [How the Playback Engine Manages the Classroom Lifecycle in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-playback-engine-classroom-lifecycle)

Discover how the OpenMAIC Playback Engine manages the classroom lifecycle using a state machine. Learn about transitions between idle, playing, paused, and live modes for seamless lecture and discussion management.

- Tags: internals
- Published: 2026-08-30

### [How to Achieve Parallel Scene Content Generation in OpenMAIC: A Complete Technical Guide](/THU-MAIC/OpenMAIC/openmaic-parallel-scene-content-generation)

Unlock parallel scene content generation in OpenMAIC. Learn how its three-layer architecture enables simultaneous LLM/image model calls and streams results efficiently.

- Tags: how-to-guide
- Published: 2026-08-30

### [How to Stream Scene Outlines During Generation in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-stream-scene-outlines-generation)

Learn how to stream scene outlines during generation in OpenMAIC. Access real-time outline events via the SSE endpoint at /api/generate/scene-outlines-stream for faster development.

- Tags: how-to-guide
- Published: 2026-08-30

### [How the Two-Stage Generation Pipeline Works in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-two-stage-generation-pipeline-explained)

Explore OpenMAIC's two-stage generation pipeline that transforms educational content into interactive classrooms, creating structured lesson outlines and rich scenes with engaging content.

- Tags: deep-dive
- Published: 2026-08-30

### [How OpenMAIC Generates Lesson Content: The Complete Technical Pipeline](/THU-MAIC/OpenMAIC/openmaic-lesson-content-generation-process)

Explore the OpenMAIC technical pipeline for lesson content generation. Learn how user needs become validated scenes with AI-driven visuals, narration, and checkpoints.

- Tags: deep-dive
- Published: 2026-08-30

### [How to Enable and Configure Thinking Capabilities for LLM Models in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-enable-configure-llm-thinking-capabilities)

Learn how to enable and configure thinking capabilities for LLM models in OpenMAIC. Understand the automatic activation and configuration process using createPartMapper and ThinkingBarState.

- Tags: how-to-guide
- Published: 2026-08-30

### [How to Configure Model Routing for Different Generation Stages in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-configure-model-routing-stages)

Configure model routing for different generation stages in OpenMAIC. Learn to modify provider configs, implement custom middleware, and specify models via client or server settings.

- Tags: how-to-guide
- Published: 2026-08-30

### [How OpenMAIC Abstracts Different LLM Providers Using the Vercel AI SDK: A Technical Deep Dive](/THU-MAIC/OpenMAIC/openmaic-llm-provider-abstraction-vercel-ai-sdk)

Explore how OpenMAIC abstracts LLM providers with Vercel AI SDK. Learn about the adapter layer and unified interface for seamless integration. Technical deep dive.

- Tags: deep-dive
- Published: 2026-08-30

### [How to Integrate Custom LLM Providers with OpenMAIC: A Complete Guide](/THU-MAIC/OpenMAIC/openmaic-integrate-custom-llm-providers)

Integrate custom LLM providers with OpenMAIC easily by registering a config object in localStorage or settings. This guide explains the simple process for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-30

### [Pluggable Persistence in OpenMAIC: Storage Architecture and Backend Options](/THU-MAIC/OpenMAIC/openmaic-pluggable-persistence-options)

Explore OpenMAIC's pluggable persistence architecture. Discover storage primitives and backend options like Browser, HTTP Client, and PostgreSQL for flexible data management.

- Tags: architecture
- Published: 2026-08-30

### [How to Use the OpenMAIC DSL for Defining Contracts](/THU-MAIC/OpenMAIC/openmaic-dsl-usage)

Learn to define contracts with the OpenMAIC DSL. This zero-dependency TypeScript system ensures type-safe definition, migration, normalization, and validation for your OpenMAIC ecosystem documents.

- Tags: how-to-guide
- Published: 2026-08-30

### [OpenMAIC SDK Packages: A Complete Guide to the @openmaic Monorepo](/THU-MAIC/OpenMAIC/openmaic-sdk-packages-overview)

Explore the @openmaic monorepo SDK packages: dsl, generation, renderer, and storage. Build type-safe educational content platforms with multimodal AI and frontend rendering.

- Tags: getting-started
- Published: 2026-08-30

### [How the Durable Agent Runner Works in OpenMAIC: Fault-Tolerant AI Execution Explained](/THU-MAIC/OpenMAIC/openmaic-durable-agent-runner-how-it-works)

Discover how OpenMAICs durable agent runner ensures fault-tolerant AI execution by persisting interactions in PostgreSQL. Resume agents after crashes without data loss.

- Tags: deep-dive
- Published: 2026-08-30

### [Understanding the Generation Pipeline in OpenMAIC: A Two-Stage Architecture](/THU-MAIC/OpenMAIC/openmaic-generation-pipeline-explained)

Explore the OpenMAIC generation pipeline, a two-stage architecture that crafts interactive educational content, from lesson outlines to detailed scenes with text, images, and audio.

- Tags: deep-dive
- Published: 2026-08-30

### [How OpenMAIC Uses LangGraph for Multi-Agent Orchestration: A Deep Dive into the StateGraph Implementation](/THU-MAIC/OpenMAIC/openmaic-langgraph-agent-orchestration)

Discover how OpenMAIC uses LangGraph StateGraph for deterministic agent orchestration. Explore the director node and LLM execution in this deep dive.

- Tags: deep-dive
- Published: 2026-08-30

### [ActionEngine in OpenMAIC: How to Execute and Control Interactive Scenes](/THU-MAIC/OpenMAIC/openmaic-actionengine-usage)

Explore OpenMAIC's ActionEngine, the core runtime for executing interactive scenes. Learn to control auto-play, manual steps, and state persistence for seamless scene navigation.

- Tags: how-to-guide
- Published: 2026-08-30

### [How the Playback State Machine Works in OpenMAIC](/THU-MAIC/OpenMAIC/openmaic-playback-state-machine-how-it-works)

Explore the OpenMAIC playback state machine. Learn how it manages mode transitions, persistent cursors, and UI derivation for classroom session orchestration. Discover its core functionalities in lib/playback.

- Tags: internals
- Published: 2026-08-30

### [What Is the Purpose of lib/ai in OpenMAIC? The Core AI Abstraction Layer Explained](/THU-MAIC/OpenMAIC/openmaic-lib-ai-purpose)

Discover the purpose of lib/ai in OpenMAIC. This core AI abstraction layer unifies LLM operations, manages provider selection, and tracks usage for seamless integration.

- Tags: internals
- Published: 2026-08-30

### [How Core Business Logic Is Organized in OpenMAIC: The Three-Layer `lib/` Architecture](/THU-MAIC/OpenMAIC/openmaic-core-business-logic-organization)

Discover how OpenMAIC organizes core business logic in its three-layer lib/ architecture: Session, Agent, and UI components. Understand its structure for efficient AI development.

- Tags: architecture
- Published: 2026-08-30

### [OpenMAIC API Route Handlers: Complete Directory Guide and Usage Examples](/THU-MAIC/OpenMAIC/openmaic-api-route-handlers-location)

Discover OpenMAIC API route handlers in the app api directory. This guide shows usage examples for each route.ts file mapping to HTTP endpoints via folder path.

- Tags: api-reference
- Published: 2026-08-30

### [How the Next.js Client Interacts with the Backend in OpenMAIC](/THU-MAIC/OpenMAIC/nextjs-client-backend-interaction-openmaic)

Discover how the Next.js client connects with the backend in OpenMAIC. Learn about API routes and server-only handlers that execute business logic and return JSON.

- Tags: how-to-guide
- Published: 2026-08-30

### [Main Layers in OpenMAIC Architecture: A Technical Deep Dive](/THU-MAIC/OpenMAIC/openmaic-architecture-main-layers)

Explore the six main layers of OpenMAIC architecture: Generation Pipeline, Agent Runtime, Persistence Layer, Orchestration, Playback, and Action Engine for provider-neutral, multi-agent classrooms.

- Tags: deep-dive
- Published: 2026-08-30

### [How to Set Up OpenMAIC Project Locally: Complete Installation Guide](/THU-MAIC/OpenMAIC/how-to-setup-openmaic-locally)

Learn how to set up the OpenMAIC project locally with this complete installation guide. Clone the repo, install dependencies, configure env vars, and run pnpm dev to get started.

- Tags: how-to-guide
- Published: 2026-08-30