
PPTAgent
输入主题,自动生成专业级 PPT,省时省力。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5228
技术标签
使用教程
环境要求
- Linux 或 macOS 环境(Windows 不支持,需使用 WSL)
- 已安装 uv(可用官方安装脚本一键安装)
- 已安装 Docker,用于拉取或构建 host / sandbox 镜像
- 已安装 Node.js 与 npm,用于安装 html2pptx 前端依赖
- 首次运行需联网下载模型与镜像
安装与启动步骤
-
1安装 uv 工具
uv 用于创建虚拟环境、安装项目和运行 CLI,官方脚本会自动下载并安装。
curl -LsSf https://astral.sh/uv/install.sh | sh -
2交互式初始化
首次使用建议先跑最小任务,交互式生成并更新配置文件,验证依赖与环境是否正常。
uvx pptagent onboard -
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准备配置文件
使用 Docker Compose 或源码构建时需手动复制示例配置,CLI 方式可由 onboard 自动生成。
cp deeppresenter/config.yaml.example deeppresenter/config.yaml cp deeppresenter/mcp.json.example deeppresenter/mcp.json -
5源码安装依赖
以可编辑模式安装 Python 项目,并安装 Playwright 浏览器及 html2pptx 的 npm 依赖。
uv pip install -e . playwright install-deps playwright install chromium npm install --prefix deeppresenter/html2pptx -
6下载语言识别模型
通过 modelscope 下载 fasttext 语言识别模型,供生成流程判断语言使用。
modelscope download forceless/fasttext-language-id -
7启动 Web UI
在项目根目录运行 webui.py 启动应用,浏览器打开 Web UI 界面即可开始生成 PPT。
python webui.py
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
deeppresenter/config.yaml | 是 | 主配置文件,由 config.yaml.example 复制或 onboard 交互生成 | deeppresenter/config.yaml |
deeppresenter/mcp.json | 是 | MCP 工具配置文件,由 mcp.json.example 复制生成 | deeppresenter/mcp.json |
如何确认成功
运行 python webui.py 后无报错,浏览器打开 Web UI 页面并能正常使用,即表示启动成功。
常见问题
Q:Windows 系统可以安装吗?
A:官方明确不支持 Windows。如果在 Windows 上使用,请先安装并进入 WSL 环境,再按本文步骤操作。
Q:配置项怎么写?
A:使用 CLI 时执行 pptagent onboard,可交互式创建和更新配置;使用 Docker Compose 或源码构建时,需手动复制 config.yaml.example 与 mcp.json.example。
Q:Docker 镜像拉取太慢怎么办?
A:改用 1ms.run 镜像源,例如 docker pull docker.1ms.run/forceless/deeppresenter-host,再用 docker tag 改成对应的本地镜像名。
Q:不想用官方镜像可以自己构建吗?
A:可以。用仓库内的 Dockerfile 构建:docker build -t deeppresenter-sandbox -f deeppresenter/docker/SandBox.Dockerfile . 以及 Host 对应的 Dockerfile。
Q:怎么快速确认环境没问题?
A:官方强烈建议先跑 CLI 和最小任务,确认依赖与环境配置正确后再做完整生成。
注意事项
- 项目不支持 Windows,请使用 WSL。
- 官方建议先使用 CLI 与最小任务验证依赖与环境。
- Docker 镜像有 Docker Hub 与 1ms.run 两个来源,国内建议用镜像源。
- 源码方式需要 Playwright 浏览器依赖和 html2pptx 的 npm 依赖,缺一不可。
核心亮点
- 反思式生成机制,能根据内容逻辑自动调整页面布局和重点,提升演示效果
- 支持从文本、数据等多源输入中提取关键信息,减少手动整理工作量
- 基于 Python,模块化设计,便于开发者二次开发和集成到现有工作流
不足之处
- 依赖外部渲染服务或库,部署环境要求较高
- 生成效果受输入材料质量影响,复杂图表支持有限
适用场景
- 职场人士快速制作汇报、提案等演示文稿
- 教育领域自动生成课程讲义或课件
- 企业批量生成标准化产品介绍或培训材料
替代项目
python-pptx、Slidev、Marp
上一篇:Decepticon
下一篇:aci
同类项目推荐
awesome-ai-agent
开源
一页看懂 AI Agent 学习路线与资源地图
AI Agent 资源汇总,不限于基础概念、Harness 实践、RAG、测评基准、感知记忆、开源项目推···
AI4VisualNovel
开源
多智能体分工写视觉小说,剧情对话一键生成
A LLMs Multi-Agents framework for VisualNovel
agenta
开源
一站式搭建、调试和监控 AI 智能体,团队协作更高效。
Agenta is a workspace where you and your team build agents and automations.
workers-research
开源
在边缘网络上,用 AI 自动完成深度研究并生成报告。
A serverless, AI-powered deep research agent built with Cloudflare Workers and Googl···
hermes-incident-commander
开源
让 AI 自动发现、修复并学习生产故障,运维不再熬夜
Autonomous SRE agent that detects, diagnoses, and self-heals production incidents - ···
Jumping-Agent-platform
开源
像玩游戏一样,轻松搭建你的 AI 智能体。
Build your own AI agent through gameplay.
oh-my-agent
开源
把多个AI智能体编成团队,按你的工程标准干活
Agent skills and specialist teams for Claude Code, Codex, Cursor and other coding ag···
open-terminal
开源
用 curl 把电脑变成 AI 可操控的终端
A computer you can curl ⚡
oryxos
开源
像管进程一样管 AI Agent,分布式调度开箱即用
OryxOS is an open-source Distributed AI Agent OS