THU-MAIC/OpenMAIC：READMEの機能と導入時に確認する箇所

ワンクリック教室の売り

OpenMAIC（オープンマルチエージェントインタラクティブ教室）は、トピックやドキュメントを教室体験に変えるオープンソースのAIプラットフォームです。READMEによると、スライド、クイズ、インタラクティブシミュレーション、プロジェクトベース学習アクティビティを生成し、これらはすべて、話したり、ホワイトボードに描いたり、リアルタイムディスカッションに参加できるAI教師とAIクラスメートによって提供されます。リポジトリの説明は「ワンクリックで没入型のマルチエージェント学習体験を」です。プロジェクトはTypeScriptで書かれ、バッジに示されているようにNext.js、React、LangGraph、Tailwind CSSを使用しています。READMEはまた、Journal of Computer Science and Technologyの論文へのリンクを含みますが、その内容はここでは再現されていません。リポジトリメタデータは2万以上のスターと約4千のフォークを示しています。

THU-MAIC/OpenMAICのREADMEにある「ワンクリック教室の売り」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Get an immersiveを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第1節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

THU-MAIC/OpenMAICのREADMEにある「導入時の記録」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Take the full tour inを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第1節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

ローカルセットアップとプロバイダー設定

READMEはクイックスタートパスを提供しています：リポジトリをクローンし、pnpmで依存関係をインストールし、.env.exampleを.env.localにコピーし、少なくとも1つのLLMプロバイダーキーを入力します。サポートされているプロバイダーには、OpenAI、Azure OpenAI、Anthropic、Amazon Bedrock、Google Gemini、DeepSeek、Qwen、Kimi、MiniMax、Grok、OpenRouter、Doubao、Tencent Hunyuan、Xiaomi MiMo、GLM、Ollama、Lemonade、FunASR、およびOpenAI互換APIが含まれます。READMEはまた、server-providers.ymlによる代替設定を示しています。品質と速度のバランスとしてGemini 3 Flashをデフォルトモデルとして推奨していますが、これは推奨であり必須ではありません。開発サーバーを実行するには、READMEはpnpm devを使用し、http://localhost:3000を開くように指示しています。本番ではpnpm build && pnpm startを使用します。Docker Composeのパスもあります。

THU-MAIC/OpenMAICのREADMEにある「ローカルセットアップとプロバイダー設定」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Take the full tour inを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第2節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

THU-MAIC/OpenMAICのREADMEにある「導入時の記録」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。https://github.com/user-attachments/assets/b4ab35ac-f994-46b1-8957-e82fe87ff0e9を使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第2節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

オプションのローカルAIサービス

READMEは、ローカルで実行されるいくつかのオプション統合を説明しています。Lemonadeは、LLM、画像生成、TTS、ASR用のOpenAI互換のローカルプロバイダーで、APIキーは不要です。FunASRは、SenseVoiceSmall、Paraformer、Fun-ASR-NanoをサポートするOpenAI互換サーバーを介してローカル音声認識を提供します。TTSについては、VoxCPM2はOpenBMBのオープンソースモデルで、OpenMAICが接続でき、音声クローニングと自動生成音声を提供します。READMEはまた、高度なドキュメント解析用のMinerUと、Node 22でChromiumとFFmpegを必要とするMP4ビデオエクスポート用のレンダリングサービスにも言及しています。これらはすべてオプションです。基本設定にはLLMキーだけが必要です。

THU-MAIC/OpenMAICのREADMEにある「オプションのローカルAIサービス」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。https://github.com/user-attachments/assets/b4ab35ac-f994-46b1-8957-e82fe87ff0e9を使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第3節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

THU-MAIC/OpenMAICのREADMEにある「導入時の記録」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Get an immersiveを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第3節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

ディープインタラクティブモードと生成パイプライン

READMEは、受動的なリスニングではなく、インタラクティブで探索可能な学習体験を生み出すディープインタラクティブモードを紹介しています。3Dビジュアライゼーション、シミュレーション、ゲーム、マインドマップ、オンラインプログラミングの5種類のインタラクティブUIをリストしています。AI教師はUIを積極的に操作して生徒をガイドし、重要な領域を強調し、条件を設定し、ヒントを提供できます。レッスン生成は2段階のパイプラインに従います：まずAIが入力を分析して構造化されたアウトラインを生成し、次に各アウトライン項目がスライド、クイズ、インタラクティブモジュール、PBLアクティビティなどのシーンになります。READMEはこのパイプラインのベンチマークや品質指標を提供していません。

THU-MAIC/OpenMAICのREADMEにある「ディープインタラクティブモードと生成パイプライン」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Get an immersiveを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第4節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

