hugohe3/ppt-master

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

PPT Master – AI 生成のネイティブ PowerPoint デッキ

機能概要

PPT Master は、大規模言語モデル(LLM)がソースドキュメント(PDF、DOCX、Web ページなど)を読み取り、実際の .pptx ファイルを出力できるようにする Python ベースのツールです。生成されたデッキはフラットな画像ではなく、PowerPoint のネイティブオブジェクトを含みます:

  • スライドマスターとレイアウト
  • 編集可能な図形、コネクタ、テキストボックス
  • データ駆動のチャートとテーブル
  • ネイティブな画像、塗りつぶし、エフェクト
  • オプションのトランジション、アニメーション、ナレーション

出力は PowerPoint 自身のオブジェクトモデルを使用しているため、PowerPoint でファイルを開き、自分でスライドを作成したのと同じように編集を続けることができます。

仕組み(高レベル)

  1. エージェント対応 AI ツール – エージェント(ファイルの読み書き、コマンド実行)として機能する任意のチャット/IDE 内でワークフローを実行します。README では Claude Code、Kimi K3、または類似のモデルを推奨しています。
  2. プロンプトとモデル – エージェントに「この PDF からデッキを作成して」と指示します。モデルはソースを解析し、要点を抽出し、スライド構造を決定し、画像生成(例:gpt‑image‑2 や Gemini‑nano‑banana‑2.1)を要求する場合があります。
  3. Python パイプライン – モデルの指示は PPT Master Python スクリプトによって実行され、以下を行います:
    • ソースをプレーンテキストに変換(組み込みパーサーまたはレガシー形式用のオプションの Pandoc を使用)
    • python‑pptx ライブラリを使用して PowerPoint ファイルを構築し、ネイティブな図形、チャート、テーブルなどを配置
    • 最終的な .pptx をディスクに書き込み
  4. ローカル実行 – すべての処理はマシン上で行われます。LLM 呼び出しのみが選択した API プロバイダーに送信されます。PowerPoint のサブスクリプションは不要です。

主な機能

機能 得られるもの
ネイティブ PowerPoint オブジェクト スライドには実際の図形、チャート、テーブル、スライドマスターの継承が含まれ、PowerPoint で完全に編集可能です。
複数の入力形式 PDF、DOCX、HTML、EPUB、IPYNB、およびオプションの Pandoc により .doc、.odt、.tex などのレガシー形式もサポート。
テンプレート抽出と再利用 既存のスライドからブランド/テンプレートデッキを導出し、新しいコンテンツに再利用します。
スタイル保持の埋め込み 既存の .pptx を更新する際、元のデザインを維持しながら新しいテキスト/画像に置き換えます。
オプションのトランジション/アニメーション/ナレーション 後処理ステップとして、ネイティブな PowerPoint トランジション、シンプルなアニメーション、オーディオナレーションを追加します。
エージェント非依存 モデルがファイルを読み書きできる限り、Claude、Kimi、GPT、Gemini などと連携します。
透明なコスト 唯一の費用は LLM API の使用量です。ソフトウェア自体は MIT ライセンスで無料です。
ローカルデータ ソースドキュメントは(LLM 呼び出しを除いて)コンピューターから離れることはありません。

はじめに(クイックサマリー)

  1. Python 3.10+ をインストールします。
  2. リポジトリをクローン(または ZIP をダウンロード)し、pip install -r requirements.txt を実行します。
  3. エージェントを選択 – 例:Claude Code、Kimi K3、またはファイル読み書きエージェントをサポートする任意の CLI/IDE。
  4. スキルを実行 – エージェントのチャットウィンドウで make a deck from <path‑to‑file.pdf> のようなコマンドを入力します。エージェントが PPT Master パイプラインを呼び出し、output.pptx を生成します。
  5. 結果のファイルを PowerPoint で開き、必要に応じて編集します。

README には以下も記載されています:

  • Windows 固有のインストールガイド、
  • Claude Code でのワンクリックインストール用のスキルマーケットプレイスマニフェスト、
  • いくつかのサンプルデッキを含むライブデモサイト、および
  • 将来のネイティブ PowerPoint 機能を概説するロードマップ/FAQ。

対象ユーザー

  • レポート、研究論文、ブランド資産から迅速に編集可能なスライドデッキを必要とするプロフェッショナル。
  • Python 環境と AI エージェントチャットツールに慣れた開発者またはパワーユーザー。
  • データをローカルに保ち、ベンダーロックインされた PowerPoint 生成サービスを避けたい人。

上記の詳細はすべてリポジトリの README から直接取得しています。追加の機能は推測していません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト