Popai Presentations

PopAI PPT Skill

Create presentations programmatically via PopAI's API. Supports optional file uploads as reference material or templates.

Setup

1. Get API key from https://www.popai.pro
2. Store in environment: export POPAI_API_KEY=...

Scripts

• scripts/generate_ppt.py - Generate PPT via PopAI API (upload files → create channel → SSE stream → get pptx)

Usage Examples

# Generate PPT from topic only
python3 generate_ppt.py --query "人工智能发展趋势报告"

# With a template pptx file
python3 generate_ppt.py --query "特斯拉财报ppt" --file template.pptx

# With multiple reference files (max 5)
python3 generate_ppt.py --query "年度报告" --file template.pptx data.pdf chart.png

Agent Steps

1. Get PPT topic from user

2. If user provides local files, pass them via --file (max 5, supports pptx/pdf/docx/images etc.)

3. Create a temp output file, then run script in background with --output:

   # Step 3a: Create temp file and launch in background
   OUTFILE="/tmp/popai_ppt_$(date +%s).jsonl"
   touch "$OUTFILE"
   

   # Step 3b: Run in background (run_in_background: true, timeout: 600000)
   cd /Users/Gunnar/popai-python/.claude/skills/popai-presentations && POPAI_API_KEY="$POPAI_API_KEY" python3 scripts/generate_ppt.py --query "TOPIC" [--file FILE1 FILE2 ...] --output "$OUTFILE"
   

   Tell user: "PPT正在生成中，预计3-5分钟..."

4. Poll for progress — periodically read new lines from the output file using Read tool or cat "$OUTFILE", and show progress to user:

   • task events → show task status updates
   • search events → show "正在搜索..."
   • summary event → show generation summary
   • pptx_ready event → final result (stop polling)
   • stream_end → generation complete (stop polling) Poll every ~30 seconds until pptx_ready or stream_end appears.

5. Present final results to user:

   • Show summary text (from NODE_END event) as the generation summary
   • Show pptx_url as the download link: "下载PPT: "
   • Show web_url as the site link: "在线查看/编辑: "

Output

Event types (stdout, one JSON per line):

{"type": "task", "id": "1", "content": "搜索特斯拉最新财报数据", "status": "progressing"}
{"type": "search", "action": "Web Searching", "results": [{"title": "...", "url": "...", "snippet": "...", "date": "..."}]}
{"type": "tool_result", "event": "TOOL_CALLS-xxx", "action": "...", "result": "..."}
{"type": "summary", "text": "已完成特斯拉财报PPT的创建..."}
{"type": "stream_end"}

Final result (is_end: true):

{
  "type": "pptx_ready",
  "is_end": true,
  "pptx_url": "https://popai-file-boe.s3-accelerate.amazonaws.com/.../xxx.pptx",
  "file_name": "xxx.pptx",
  "preview_images": ["https://...0.jpeg"],
  "preview_count": 10,
  "web_url": "https://www.popai.pro/agentic-pptx/<channelId>"
}

• pptx_url: .pptx文件下载链接
• web_url: PopAI源站链接，可在线查看和编辑
• summary: NODE_END事件的最终总结文本，展示给用户作为生成摘要

Technical Notes

• Streaming: SSE stream; TOOL_CALLS-pptx event contains final .pptx download URL; last:true marks stream end
• File Upload: Presigned POST to S3 via getPresignedPost, supports any file type
• Timeout: Generation takes 3-5 minutes