deck-generator

Deck Generator

すべてのスライドを一貫したビジュアルスタイルの AI 生成画像で構成したプレゼンテーションを作成します。

クイックスタート

1. コンテンツ仕様を読み込みます（ユーザーがスライドの内容または Markdown ファイルを提供します）
2. references/styles.md を読み込み、ビジュアルスタイルを選択またはカスタマイズします
3. コンテンツとスタイルを指定して scripts/generate-deck.py を実行します

ワークフロー

ステップ 1：コンテンツ仕様

どのような形式のスライドコンテンツでも受け付けます。各スライドについて、次の構成に整えます。

• タイトル：太字の見出し
• 本文：要点、統計情報、または説明
• 視覚的な手がかり：アイコン、図、レイアウトを言葉で説明したもの

ユーザーが --- 区切りの Markdown ファイルを提供した場合は、各セクションを 1 枚のスライドとして解析します。 ユーザーがトピックのみを提供した場合は、一般的なデッキ構成に沿って 10～14 枚のスライドを生成します。

ステップ 2：スタイルの選択

利用可能なスタイルプリセット：

スタイル	説明
whiteboard	白地に手描きのスケッチ。黒のインクとオレンジのアクセント。
corporate	ネイビー／白／ゴールド。すっきりとしたサンセリフ体。プロフェッショナルな印象。
minimalist	純白に鮮やかなブルーのアクセント。最大限の余白。
dark-tech	ほぼ黒の背景にネオングリーン。ターミナルのようなデザイン。
playful	明るいパステルカラーと丸みのある図形。モダンなスタートアップの雰囲気。
editorial	黒／白に赤のスポットカラー。雑誌のようなデザイン。

デフォルト：whiteboard。ユーザーは任意のプリセットを指定するか、カスタムスタイルを説明できます。

ステップ 3：生成

# Set your API key
export GEMINI_API_KEY="your-gemini-api-key"

# Run the generator
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "Deck Title" \
  [--output-dir ./output] \
  [--aspect 16:9]

スクリプトは次の処理を行います。

1. Imagen 4.0 API を使って各スライドの画像を生成します
2. すべての画像を出力ディレクトリに保存します
3. オプションで Google Slides プレゼンテーションを作成します（Google Slides API の認証情報が必要です）
4. 生成したすべての画像のパスを返します

ステップ 4：確認と反復

個別のスライドを再生成するには：

python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --slides 3,7 \
  --output-dir ./output

主な詳細

• 費用：画像 1 枚あたり約 4 セントです。14 枚のスライドで構成されるデッキの場合、API 呼び出しの費用は約 56 セントです。
• 速度：14 枚のスライドで約 2 分です。
• API：Google の Generative Language API 経由の Imagen 4.0
• 認証：環境変数 $GEMINI_API_KEY を設定します
• アスペクト比：16:9（デフォルト）、1:1、4:3、3:4、9:16
• 画像モデル：imagen-4.0-generate-001（最高品質）、imagen-4.0-fast-generate-001（高速）

コンテンツ JSON 形式

[
  {"name": "01-title", "prompt": "Title slide: 'Your Deck Title' with company logo placeholder"},
  {"name": "02-problem", "prompt": "Problem slide showing frustrated marketer staring at dashboard with declining metrics"},
  {"name": "03-solution", "prompt": "Solution slide: AI agent workflow diagram with 3 connected boxes"}
]

Google Slides との連携（任意）

Google Slides プレゼンテーションを自動作成するには、Google Slides API の認証情報を設定します。

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "My Deck" \
  --google-slides \
  --google-account [email protected]