Tencent/WeSmartFlow

Every question can open a new path. WeSmartFlow turns learning into conversation, exploration, stories, and hands-on discovery.

WeSmartFlow – オープンソースの適応型学習プラットフォーム

概要 – WeSmartFlowは、AIエージェントがパーソナル学習コンパニオンとして機能するオープンソースのフレームワークです。学習者の目標を理解し、学習パスを生成し、インタラクティブなコンテンツ（カード、ビジュアライゼーション、クイズ、音声）を作成し、パーソナルナレッジグラフで進捗を追跡し、さらにゲームのような「探索」ワールドに体験を埋め込むことができます。リポジトリには、再利用可能なエージェントコア、FastAPIバックエンドサービス、Vue-3フロントエンド、および「探索」トピックの例が含まれています。

コア機能

機能	動作
ReActスタイルのチュータリングエージェント	ツール（検索、ナレッジグラフ、HTMLカードジェネレーター、EduVizビジュアライザー、クイズメーカー、TTS）を使用して、質問に答え、学習成果物を作成し、学習者のナレッジグラフを更新します。
グラフメモリ（パーソナルナレッジブレイン）	概念をノードとして関係（前提条件、関連など）とともに保存し、SM-2間隔反復で習熟度を追跡し、このグラフをフリーチュータリングと没入型コースで共有します。
マルチエージェントコース生成	専門化されたエージェント（プランナー、リサーチャー、ライター、イラストレーター、音声、クイズ）のパイプラインが、フルコース（PDF + 音声 + 演習 + ナレッジグラフエントリ）を自動的に構築します。
HTMLナレッジカードとEduViz	カード: 概念の静的で印刷可能な要約。EduViz: SDKから生成され、ブラウザでレンダリングされるJavaScriptベースのインタラクティブなビジュアライゼーション。
探索モード	あらゆるフロントエンド技術（Vue、React、Three.jsなど）で構築されたプラグイン学習ワールド（例：「Magic English Town」、「Math Garden」）。メインサイトはカタログJSONを介してそれらをロードします。
WeClaw WeChatブリッジ	WeChatメッセージを同じチュータリングサービスに転送するオプションチャネルで、送信前にPlaywrightでカードを画像としてレンダリングします。

アーキテクチャスナップショット

WeSmartFlow/
├─ backend/                # FastAPIサーバー、agent_core、サービス、DB（SQLite + ベクターストア）
│   ├─ agent_core/        # ReAct、DAGワークフロー、ツール登録
│   ├─ agents/            # チュータリング、リサーチなどのプロンプトテンプレート
│   ├─ services/          # チュータリング、コース作成、ナレッジグラフAPI
│   └─ channels/          # WeClaw（WeChat）統合
├─ frontend/               # Vue-3 SPA – チャット、コースビューアー、グラフ、クイズ、探索ページ
├─ examples/               # 独立した「探索」トピック + カタログJSON
└─ environment.yml         # Conda環境（Python 3.10+、Node 25）

バックエンドは、LLM_API_KEY、LLM_BASE_URL、LLM_MODELを介して任意のOpenAI互換LLMと通信します。フロントエンドはREST APIを消費し、エージェントの応答をストリーミングし、生成されたカード/ビジュアライゼーションを表示します。

はじめに（READMEに記載の通り）

クローン（メディアアセット用にGit LFSを使用）。
Conda環境を作成（conda env create -f environment.yml）。
フロントエンドの依存関係をインストール（npm --prefix frontend install）。
.envでLLMを設定（OpenAI、DeepSeekなど）、オプションで認証プロバイダー（GitHub OAuth、メールSMTP、WeChat）を設定。

実行:

# ターミナル1
cd backend && python main.py   # FastAPI on :8080
# ターミナル2
cd frontend && npm run dev    # Vue dev server on :5173

http://localhost:5173を開く – フリーチュータリング、没入型コース、または探索ページを試すことができます。

オプションの追加機能:

WeClaw – WECLAW_ENABLED=trueを有効にし、WeChatボットをバインドします。
PDFコース生成 – XeLaTeX/latexmkとSimplePlus Beamerテーマをインストールします。

誰が使うべきか？

教育者 – スタック全体を構築せずに、インタラクティブなAI生成コースを作成したい人。
開発者 – 教育向けに調整された再利用可能なエージェントフレームワーク（agent_core）を探している人。
学習者 – 過去のセッションを記憶し、カリキュラムを適応させるパーソナルAIチューターを望む人。

ライセンス

MIT – 商用・非商用を問わず無料で使用できます。

上記の詳細はすべてリポジトリのREADMEから直接取得されており、外部の仮定は追加されていません。