THU-MAIC/OpenMAIC

OpenMAIC – オープンマルチエージェント対話型教室

概要 – OpenMAICは、あらゆるトピック、文書、または学習教材を、完全な機能を備えたAI駆動の教室に変えることができるオープンソースのウェブプラットフォームです。複数のAIエージェント（教師、クラスメート、ホワイトボードアシスタント、TTS音声など）を調整して、スライド、クイズ、インタラクティブなHTMLシミュレーション、プロジェクトベースの学習アクティビティを生成し、それらをブラウザUIを介してリアルタイムで配信します。

主な機能

• ワンクリックレッスン生成 – 科目を説明するか、ソースファイルをアップロードすると、システムが完全なレッスン（概要、スライドコンテンツ、画像、音声ナレーション、オプションのビデオ）を自動的に構築します。
• マルチエージェント対話 – AIの「教師」と「仲間」が、共有ホワイトボードに話したり描画したり、質問に答えたり、シミュレーションを実行したりできるため、会話型の学習体験が得られます。
• リッチメディア出力 – 編集可能なPowerPoint（.pptx）デッキや自己完結型のインタラクティブHTMLページをエクスポートできます。メディアはPostgreSQLまたはS3に保存できます。
• エージェントワークベンチ統合 – 組み込みのOpenMAIC Skillは、OpenClaw、Codex、DeepSeek、WorkBuddyなどの多くのエージェントフレームワークと連携するため、Feishu、Slack、Telegram、またはIDE内から直接教室を生成できます。
• プラグ可能なモデルプロバイダー – OpenAI、Anthropic、Azure OpenAI、Amazon Bedrock、Gemini、Qwen、MiniMax、Grok、TokenDance、Xiaomi MiMo、Zhipu GLM、Ollama、Lemonade（ローカル）およびOpenAI互換のAPIをサポートします。モデルの使用法は、スロット（概要、スライドテキスト、TTS、ウェブ検索など）を特定のプロバイダーにマップする単純なopenmaic.ymlファイルを介して構成されます。
• サーバーバックアップ永続化 – コース、チャット履歴、生成されたメディア、ユーザーセッションはPostgreSQLに保存されるため、タブを閉じたりサーバーを再起動したりしても生成プロセスは維持されます。
• Dockerまたはローカルでデプロイ可能 – 開発ではpnpmとDockerベースのPostgreSQLを使用します。本番環境では、長期稼働するNode.jsプロセス（Docker Compose）として、または古い1.1.xリリースではVercelのサーバーレスとして実行できます。

典型的なユースケース

シナリオ	OpenMAICの効果
教育者がクラスやワークショップ用の迅速なインタラクティブなレッスンを構築する。	スライド、クイズ、ライブシミュレーションを数分で生成し、PowerPointにエクスポートしてオフラインで使用できます。
企業トレーナーが即席のトレーニングモジュールを必要としている。	製品ドキュメントをアップロードし、AIが音声ナレーションとインタラクティブなデモを備えた構造化コースを作成します。
学生が教科書の章の個人チューターを欲している。	章を説明すると、フォローアップの質問に答えたり、説明を描画したりできるマルチエージェント教室が得られます。
開発者/IDEユーザーがワークフローに学習を組み込みたい。	OpenClawや他のワークベンチでOpenMAIC Skillを使用して、メッセージングチャネルやコードエディタから直接レッスンを起動できます。
研究者がマルチエージェントオーケストレーションを実験している。	オープンソーススタック（Next.js、LangGraph、Tailwind）は完全にアクセス可能で、エージェントの拡張や新しいモダリティの追加が可能です。

クイックスタート（ローカル開発）

# 1. リポジトリをクローン
# git clone https://github.com/THU-MAIC/OpenMAIC.git && cd OpenMAIC

# 2. 依存関係をインストール（pnpm ≥10）
# pnpm install

# 3. 設定を構成
cp .env.example .env.local            # put your API keys here
cp openmaic.example.yml openmaic.yml  # edit model slots if desired
# At minimum you need OPENAI_API_KEY (or another provider key)

# 4. Start a PostgreSQL instance (Docker helper)
# pnpm db:up
# The helper creates a DB at postgres://openmaic:openmaic-dev@127.0.0.1:5432/openmaic

# 5. Run the dev server
# pnpm dev

# Open http://localhost:3000 in a browser and start generating lessons.

本番/Dockerデプロイメント

# Prepare env file with keys
cp .env.example .env.local && nano .env.local

# Build and run both the app and PostgreSQL
# docker compose up --build -d

Composeスタックは2つのコンテナ（アプリ+Postgres）を作成し、データを名前付きボリューム（openmaic-postgres、openmaic-data）に永続化します。マルチユーザーデプロイメントでは、公開前にACCESS_CODEと強力なPERSISTENCE_POSTGRES_PASSWORDを設定します。

詳細情報

• ユーザーガイド – 英語と中国語のガイドはREADMEの上部にリンクされています。
• ドキュメント – 詳細なドキュメントはpackages/docs/content/docs/にあります（構成、サポートされているモデル、デプロイメント、ホスティングなど）。
• ライブデモ – https://open.maic.chat/ でUIの動作を確認できます。
• コミュニティ – DiscordとFeishuのリンクがサポートとディスカッションのために提供されています。

---

OpenMAICは、マルチエージェント教室生成、モデルオーケストレーション、インタラクティブな学習体験に焦点を当てた、本格的で積極的にメンテナンスされているAIプロジェクトです。フロンティアAI/ML分野（LLMオーケストレーション、RAG、マルチモーダル生成、AI駆動の教育）に完全に適合しています。