PPTAgent

环境要求

• Linux 或 macOS 环境（Windows 不支持，需使用 WSL）
• 已安装 uv（可用官方安装脚本一键安装）
• 已安装 Docker，用于拉取或构建 host / sandbox 镜像
• 已安装 Node.js 与 npm，用于安装 html2pptx 前端依赖
• 首次运行需联网下载模型与镜像

安装与启动步骤

1. 1安装 uv 工具

   uv 用于创建虚拟环境、安装项目和运行 CLI，官方脚本会自动下载并安装。

   curl -LsSf https://astral.sh/uv/install.sh | sh

   复制

2. 2交互式初始化

   首次使用建议先跑最小任务，交互式生成并更新配置文件，验证依赖与环境是否正常。

   uvx pptagent onboard

   复制

3. 3拉取运行镜像

   运行时需要 sandbox 与 host 两个镜像，拉取后重命名成 README 指定的本地镜像名。国内可用 1ms.run 镜像加速。

   docker pull forceless/deeppresenter-sandbox
   docker pull forceless/deeppresenter-host
   docker tag forceless/deeppresenter-sandbox deeppresenter-sandbox
   docker tag forceless/deeppresenter-host deeppresenter-host

   复制

4. 4准备配置文件

   使用 Docker Compose 或源码构建时需手动复制示例配置，CLI 方式可由 onboard 自动生成。

   cp deeppresenter/config.yaml.example deeppresenter/config.yaml
   cp deeppresenter/mcp.json.example deeppresenter/mcp.json

   复制

5. 5源码安装依赖

   以可编辑模式安装 Python 项目，并安装 Playwright 浏览器及 html2pptx 的 npm 依赖。

   uv pip install -e .
   playwright install-deps
   playwright install chromium
   npm install --prefix deeppresenter/html2pptx

   复制

6. 6下载语言识别模型

   通过 modelscope 下载 fasttext 语言识别模型，供生成流程判断语言使用。

   modelscope download forceless/fasttext-language-id

   复制

7. 7启动 Web UI

   在项目根目录运行 webui.py 启动应用，浏览器打开 Web UI 界面即可开始生成 PPT。

   python webui.py

   复制

关键配置

如何确认成功

运行 python webui.py 后无报错，浏览器打开 Web UI 页面并能正常使用，即表示启动成功。

常见问题

注意事项

• 项目不支持 Windows，请使用 WSL。
• 官方建议先使用 CLI 与最小任务验证依赖与环境。
• Docker 镜像有 Docker Hub 与 1ms.run 两个来源，国内建议用镜像源。
• 源码方式需要 Playwright 浏览器依赖和 html2pptx 的 npm 依赖，缺一不可。