Presenton 开源 AI 演示文稿生成器完整上手指南：一条命令部署，10 套模板开箱即用
【免费下载链接】presentonOpen-Source AI Presentation Generator and API (Gamma, Canva, Beautiful AI, Decktopus, Presentations AI Alternative)项目地址: https://gitcode.com/GitHub_Trending/pr/presenton
周一早上九点一刻，你发现 30 分钟后要交的季度汇报还只是桌面上一堆零散的数字和旧截图。Presenton 是一个开源 AI 演示文稿生成器：给它一个主题或一份文档，它就产出带大纲、正文和配图的完整初稿，你可以直接在编辑器里拖拽微调，再导出成可编辑的 PPTX。当前版本为 0.9.10-beta，内置 10 套模板、支持 15 种文本模型提供方，全部处理可以留在你自己的机器上。
🎯 价值速览：30 秒判断你是否需要这个 AI 演示文稿生成器
| 使用场景 | 它能帮你做什么 | 适合谁 |
|---|---|---|
| 周报、汇报，素材不能出网 | Docker 或桌面端本地运行，配合 Ollama 全程离线生成 | 数据敏感的企业与团队 |
| 路演、提案、临时交付 | 一句话主题 + 内置模板，生成带图表和图标的大纲页面，再拖拽精修 | 商务、产品、咨询 |
| 复用公司既有视觉 | 用你自己的 PPTX 生成 AI 模板，按品牌设计出稿 | 有 VI 规范的品牌团队 |
| 定时批量出报告 | REST API 与 MCP 协议把"生成 PPT"变成一次接口调用 | 开发者、自动化管线 |
🚀 最快上手路径：从一条命令到离线部署
第一档：Docker 一键运行（最省事）。官方镜像把 FastAPI 后端、Next.js 前端和依赖都打包好了，数据默认落在挂载的./app_data目录，首次启动后在浏览器里创建管理员账号即可：
docker run -it --name presenton -p 5001:80 -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest打开http://localhost:5001就能用。文本模型与图片提供方可以在界面里配置，也可以用LLM、IMAGE_PROVIDER等环境变量在启动时锁定。
第二档：完全离线、免 API Key。把LLM设为ollama并指向本地模型，文本生成不再依赖任何云服务；配图用 Pexels 图库或本地素材。Ollama 在宿主机上跑时，容器内要用host.docker.internal访问：
docker run -it --name presenton -p 5001:80 -e LLM="ollama" -e OLLAMA_MODEL="llama3.2:3b" -e OLLAMA_URL="http://host.docker.internal:11434" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="your_key" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest如果希望连界面都不依赖浏览器，直接装桌面端：macOS（Apple Silicon/Intel）、Windows、Linux 均有安装包，LLM 与图片提供方在应用内配置，同一套环境变量同样生效。
第三档：进阶定制。多用户场景下，第一个账号自动成为主管理员，后续账号在 Admin → Users 里统一管理；无人值守部署可以用AUTH_USERNAME和AUTH_PASSWORD在首启时直接创建管理员。需要 GPU 加速本地模型时，给命令加--gpus=all并装好 NVIDIA Container Toolkit。生成模式（Standard 固定布局 / Smart 自适应布局）用PRESENTATION_GENERATION_MODE控制，细节见 docs/presentation-generation-modes.md。
💡 核心能力拆解：从一句主题到可编辑 PPTX
日常使用：模板、大纲审核与免费登录。仓库templates/目录下有 10 套模板（Momentum、Executive、Dynamic、General、Modern、Standard 等），覆盖销售复盘、领导层汇报、教育课程等场景；Standard 模式会先生成大纲让你审核，再逐页出稿。另外可以直接用 ChatGPT 账号（免费版即可）登录，无需单独申请 API Key。
效率进阶：可编辑导出与拖拽编辑器。导出的 PPTX 是原生文本框、图片、图表对象，不是截图，可以拿到 PowerPoint 或 WPS 里继续改。编辑画布支持文字、形状、表格、图片等元素的拖拽调整；人工改动会保留，AI 编辑是在你的基础上叠加，而不是推翻重来。每份演示文稿的记忆按演示隔离（基于 Mem0，本地 Qdrant + SQLite），后续让 AI 改某几页时能延续前文上下文。文本与图片提供方互相独立：文本可选 OpenAI、Google、Anthropic、Azure、Bedrock、DeepSeek、Ollama、LM Studio 等 15 个入口；图片可选 DALL·E 3、Gemini Flash、Pexels、Pixabay、ComfyUI 工作流等 9 类后端，按成本和质量分别选择。
开发者/自动化：生成 API 与 MCP 服务器。核心接口是POST /api/v1/ppt/presentation/generate，接受主题、页数（n_slides）、语气（tone六种）、信息密度（verbosity三档）、模板名、export_as等参数；文档可以先经/api/v1/ppt/files/upload上传再参与生成，实现"文档进、PPT 出"。先在 Admin → API keys 生成sk-presenton-...密钥，然后：
curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate \ -H "Authorization: Bearer sk-presenton-YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"content": "Q2 数据报告", "n_slides": 5, "tone": "professional", "template": "general", "export_as": "pptx"}'响应返回presentation_id、导出文件path与在线编辑地址edit_path（需拼接你的服务根 URL）。MCP 客户端走/mcp端点，同一把 API Key 通用，可以让智能体替你走"上传文档 → 生成 → 轮询任务"的完整流程。后端路由集中在 servers/fastapi/api/v1/，想二次定制从这里入手。
📊 实测与对比：仓库自带的压测数据怎么说
没有公开的"新旧版本耗时对比"官方口径，因此这里只引用仓库自带的负载测试报告（docs/presenton-resource-usage.md，2026-09-02 用 k6 做的受控并发测试）：每波 4 个虚拟用户，各生成 10/20/30/40 页规模的演示文稿，重复 4 波共 16 次完整生成流程，96 次 HTTP 请求与 112 项检查全部通过，失败率 0%；平稳阶段 CPU 中位占用 3.70%，内存占用 95 分位不超过 21.36%。测试目标是http://127.0.0.1:5001的单容器部署，PPTX 导出未包含在该负载内。
| 口径 | 数据 |
|---|---|
| 并发规模 | 4 用户同时生成，单波 10~40 页四种篇幅 |
| 流程成功率 | 16/16 完成，HTTP 与检查项 0 失败 |
| 资源水位（平稳段） | CPU 中位 3.70%，内存 95 分位 ≤ 21.36% |
对你来说更可预期的体验是：同一套部署下，生成、编辑、导出走的是同一条本地管线，桌面端与 Docker 端行为一致，不会出现"界面能看的、导出来是另一张图"的情况。
🏗️ 架构一眼看懂
三层解耦：FastAPI 负责生成、编辑与导出逻辑，Next.js 承担浏览器端编辑器，Electron 把两者打成原生桌面应用，数据默认写在本地app_data目录。桌面端入口在 electron/app/main.ts，导出管线实现可看electron/app/utils/export-chromium.ts，日常使用无需关心这些细节。
⚠️ 避坑与实用技巧
- 首启必须建管理员账号。第一个账号自动成为主管理员，不建就没法进后台；无人值守部署时用
AUTH_USERNAME/AUTH_PASSWORD环境变量在首启创建，别去手改app_data/userConfig.json里的认证字段，那会破坏恢复凭据。 - 容器里 Ollama 连不上 localhost。容器内的
localhost是容器自己，Ollama 跑在宿主机时必须把OLLAMA_URL写成http://host.docker.internal:11434，否则生成请求直接连接被拒。 - 改了环境变量不生效。已存在的容器不会读取新环境值，需要重建（Compose 场景用
docker compose up -d --force-recreate production）；PRESENTON_HTTP_HOST_PORT改端口同理。 - 桌面端用不了 MCP。Electron 应用默认
DISABLE_AUTH=true，MCP 服务器在其中被禁用以避免认证冲突；要接 MCP 客户端就用 Docker 部署，并确认 Key 是管理员按用户发放的。 - API Key 权限有边界。
sk-presenton-...只对 REST 和 MCP 生效，不能登录浏览器、不能改管理设置，且默认 90 天过期；定时脚本里要预留换 Key 的流程。
🌱 路线图与求助渠道
官方公开路线图在持续推进的方向包括：多人实时协作与评论、与 Notion/Slack/Confluence 的办公集成、30+ 动态图表类型与实时数据绑定、本地模型自动部署以降低离线门槛。遇到问题可以走三个渠道：Discord 社区交流模板、提示词与部署经验；GitHub Issues 提交 Bug（附日志与复现步骤）；企业级定制部署、私有化或安全审计可联系官方团队获取方案。
从一句主题到一份可编辑的 PPTX，Presenton 把整条链路都交给了你本地能控制的东西。如果你正受够了"AI 生成的 PPT 只能看不能改"，现在就可以用上面第一条命令跑起来试一份自己的汇报，觉得顺手别忘了到仓库点一个 Star。
关于 Presenton：作为 Gamma、Canva、Beautiful AI 的开源替代，Presenton 采用 Apache 2.0 协议，可自由商用；支持 Docker 自托管、Windows/macOS/Linux 桌面端，数据默认留在本地。
【免费下载链接】presentonOpen-Source AI Presentation Generator and API (Gamma, Canva, Beautiful AI, Decktopus, Presentations AI Alternative)项目地址: https://gitcode.com/GitHub_Trending/pr/presenton
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
