Public

WeChat Login

Code Issues Pull requests Events Packages Insights

main

ppt-master/README_EN.md

hugohe3<heyug3@gmail.com>

git commit -m "docs(readme): 更新 AI 编辑器推荐并增加生图能力集成说明

b0fca9b6

PreviewCode viewBlame

PPT Master - AI-Powered Multi-Format SVG Content Generation System

English | 中文

An AI-powered intelligent visual content generation system that transforms source documents into high-quality SVG content through multi-role collaboration, supporting presentations, social media, marketing posters, and various other formats.

🎴 Online Examples: GitHub Pages Online Preview - View actual generated results

🎬 Quick Demo: YouTube | Bilibili - Watch video demonstrations

🚀 Quick Start

1. Configure Environment

Python Environment (Required)

This project requires Python 3.8+ for running PDF conversion, SVG post-processing, PPTX export, and other tools.

Install Python:

Platform	Recommended Installation
macOS	Use Homebrew: `brew install python`
Windows	Download installer from Python Official Website
Linux	Use package manager: `sudo apt install python3 python3-pip` (Ubuntu/Debian)

💡 Verify Installation: Run python3 --version to confirm version ≥ 3.8

Node.js Environment (Optional)

If you need to use the web_to_md.cjs tool (for converting web pages from WeChat and other high-security sites), install Node.js.

Install Node.js:

Platform	Recommended Installation
macOS	Use Homebrew: `brew install node`
Windows	Download LTS version from Node.js Official Website
Linux	Use NodeSource: `curl -fsSL https://deb.nodesource.com/setup_lts.x \| sudo -E bash - && sudo apt-get install -y nodejs`

💡 Verify Installation: Run node --version to confirm version ≥ 18

2. Clone Repository and Install Dependencies


git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

If you encounter permission issues, use pip install --user -r requirements.txt or install in a virtual environment.

3. Open AI Editor

Recommended AI editors:

Tool	Rating	Description
VS Code + Copilot	⭐⭐⭐	Highly Recommended! High cost-effectiveness, stable, Microsoft official solution
Cursor	⭐⭐	Mainstream AI editor, great experience but relatively expensive
Claude Code	⭐⭐	Anthropic official CLI tool
Antigravity	⭐	Free Opus 4.6 access, but currently highly unstable. Recommended only as an alternative.

4. Start Creating

Open the AI chat panel in your editor and describe what content you want to create:


User: I have a Q3 quarterly report that needs to be made into a PPT

AI (Strategist role): Sure, before we begin I need to complete eight confirmations...
   1. Canvas format: [Recommended] PPT 16:9
   2. Page count: [Recommended] 8-10 pages
   ...

💡 Model Recommendation: Opus 4.6 works best. However, due to the current instability of Opus on some IDEs (like Antigravity), using other stable AI clients is recommended.

💡 Image Generation Integration: We suggest configuring Google AI environment variables (GEMINI_API_KEY, and optionally GEMINI_BASE_URL for proxy) to integrate the powerful image generation capabilities of nano banana 2 via this project's tools/nano_banana_gen.py. If using the Antigravity proxy, please be aware to pass the model parameter (-m gemini-3.1-flash-image) when calling.

💡 AI Lost Context? You can prompt the AI to refer to the AGENTS.md file, and it will automatically follow the role definitions in the repository

💡 AI Image Generation Tip: For AI-generated images, we recommend generating them in Gemini and selecting Download full size for higher resolution than Antigravity's direct generation. Gemini images have a star watermark in the bottom right corner, which can be removed using gemini-watermark-remover or this project's tools/gemini_watermark_remover.py.

📚 Documentation Navigation

Document	Description
📖 Workflow Tutorial	Detailed workflow and case demonstrations
🎨 Design Guidelines	Colors, typography, layout specifications
📐 Canvas Formats	PPT, Xiaohongshu, WeChat Moments, and 10+ formats
🖼️ Image Embedding Guide	SVG image embedding best practices
📊 Chart Template Library	13 standardized chart templates · Online Preview
⚡ Quick Reference	Common commands and parameters cheat sheet
🔧 Role Definitions	Complete definitions of 6 AI roles
🛠️ Toolset	Usage instructions for all tools
💼 Examples Index	15 projects, 229 SVG pages of examples

🎴 Featured Examples

📁 Example Library: examples/ · 15 projects · 229 SVG pages

Category	Project	Pages	Features
🏢 Consulting Style	Attachment in Psychotherapy	32	Top consulting style, largest scale example
	Building Effective AI Agents	15	Anthropic engineering blog, AI Agent architecture
	Chongqing Regional Report	20	Regional fiscal analysis, Enterprise Alert data 🆕
	Ganzi Prefecture Economic Analysis	17	Government fiscal analysis, Tibetan cultural elements
🎨 General Flexible	Debug Six-Step Method	10	Dark tech style
	Chongqing University Thesis Format	11	Academic standards guide
✨ Creative Style	I Ching Qian Hexagram Study	20	I Ching aesthetics, Yin-Yang design
	Diamond Sutra Chapter 1 Study	15	Zen academic, ink wash whitespace
	Git Introduction Guide	10	Pixel retro game style

📖 View Complete Examples Documentation

🏗️ System Architecture


User Input (PDF/URL/Markdown)
    ↓
[Source Content Conversion] → pdf_to_md.py / web_to_md.py
    ↓
[Create Project] → project_manager.py init <project_name> --format <format>
    ↓
[Template Option] A) Use existing template B) No template
    ↓
[Need New Template?] → Use /create-template workflow separately
    ↓
[Strategist] - Eight Confirmations & Design Specifications
    ↓
[Image_Generator] (When AI generation is selected)
    ↓
[Executor] - Two-Phase Generation
    ├── Visual Construction Phase: Generate all SVG pages → svg_output/
    └── Logic Construction Phase: Generate complete script → notes/total.md
    ↓
[Post-processing] → total_md_split.py (split notes) → finalize_svg.py → svg_to_pptx.py
    ↓
Output: SVG + PPTX (auto-embeds notes)
    ↓
[Optimizer_CRAP] (Optional, only if the first full draft is unsatisfactory)
    ↓
If optimized: re-run post-processing and export

📖 For detailed workflow, see Workflow Tutorial and Role Definitions

💡 PPT Editing Tip: The exported PPTX pages are in SVG format. To edit the content, select the page content in PowerPoint, right-click and choose "Group" -> "Ungroup" (or "Convert to Shape"). This feature requires Office 2016 or later.

🛠️ Common Commands


# Initialize project
python3 tools/project_manager.py init <project_name> --format ppt169

# PDF to Markdown
python3 tools/pdf_to_md.py <PDF_file>

# Post-process SVG
python3 tools/finalize_svg.py <project_path>

# Export PPTX
python3 tools/svg_to_pptx.py <project_path> -s final

📖 For complete tool documentation, see Tools Usage Guide

📁 Project Structure


ppt-master/
├── roles/          # AI role definitions (6 professional roles)
├── docs/           # Documentation center (tutorials, design guides, format specs)
├── templates/      # Template library (chart templates + 640+ icons)
├── tools/          # Toolset (project management, conversion, processing)
├── examples/       # Example projects (15 complete cases)
└── projects/       # User project workspace

❓ FAQ

Q: How to use generated SVG files?

Open directly in browser to view
Export to PowerPoint using svg_to_pptx.py (Note: Requires "Convert to Shape" in PPT for editing, Office 2016+ required)
Embed in HTML pages or edit with design tools

Q: What's the difference between the three Executors?