AI支援グラフィカルプレゼンテーション生成システム

English | 日本語

AI_Instruction_Kitsと連携して、技術・ビジネスコンテンツ向けの専門的でグラフィカルなプレゼンテーションをAI支援で作成するPythonベースのプレゼンテーション生成フレームワーク。

📚 ドキュメント

クイックスタート - 5分でプレゼンテーションを作成
Markdownシナリオガイド - 詳細な使い方とリファレンス
デザインガイド - デザインシステムとカスタマイズ方法
トラブルシューティング - よくある問題と解決方法

📊 サンプルシナリオ

様々な用途のサンプルを用意しています:

図表サンプル集 - 全種類の図表を網羅
- 3層アーキテクチャ図
- フローチャート（複数パターン）
- 比較表
技術プレゼンテーション - CI/CDパイプライン実装ガイド
- 技術アーキテクチャ
- 詳細なフローチャート
- ベストプラクティス
ビジネスプレゼンテーション - DX推進プロジェクト提案
- 推進体制図
- プロセスフロー
- 投資計画・効果測定

# サンプルをビルド
make build-scenario SCENARIO=scripts/scenarios/diagram_showcase.md
make build-scenario SCENARIO=scripts/scenarios/technical_sample.md
make build-scenario SCENARIO=scripts/scenarios/business_sample.md

機能

モダンなデザイン: モノクロームを中心としたミニマルでプロフェッショナルなスタイル
ワイドフォーマット: 16:9のワイドスクリーン対応
Markdownシナリオ: Markdownで書くだけでプレゼンテーション生成
AI支援会話モード: 自然言語での対話を通じてプレゼンテーションを作成
多様な図表タイプ: diagrams、graphviz、networkxを使用したアーキテクチャ図、フローチャート、ネットワーク図
統計グラフ: matplotlibとseabornを使用した折れ線グラフ、棒グラフ、散布図、円グラフ
バイリンガル対応: 適切なフォント処理による日本語・英語のプレゼンテーション
テーマシステム: Monochrome（デフォルト）、Corporate、Technical、Academicテーマ
PowerPoint生成: python-pptxによる専門的な.pptxファイル

インストール

前提条件

Python 3.8以上
Graphviz（フローチャート用）
uv - 高速なPythonパッケージインストーラー（推奨）

uvのインストール（推奨）

Linux/macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

代替方法（pipを使用）:

pip install uv

Graphvizのインストール

Ubuntu/Debian:

sudo apt-get install graphviz

macOS:

brew install graphviz

Windows: https://graphviz.org/download/ からダウンロード

パッケージのインストール

クイックセットアップ（推奨）

ワンライナーで自動セットアップ:

bash scripts/setup.sh

このスクリプトが自動的に実行：

uvまたはpipの検出
仮想環境の作成
依存関係のインストール
インストール確認

手動セットアップ

オプション1: uvを使用（推奨 - 高速）

# リポジトリのクローン
git clone https://github.com/dobachi/PresentationTemplate.git
cd PresentationTemplate

# AI_Instruction_Kitsサブモジュールの初期化
git submodule update --init --recursive

# 仮想環境の作成
uv venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate    # Windows

# 依存関係のインストール（pyproject.tomlから自動読み込み）
uv pip install -e .

オプション2: 従来のvenv + pipを使用

# リポジトリのクローン
git clone https://github.com/dobachi/PresentationTemplate.git
cd PresentationTemplate

# AI_Instruction_Kitsサブモジュールの初期化
git submodule update --init --recursive

# 仮想環境の作成
python3 -m venv venv

# 仮想環境の有効化
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate    # Windows

# 依存関係のインストール（pyproject.tomlから自動読み込み）
pip install -e .

クイックスタート

方法0: Makeを使用（最も簡単）

# 初回セットアップ
make setup

# Markdownシナリオからプレゼンテーションをビルド（NEW!）
make build-scenario SCENARIO=scripts/scenarios/example.md

# 利用可能なシナリオファイルを確認
make list-scenarios

# Pythonスクリプトからプレゼンテーションをビルド
make build SCRIPT=scripts/generate_presentation.py

# サンプルを生成
make examples

# その他のコマンドを確認
make help

方法1: AI支援モード（推奨）

CLAUDE.mdファイルを使ってClaudeと直接対話：

データスペース国際相互運用性について15分のプレゼンを作りたい。
日欧協力（OuranosとGaia-X）に焦点を当てて。
対象者は技術者、言語は日本語。

Claudeが以下を実行：

確認質問
スライド構成の提案
図表の自動生成
PowerPointファイルの作成

方法2: Python API

from src.core.presentation import PresentationBuilder
from src.diagrams.architecture import ArchitectureDiagram
from src.charts.statistical import StatisticalChart

