
5分钟上手 PPTAgent从零安装到生成第一份 PPT 的最快路径【免费下载链接】PPTAgent项目地址: https://gitcode.com/icip-cas/PPTAgentPPTAgent 是一款由 ICIP-CAS 团队开源的AI 智能 PPT 生成工具输入一个主题或上传一份文档它就能自动完成大纲规划、内容生成、版式设计最终输出可编辑的专业 PPT 文件。本文将从安装、配置到第一次生成演示文稿带你走通最快上手路径全程约 5 分钟 ⏱️先认识 PPTAgent它能做什么PPTAgent 的核心能力是文档转 PPT / 文本转 PPT主要有两大生成模式模式说明 自由生成Freeform由设计智能体自由发挥视觉设计适合创意类、汇报类演示 模版模式Templates基于参考 PPT 模板学习版式与结构风格统一可控它的工作流程是两阶段的先解析演示文稿提取版式、功能类型、内容模式再生成演示文稿规划大纲 → 选版式 → 填充内容与图片。整体流程如下图安装前须知3 件小事动手前花 30 秒确认环境能避免 80% 的安装坑 项目要求操作系统Linux / macOSWindows 请使用 WSL运行环境Python 3.11内存 8GB 起步有 GPU 更佳模型配置一个 LLM API KeyOpenAI 兼容接口均可或在向导里一键配置本地模型 官方强烈建议先用 CLI 跑一个最小任务确认依赖与环境没有问题后再做复杂生成。安装步骤3 种方式任选其一方式一CLI 一键安装新手首选最快CLI 是最省心的路径安装命令如下# 首次运行交互式配置向导 uvx pptagent onboard # 5分钟后生成你的第一份 PPT uvx pptagent generate Single Page with Title: Hello World -o hello.pptx其中onboard是一个交互式配置向导它会自动帮你完成✅ 检查 Docker 镜像、Playwright 浏览器、Node.js、poppler 等依赖macOS 上可自动安装✅ 生成模型配置文件和工具配置文件✅ 可选择一键部署本地模型推理服务免 API Key方式二源码安装适合二次开发git clone https://gitcode.com/icip-cas/PPTAgent cd PPTAgent uv pip install -e . playwright install-deps playwright install chromium npm install --prefix deeppresenter/html2pptx docker pull forceless/deeppresenter-sandbox docker pull forceless/deeppresenter-host然后启动 WebUI打开浏览器即可操作 python webui.py入口代码见 webui.py依赖清单定义在 pyproject.toml。方式三Docker Compose 部署适合服务器docker pull forceless/deeppresenter-host docker pull forceless/deeppresenter-sandbox docker compose up -d服务启动后访问http://localhost:7861即可打开 Web 界面。编排配置见 docker-compose.yml。配置模型只需看懂 2 个文件如果使用 CLIpptagent onboard已自动完成配置其他方式则需要手动复制示例文件再填写cp deeppresenter/config.yaml.example deeppresenter/config.yaml cp deeppresenter/mcp.json.example deeppresenter/mcp.json两个文件各管一摊职责非常清晰deeppresenter/config.yaml.example模型配置——为research_agent研究、design_agent设计等角色分别填写base_url、model、api_keydeeppresenter/mcp.json.example工具配置——搜索、文档解析、沙箱执行等 20 工具的接入方式生成第一份 PPT常用命令速查核心命令就一个generate掌握 4 个参数即可应付绝大多数场景 uvx pptagent generate 你的主题 \ -f data.xlsx \ # 可选附加资料文件 -f charts.pdf \ # 可选多个附件可重复使用 -f -p 10-12 \ # 可选指定页数范围 -o report.pptx # 输出文件命令作用pptagent onboard交互式配置向导pptagent generate生成演示文稿pptagent config查看当前配置pptagent reset重置配置pptagent serve启动 CLI 依赖的本地推理服务命令实现位于 deeppresenter/cli/commands.py多角色智能体研究、设计、规划定义在 deeppresenter/agents/ 目录下想深入了解架构可以从这里入手。效果预览你的 PPT 会长这样以下均为 PPTAgent 的真实生成结果。给一句提示词「请介绍小米 SU7 的外观和价格」生成的封面页效果再比如输入「制作一份高中课堂展示课件主题为解码立法过程」生成的课堂演示幻灯片可以看出图片选择、配色、标题排版都已自动完成输出的是标准 .pptx 文件可在 PowerPoint / WPS 中继续二次编辑。进阶加分项3 个可选增强服务基础功能跑通后按需开启以下服务可显著提升生成质量服务提升效果配置位置Tavily 搜索研究深度更好联网检索更准mcp.json中填TAVILY_API_KEYMinerUPDF 解析质量大幅提升mcp.json中填MINERU_API_KEY或本地部署文生图模型图片素材更精美config.yaml中配置t2i_model如果希望完全离线运行不使用联网搜索等工具将 deeppresenter/config.yaml 中的offline_mode设为true即可。更多可配置项参考 deeppresenter/utils/constants.py。常见问题 FAQQ1Windows 上装不了项目目前不支持 Windows 原生环境请安装 WSLWindows Subsystem for Linux后按本文步骤操作。Q2没有 API Key 能用吗可以。onboard向导支持一键配置本地模型推理服务本地跑通后再考虑接入云端模型。Q3生成速度慢怎么办生成时间与页数、附件大小成正比建议先用小任务如单页 PPT验证环境再逐步放大任务规模。总结回顾一下这条 5 分钟路径uvx pptagent onboard配置 →uvx pptagent generate生成 → 打开 .pptx 文件三步完成。PPTAgent 把「研究、设计、排版」这三件最耗时的工作交给了 AI 智能体你只需专注主题本身。完整使用文档参见 README.md 与 pptagent/DOC.md祝生成愉快 ✨【免费下载链接】PPTAgent项目地址: https://gitcode.com/icip-cas/PPTAgent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考