Merge pull request #192 from TencentCloudADP/example/ppt

feat: add ppt-gen dependency group and update README

Author: Lightblues

examples/ppt_gen/README.md

@@ -1,21 +1,37 @@
 # PowerPoint Template Example
 
-## Quick Start
+## Prerequisites
 
-Download [template files](https://drive.google.com/drive/folders/1oZYoHBJJwzAzhrpvnUnklvU7LcS4oFz6?usp=sharing) to `examples/ppt_gen/template` directory.
+This example requires additional dependencies for image processing, document handling, and visualization.
 
-Prepare the reference resource (plain text / markdown / html webpage) for PPT generation. For example, download the [Nobel Prize webpage](https://www.nobelprize.org/prizes/physics/2025/popular-information/).
+**Install dependencies:**
 
+```bash
+# Navigate to project root
+cd youtu-agent
+
+# Install PPT generation dependencies
+uv sync --extra ppt-gen
 ```
-wget https://www.nobelprize.org/prizes/physics/2025/popular-information/ -O webpage.html
-```
 
-`cd` into `examples/ppt_gen`
+## Quick Start
+
+Download [template files](https://cdn.jsdelivr.net/gh/TencentCloudADP-DevRel/picgo-images@main/assets/templates.zip) to `examples/ppt_gen/templates` directory.
+
+Navigate to the example directory, prepare the reference resource (plain text / markdown / html webpage) for PPT generation. For example, download the [Nobel Prize webpage](https://www.nobelprize.org/prizes/physics/2025/popular-information/).
 
-Run `main.py`
+```bash
+# Navigate to the example directory
+cd examples/ppt_gen
 
+# Download sample webpage
+wget https://www.nobelprize.org/prizes/physics/2025/popular-information/ -O webpage.html
 ```
-python main.py --file webpage.html --template_path template/0.pptx --pages 15
+
+Run the PPT generation script.
+
+```python
+python main.py --file webpage.html --template_path templates/0.pptx --pages 15
 ```
 
 The script will produce a `json` file and a `pptx` file if everything is OK.

pyproject.toml

@@ -83,6 +83,14 @@ utils = [
     "docker>=7.1.0",
     "tiktoken>=0.11.0",
 ]
+# PPT generation example dependencies
+ppt-gen = [
+    "pillow>=11.3.0",
+    "python-pptx>=1.0.2",
+    "pymupdf>=1.26.4",
+    "matplotlib>=3.10.6",
+]
+
 
 
 [dependency-groups]