# ビルダーの作成
builder = PresentationBuilder(theme='corporate', language='ja')

# タイトルスライドの追加
builder.add_title_slide(
    title="データスペース国際相互運用性",
    subtitle="日欧協力"
)

# アーキテクチャ図の生成と追加
arch_diagram = ArchitectureDiagram(language='ja')
diagram_path = arch_diagram.create_three_layer_architecture(
    layers={
        'application': ['アプリ1', 'アプリ2', 'アプリ3'],
        'service': ['APIゲートウェイ', '認証サービス', 'データカタログ'],
        'data': ['メタデータDB', 'データストレージ', 'オブジェクトストア']
    }
)
builder.add_diagram_slide(
    title="データスペース3層アーキテクチャ",
    diagram_path=diagram_path
)

# グラフの生成と追加
chart = StatisticalChart(language='ja')
chart_path = chart.create_line_chart(
    data={
        'x': [2020, 2021, 2022, 2023, 2024],
        'y_ouranos': [10, 25, 45, 80, 120],
        'y_gaiax': [30, 60, 95, 140, 200]
    },
    labels={
        'x_axis': '年度',
        'y_axis': '採用率',
        'y_ouranos': 'Ouranos',
        'y_gaiax': 'Gaia-X'
    },
    title='データスペース採用トレンド'
)
builder.add_chart_slide(
    title="採用トレンド",
    chart_path=chart_path
)

# プレゼンテーションの保存
builder.save('output/DataSpace_Interoperability.pptx')

方法3: Markdownシナリオ（NEW!）

最も柔軟で編集しやすい方法

Markdownファイルでプレゼンテーションの内容を記述し、Pythonで自動生成します。プレゼンテーション内容の修正が簡単で、バージョン管理もしやすいです。

Markdownシナリオの作成 (scripts/scenarios/my_presentation.md):

---
title: データスペース国際相互運用性
author: Dobachi
theme: corporate
language: ja
---

# データスペース国際相互運用性
## 日欧協力の現状と展望

---

## 背景と目的

データ駆動型社会の実現に向けた国際的な取り組みが加速しています。

- データエコノミーの拡大
- 国境を越えたデータ流通の必要性
- 信頼できるデータ共有基盤の構築

::: notes
このスライドでは約2分で背景を説明します。
:::

---

## データスペース3層アーキテクチャ

```diagram:three_layer
application:
  - Webアプリケーション
  - モバイルアプリ
service:
  - APIゲートウェイ
  - 認証・認可サービス
data:
  - メタデータDB
  - 分散データストレージ

::: notes 3層構造により、セキュリティとスケーラビリティを両立しています。 :::

今後の展望

共通標準の策定
実証実験の推進
グローバルエコシステムの構築


**プレゼンテーション生成**:

```bash
# コマンドライン
.venv/bin/python scripts/build_from_scenario.py scripts/scenarios/my_presentation.md

# または Makeを使用
make build-scenario SCENARIO=scripts/scenarios/my_presentation.md

Markdownシナリオの構文:

YAMLフロントマター: プレゼンテーションのメタデータ（タイトル、テーマ、言語）
# 見出し1: タイトルスライド
## 見出し2: コンテンツスライド
---: スライド区切り
- 箇条書き: 箇条書きリスト
::: notes ... :::: スピーカーノート
```diagram:タイプ ... ```: 図表の生成指示
- three_layer: 3層アーキテクチャ
- flowchart: フローチャート
- network: ネットワーク図
```chart:タイプ ... ```: グラフの生成指示
- line: 折れ線グラフ
- bar: 棒グラフ

Markdownシナリオの利点:

✅ 編集が簡単: テキストエディタで直接編集 ✅ バージョン管理: Gitで差分管理が容易 ✅ 内容に集中: 見た目よりも内容の記述に集中 ✅ 再利用性: 同じ構造で複数のプレゼンを作成 ✅ AI支援: Claudeが内容を提案・修正しやすい

方法4: YAML定義

YAMLファイルの作成：

presentation:
  title: "データスペースアーキテクチャ"
  author: "Dobachi"
  language: "ja"
  theme: "corporate"

slides:
  - type: title
    title: "データスペースアーキテクチャ"
    subtitle: "概要とコンポーネント"

  - type: content
    title: "イントロダクション"
    layout: "text"
    bullets:
      - "データスペースとは"
      - "なぜ重要か"
      - "主要コンポーネント"

生成：

builder = PresentationBuilder()
builder.load_definition('my_presentation.yaml')
builder.build_from_definition(builder.load_definition('my_presentation.yaml'))
builder.save('output.pptx')

サポートする図表タイプ

アーキテクチャ図

