HKUSTDial/DataMagic

📚 DataMagicとは？

DataMagicは、表形式データ（CSV、Excelなど）を短いアニメーション動画ストーリーに変換できるオープンソースのツールキットです。139種類の「レシピカード」ライブラリが付属しており、各カードは特定の視覚効果（例：ランキングの公開、地図ベースの比較、キャラクター主導のウォークスルーなど）を記述し、以下を提供します。

• アニメーションのプレビュー
• 効果を生成するための宣言型ソースコード
• サンプルデータ

datamagic Skill（プロンプトとヘルパースクリプトのセット）を使用すると、プログラミングエージェント（例：LLMを活用したコードアシスタント）が自動的に以下の操作を行えます。

1. データに適したレシピを選択する
2. テンプレートに独自の数値、ラベル、色、アセットを注入する
3. 動画をレンダリングする
4. 出力を検証する

本プロジェクトは、2つの査読済み論文（IEEE VIS 2026およびVLDB 2026 Demo）と、スプレッドシートをアップロードして数秒で完成動画を取得できるオンラインデモサイトによって支えられています。

---

🛠️ 主要コンポーネント

コンポーネント	機能	場所
レシピカード (Recipe cards)	視覚的ナラティブの宣言型仕様（アニメーションタイムライン、チャートタイプ、ナレーションの合図）。	cards/recipes/ およびWebギャラリー https://datamagic.chat/cards/
テンプレートソースコード	CSVを読み取り、フィールドを視覚要素にマッピングし、レンダリングエンジンを駆動する再利用可能なスクリプト（Python/JS）。	各カードからリンク；cards/ にも存在
datamagic Skill	コード生成エージェントが適切なテンプレートを見つけ、データを置換し、レンダラーを実行できるようにするプロンプトライブラリと小さなユーティリティ。	skills/datamagic/
オンラインシステム	パイプライン全体（データアップロード → レシピ推奨 → 動画生成）を調整するホスト型サービス。	https://datamagic.chat/
研究ドキュメント	基盤となるパイプライン (DVSpec) の説明、評価、引用情報。	docs/

---

🚀 使用方法（クイックスタート）

1. リポジトリをクローン

   git clone https://github.com/HKUSTDial/DataMagic.git
   cd DataMagic
   

2. レシピを選択 – Webギャラリーまたはローカルの cards/recipes/ フォルダを参照します。Copy implementation command をクリックして1行の指示を取得します。
3. エージェントを実行 – コマンドをお気に入りのLLM搭載コーディングアシスタント（例：関数呼び出し機能付きのOpenAI ChatGPT、Claude、またはローカルホストモデル）に貼り付けます。CSVとカスタムスタイルのメモを提供します。
4. レンダリング – スキルがテンプレートを特定し、データを注入し、レンダリングバックエンドを呼び出し、MP4と編集済みのソースファイルを出力します。
5. 反復調整 – タイミング、色、字幕の調整やアセットの置換をエージェントに依頼します。ワークフローは完全に再現可能です。

72秒のデモ（コーヒーショップの売上）では、検索 → レシピ → コマンド → 動画生成という一連のループ全体が示されています。

---

🎯 ターゲット層

対象者	重要性
コンテンツクリエイター / SNSマネージャー	アニメーションソフトを学習することなく、目を引くデータ動画を作成できます。
データアナリスト / 研究者	静的な表を、プレゼンや論文で共有可能なナラティブな視覚化コンテンツに変換できます。
AI/ML開発者	宣言型マルチエージェントオーケストレーション の例であり、LLMがコードを生成・実行する具体的なユースケースです。
教育者	統計学、経済学、地理学をアニメーションストーリーテリングで教えるための既製テンプレートです。

---

📖 ドキュメントとコミュニティ

• Webギャラリーとライブエディタ – https://datamagic.chat/cards/（プレビュー、編集、ソースのダウンロード）。
• スキルガイド – skills/datamagic/README.md（インストール、プロンプト形式、トラブルシューティング）。
• フルストーリーワークフロー – skills/datamagic/rules/full-story-workflow.md（複数のカードを組み合わせて一貫したナラティブを作成）。
• 研究論文 – README内のIEEE VIS 2026およびVLDB 2026へのリンク。
• コミュニティ – WeChatグループ（リポジトリ内のQRコード）で作品を共有し、サポートを受けることができます。

---

⭐️ クイックまとめ

DataMagicは、宣言型レシピカードとLLM駆動のコードオーケストレーションを通じてデータ分析と動画制作の橋渡しをする、研究に裏打ちされた実用的なプラットフォームです。データ駆動型の動画ストーリー作成を自動化したいすべての人にとって有用であり、リポジトリには開始に必要なすべてのテンプレート、エージェントスキルプロンプト、ドキュメントが用意されています。