THU-MAIC/OpenMAICのREADMEにある「導入時の記録」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Take the full tour inを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第4節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

マルチエージェント教室とホワイトボード

教室コンポーネントには、スライド、クイズ、インタラクティブシミュレーション、プロジェクトベース学習が含まれます。スライドには音声ナレーション、スポットライト効果、レーザーポインターアニメーションが付属しています。クイズは単一選択、複数選択、短答をサポートし、リアルタイムAI採点を備えています。マルチエージェントインタラクションには、エージェントがディスカッションを開始してあなたを指名できる教室ディスカッション、異なるペルソナを持つラウンドテーブルディベート、Q&Aモード、エージェントが方程式や図をリアルタイムで描く共有ホワイトボードが含まれます。READMEはまた、テキスト読み上げ、音声認識、ウェブ検索、7言語の国際化、ダークモードにも言及しています。

THU-MAIC/OpenMAICのREADMEにある「マルチエージェント教室とホワイトボード」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Take the full tour inを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第5節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

THU-MAIC/OpenMAICのREADMEにある「導入時の記録」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。https://github.com/user-attachments/assets/b4ab35ac-f994-46b1-8957-e82fe87ff0e9を使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第5節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

エクスポート形式とオフライン再生

READMEは、編集可能なPowerPoint（.pptx）、インタラクティブHTMLページ、コース構造とメディアを含む教室ZIPの3つのエクスポート形式をリストしています。オフラインまたはイントラネット教室の場合、教室またはリソースパックをエクスポートするとき、OpenMAICはKaTeX、Three.js、Tailwind CDN、Google Fonts、画像などのインタラクティブシーンで参照される外部アセットをdata URIとしてHTMLにインライン化します。エクスポートされたコースは、隔離されたまたはイントラネットインスタンスにインポートした後、完全にオフラインで再生され、再生時にパブリックCDNに接触しません。READMEは、エクスポート時に取得できないアセットは報告され、URLとして残されると述べています。また、この機能より前にエクスポートされた教室はCDNを参照しているため、オフラインサポートを得るには再エクスポートする必要があると述べています。

THU-MAIC/OpenMAICのREADMEにある「エクスポート形式とオフライン再生」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。https://github.com/user-attachments/assets/b4ab35ac-f994-46b1-8957-e82fe87ff0e9を使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第6節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

THU-MAIC/OpenMAICのREADMEにある「導入時の記録」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Get an immersiveを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第6節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

OpenClaw統合とライセンス

OpenMAICは、Feishu、Slack、Discord、Telegram、WhatsAppなどのメッセージングプラットフォームに接続するパーソナルAIアシスタントであるOpenClawと統合されています。この統合により、チャットアプリから直接教室を生成して表示できます。READMEは2つのモードを示しています：open.maic.chatのアクセスコードを使用するホスト型モードと、スキルがクローン、設定、起動を案内するセルフホスト型モードです。スキルはClawHubで利用可能で、「clawhub install openmaic」コマンドでインストールできます。プロジェクトはMITライセンスの下でライセンスされており、ライセンスの抜粋は、著作権表示と許可表示が含まれることを条件に、ソフトウェアのコピーを使用、コピー、変更、マージ、公開、配布、サブライセンス、販売する権利を許可しています。ライセンスはまた、ソフトウェアが「現状のまま」提供され、いかなる種類の保証もないと述べています。READMEはまた、2つのバンドルされたワークスペースパッケージが独自のライセンスを持っていることにも言及しています：mathml2ommlはLGPL-3.0-or-later、pptxgenjsはMITです。

THU-MAIC/OpenMAICのREADMEにある「OpenClaw統合とライセンス」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Get an immersiveを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第7節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

THU-MAIC/OpenMAICのREADMEにある「導入時の記録」は、機能名だけでなく、入力、処理、出力を追跡する入口です。資料が明示している範囲と、書かれていない互換性や性能を分けて扱います。Take the full tour inを使った確認では、実行前の環境、実行したコマンド、終了状態、生成物、ログの順に記録します。設定を変える場合は変更点を一つに絞り、元の値と結果を残します。READMEにない挙動は推測で補わず、文書未記載として判断を保留します。THU-MAIC/OpenMAICを既存環境へ入れる読者は、第7節の具体的なファイルやコマンドを起点に、小さな入力で再現性を確認してください。

編集部の結論

THU-MAIC/OpenMAICはREADMEが示す用途と環境が一致する読者に向いています。導入前にGet an immersiveを使い、最小構成で入力、終了状態、生成ファイル、警告、権限要求を確認してください。資料にない互換性や性能は断定せず、確認した構成と版を採用判断の基準にします。

公式情報源

1. Official README
2. Project repository
3. Release notes