PPTAgent

输入主题,自动生成专业级 PPT,省时省力。

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 622 🐛 待处理 18 👀 关注 37
GitHub ↗
GitHub 星标 ★ 5228
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

PPTAgent 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队icip-cas
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent,agentic-ai,llm,mcp,openclaw,presentation,slide
GitHub 星标★ 5228
上线时间2025-01-04 00:00:00
代码更新2026-11-09
仓库体积202.1 MB
本站数据更新2026-11-10
维护状态活跃
收录时间2026-08-09
浏览次数6

项目介绍

PPTAgent 是一个基于智能体(Agent)框架的 PowerPoint 自动生成工具,旨在解决传统 PPT 制作耗时、内容组织困难的问题。它通过反思式(Reflective)生成机制,先分析用户提供的主题或材料,再规划页面结构、提炼要点,并自动生成具有专业排版的演示文稿。核心能力包括:内容结构化抽取、多模态素材整合、模板风格适配、以及基于反馈的迭代优化。项目采用 Python 编写,易于扩展和集成,适合需要快速产出高质量 PPT 的个人和团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5228

使用教程

难度:进阶 约 20 分钟 部署方式:本地安装 7 步

环境要求

  • 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

关键配置

配置项必填说明示例
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、测评基准、感知记忆、开源项目推···

★ 328 2026-09-12
AI4VisualNovel 开源

多智能体分工写视觉小说,剧情对话一键生成

A LLMs Multi-Agents framework for VisualNovel

★ 101 2026-10-13
agenta 开源

一站式搭建、调试和监控 AI 智能体,团队协作更高效。

Agenta is a workspace where you and your team build agents and automations.

★ 4900 2026-08-09
workers-research 开源

在边缘网络上,用 AI 自动完成深度研究并生成报告。

A serverless, AI-powered deep research agent built with Cloudflare Workers and Googl···

★ 109 2026-08-09
hermes-incident-commander 开源

让 AI 自动发现、修复并学习生产故障,运维不再熬夜

Autonomous SRE agent that detects, diagnoses, and self-heals production incidents - ···

★ 75 2026-08-09
oh-my-agent 开源

把多个AI智能体编成团队,按你的工程标准干活

Agent skills and specialist teams for Claude Code, Codex, Cursor and other coding ag···

★ 1376 2026-08-09
open-terminal 开源

用 curl 把电脑变成 AI 可操控的终端

A computer you can curl ⚡

★ 3527 2026-08-09
oryxos 开源

像管进程一样管 AI Agent,分布式调度开箱即用

OryxOS is an open-source Distributed AI Agent OS

★ 207 2026-10-01