PPTAgent（DeepPresenter）
通过反思式代理流程生成并导出 PowerPoint 演示文稿。
- Star 数
- ★ 5.2k
- 最近更新
- 4 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 34/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要把项目文档整理成演示文稿的研究人员，可提供文档并生成 PPTX。
- 不适合
- Windows 用户：项目明确不支持 Windows，只能改用 WSL
- 希望零配置开箱即用的团队：需准备 Docker、Playwright、Chromium、Node.js 等依赖
这个 Agent 能做什么，适合哪些场景？
PPTAgent 仓库当前提供 DeepPresenter：一个用于生成演示文稿的代理式框架。它提供本地 CLI、Web UI、Docker Compose 部署，以及用于隔离工具执行的 sandbox 运行时。用户可用提示词调用 pptagent generate，并附加如 XLSX 或 PDF 的文件，生成 .pptx 输出。项目还提供 MCP server 配置支持，并可通过本地部署 MinerU 与 offline_mode: true 避免加载依赖网络的工具。
CLI 的 pptagent onboard 用于交互式创建或更新配置，pptagent generate 接收演示需求、-f 附件、可选的 -p 页码范围和 -o 输出路径，并生成 PowerPoint 文件。源码部署路径使用 deeppresenter/config.yaml 与 deeppresenter/mcp.json；可选接入 Tavily 改进网页搜索、MinerU 改进 PDF 解析，以及通过 t2i_model 配置文本生成图像模型。开发模式可运行 python webui.py，服务部署可运行 docker compose up -d 并在 http://localhost:7861 提供 Web UI。运行时使用 deeppresenter-host 处理 Web UI 和编排，使用 deeppresenter-sandbox 执行隔离工具任务；构建源码时还会安装 deeppresenter/html2pptx 的 Node 依赖。
- 需要把项目文档整理成演示文稿的研究人员，可提供文档并生成 PPTX。
- 需要制作季度汇报的业务人员，可将
data.xlsx与charts.pdf一同传给pptagent generate。 - 希望从提示词快速得到单页标题幻灯片的个人用户，可运行
uvx pptagent generate "Single Page with Title: Hello World" -o hello.pptx。 - 需要在自己的服务器上提供演示文稿生成界面的团队，可通过 Docker Compose 启动主机服务和沙箱运行时。
- 在无外网环境处理资料的部署者，可本地部署 MinerU 并启用
offline_mode: true。
如何安装或部署这个 Agent？
建议先通过 CLI 完成首次配置：
uvx pptagent onboard随后可生成首个文件：
uvx pptagent generate "Single Page with Title: Hello World" -o hello.pptx从源码开发时，文档给出的步骤包括：
uv pip install -e .
playwright install-deps
playwright install chromium
npm install --prefix deeppresenter/html2pptx并准备配置文件：
cp deeppresenter/config.yaml.example deeppresenter/config.yaml
cp deeppresenter/mcp.json.example deeppresenter/mcp.jsonTavily 和 MinerU 均为可选服务；使用其托管服务时分别在 deeppresenter/mcp.json 设置 TAVILY_API_KEY 或 MINERU_API_KEY。所给材料未列出核心模型配置所需的具体凭据字段。
如何使用这个 Agent？
完成 pptagent onboard 后，使用 pptagent generate 提交需求并指定输出文件。例如：
uvx pptagent generate "Q4 Report" -f data.xlsx -f charts.pdf -p "10-12" -o report.pptx要运行源码版 Web UI，执行 python webui.py。要部署服务器版，准备或构建 deeppresenter-host 与 deeppresenter-sandbox 镜像后执行 docker compose up -d，Web UI 地址为 http://localhost:7861。若需要离线运行，在配置中设置 offline_mode: true，并本地部署 MinerU。
这个 Agent 有哪些优点和局限？
- 同时提供 CLI、源码 Web UI 和 Docker Compose 三种交付方式，适合个人使用与服务器部署。
- CLI 可接收多个附件、页码范围和明确的 PPTX 输出路径，适合文档与数据文件驱动的生成流程。
- 运行时将编排主机与隔离工具执行拆分为
deeppresenter-host和deeppresenter-sandbox两个镜像。 - 文档提供 MCP server 配置入口，并可选用 Tavily、MinerU 和文本生成图像模型增强质量。
- Windows 不受支持；Windows 用户需要使用 WSL。
- 源码安装包含 Docker、Playwright、Chromium、Node.js 依赖及镜像准备，环境配置成本较高。
- 网页搜索和云端 MinerU 需要网络及相应 API 密钥；离线模式需要自行部署 MinerU。
- 项目强烈建议部署其微调的 DeepPresenter 模型以获得最佳体验，材料没有列出核心模型配置的完整凭据或兼容性矩阵。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PPTAgent（DeepPresenter） 当前 | 34 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5.2k | 4 天前 | Python | — |
| Presenton——开源 AI 演示文稿生成器与 API | 56 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 12k | 1 天前 | TypeScript | — |
| OfficeCLI | 71 · 存在缺口 | 命令行工具免费 | ★ 33k | 7 天前 | C# | Codex · Claude Code |
| Paper2Any 科研内容工作台 | 63 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 2.8k | 2 个月前 | Python | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：项目使用Docker沙箱隔离工具执行，提供离线模式，但未明确最小权限原则；CLI生成命令无用户确认步骤；数据流透明度有限，仅提及配置文件和API密钥；敏感数据处理未提及；依赖众多且未提供安全审计；外部效果包括网络搜索和文件生成，但未明确副作用；无回滚机制；来源归属有贡献者列表和引用，但发布者未验证。扣分：缺少用户确认、敏感数据处理、依赖安全、回滚机制。
证据显示：项目有测试文件（test_apis.py, conftest.py），但测试依赖外部模型和API，未提供完整测试结果；依赖众多且部分来自外部服务（Tavily, MinerU），可用性依赖外部；失败消息未在文档中明确。扣分：失败消息缺失，测试覆盖有限。
证据显示：README提供多种使用场景（CLI、Docker、源码），支持多语言，但未明确能力边界；触发精度一般，CLI命令明确但内部触发机制未详述；环境适配有限，仅支持Linux/macOS，Windows不支持。扣分：能力边界和触发精度不足。
证据显示：README结构清晰，提供安装说明、示例、案例，有MIT许可证，但缺少明确的版本变更日志和已知限制；命名稳定但版本动态；维护责任有贡献者列表但无明确维护者。扣分：版本变更日志和已知限制缺失。
证据显示：输出为PPTX文件，可直接使用；提供案例展示，但未提供成本效益分析；边际价值高，但依赖外部服务和模型，成本可能较高。扣分：成本效益分析缺失。
证据显示：README引用论文和模型，但未提供详细实验数据；跨来源验证有限，仅依赖自身声明；事实与推断未明确分离。扣分：事实与推断分离不足。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 发布者未验证，身份未知，需谨慎对待。
- 依赖众多且包含外部服务，需注意供应链安全。
- Windows不支持，环境适配有限。
- 缺少用户确认和回滚机制，操作需谨慎。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Pinned source release for reproducing DeepPresenter (ACL 2026). Commit: 2419d30b134a71486523e95ded60b32489fd3c61 Use the README and configuration files at this tag for reproduction instructions.在 GitHub 查看 ↗ -
v2.0.0 PPTAgent V2: DeepPresenter Integrated
发布说明摘录
Release v2.0.0 <h2>✨ New Features</h2> <p>PPTAgent V2 introduces revolutionary AI capabilities: <strong>Deep Research Integration</strong> enables intelligent multi-source content gathering and synthesis, while <strong>Free-Form Visual Design</strong> breaks traditional template constraints with flexible layouts. The new <strong>Agent Sandbox</strong> provides 30+ professional tools in a secure execution environment for autonomous asset creation. <strong>AI-powered image generation</strong> transforms text descriptions into custom illustrations, and <strong>DeepPresenter Integration</strong …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * Bump axios from 1.7.7 to 1.8.2 in /pptagent_ui by @dependabot[bot] in https://github.com/icip-cas/PPTAgent/pull/111 * feat: add section summary;refactor: use rule-based functional layout insertion; fix: deepcopy caused unstable numerical problem by @Force1ess in https://github.com/icip-cas/PPTAgent/pull/113 * proj: add bestpractice; feat: improve image schedule, markdown parse by @Force1ess in https://github.com/icip-cas/PPTAgent/pull/114 * feat: improve generated toc by @Force1ess in https://github.com/icip-cas/PPTAgent/pull/115 …在 GitHub 查看 ↗
常见问题
是否必须使用 DeepPresenter 微调模型？
能否在离线环境运行？
deeppresenter/config.yaml 中设置 offline_mode: true，以避免加载网页搜索等网络依赖工具。支持哪些输入和输出？
-f 附件以及可选 -p 页码范围；示例附件包括 XLSX 和 PDF，输出可指定为 .pptx。