3層アーキテクチャ（データ/サービス/アプリケーション）
クラウドアーキテクチャ（AWS、Azure、GCP）
マイクロサービスアーキテクチャ
国際相互運用性（Ouranos ↔ Gaia-X）

フローチャート

プロセスフロー
決定木
データフロー図

ネットワーク図

ネットワークトポロジー
相互運用性ネットワーク
接続図

統計グラフ

折れ線グラフ
棒グラフ（縦/横）
散布図
円グラフ
積み上げ棒グラフ

バイリンガル対応

日本語プレゼンテーション

builder = PresentationBuilder(theme='corporate', language='ja')
builder.set_fonts(
    title_font='Meiryo',
    body_font='Meiryo'
)

英語プレゼンテーション

builder = PresentationBuilder(theme='corporate', language='en')
builder.set_fonts(
    title_font='Arial',
    body_font='Arial'
)

日英混在

builder = PresentationBuilder(theme='corporate', language='ja_en')
builder.add_title_slide(
    title="Data Space Architecture",
    subtitle="データスペースアーキテクチャ"
)

テーマ

3つの組み込みテーマ：

Corporate: プロフェッショナルな青系テーマ
Technical: ダークアクセントの技術テーマ
Academic: アカデミックスタイル

カスタムテーマはconfig/themes/で作成可能。

サンプル

examples/ディレクトリを参照：

architecture_example.py - アーキテクチャ図のサンプル
full_presentation_example.py - 完全なプレゼンテーションのサンプル
example_conversation.md - AIとの会話サンプル

AI指示ファイル

instructions/modules/に専門的なAI指示モジュールを含む：

presentation_designer.md - 設計のための会話ガイド
diagram_generator.md - 図表作成指示
presentation_workflow.md - エンドツーエンドのワークフロー

これらはAI_Instruction_Kitsフレームワークと連携します。

プロジェクト構造

PresentationTemplate/
├── src/                      # ライブラリコード（変更しない）
│   ├── core/                 # コアプレゼンテーション構築
│   ├── diagrams/             # 図表生成ライブラリ
│   ├── charts/               # グラフ生成ライブラリ
│   ├── i18n/                 # 国際化・フォント選択
│   ├── ai/                   # AI会話フロー
│   └── utils/                # ユーティリティ
├── scripts/                  # ユーザースクリプト（ここに作成）
│   ├── setup.sh              # セットアップスクリプト
│   ├── check_dependencies.py # 依存関係確認
│   └── generate_*.py         # プレゼンテーション生成スクリプト
├── config/
│   └── themes/               # テーマ設定
├── instructions/
│   ├── ai_instruction_kits/  # サブモジュール
│   └── modules/              # カスタム指示モジュール
├── examples/                 # サンプルコード（参考用）
│   ├── architecture_example.py
│   └── full_presentation_example.py
├── output/                   # 生成されたプレゼンテーション
└── templates/                # PowerPointテンプレート

ディレクトリの役割

src/: このテンプレートが提供するライブラリコード。変更しない
scripts/: ユーザーがプレゼンテーション生成用に作成するスクリプト。ここに作成
examples/: 使い方の参考となるサンプルコード
output/: 生成された.pptxファイルが保存される場所

トラブルシューティング

問題が発生した場合は、トラブルシューティングガイドを参照してください。

よくある問題：

Graphvizエラー: システムにGraphvizがインストールされていることを確認
日本語フォントの問題: Meiryoまたは代替フォントがインストールされている必要があります
依存関係エラー: uv pip install -e . で再インストール

ライセンス

MIT License

コントリビューション

コントリビューション歓迎！ガイドラインはCONTRIBUTING.mdを参照してください。

作者

Dobachi

謝辞

AI_Instruction_Kitsの上に構築
python-pptxを使用
diagramsによる図表生成

Name		Name	Last commit message	Last commit date
.claude		.claude
config/themes		config/themes
docs		docs
examples		examples
instructions		instructions
scripts		scripts
src		src
.gitignore		.gitignore
.gitmodules		.gitmodules
AGENTS.en.md		AGENTS.en.md
AGENTS.md		AGENTS.md
CLAUDE.en.md		CLAUDE.en.md
CLAUDE.md		CLAUDE.md
CODEX.en.md		CODEX.en.md
CODEX.md		CODEX.md
CURSOR.en.md		CURSOR.en.md
CURSOR.md		CURSOR.md
GEMINI.en.md		GEMINI.en.md
GEMINI.md		GEMINI.md
Makefile		Makefile
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
README.en.md		README.en.md
README.md		README.md
TROUBLESHOOTING.en.md		TROUBLESHOOTING.en.md
TROUBLESHOOTING.md		TROUBLESHOOTING.md
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
setup.py		setup.py

Latest commit

History

Folders and files

Repository files navigation