presenton

Q: Windows 下挂载目录报错？

PowerShell 中使用 ${PWD}/app_data:/app_data 的写法，而不是 Bash 的 ./app_data:/app_data。

用 AI 自动生成专业 PPT，开源免费可自托管

开源 🏷️基础免费，高级付费 ✅ 目前可打开智能体 🍴 复刻 1768 🐛 待处理 36 👀 关注 55

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 11794

维护状态活跃

是否开源开源

定价模式 🏷️基础免费，高级付费提供免费在线生成演示文稿，可能包含基础功能免费，高级功能付费。具体价格未明确，需访问官网查看。

项目预览

项目数据

分类智能体

开发团队presenton

官网地址https://presenton.ai

GitHubhttps://github.com/presenton/presenton

定价模式🏷️基础免费，高级付费

价格说明提供免费在线生成演示文稿，可能包含基础功能免费，高级功能付费。具体价格未明确，需访问官网查看。

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型ai-agent,ai-presentation,api,gamma,powerpoint-agent,powerpoint-ai,powerpoint-generation,presentation,presentation-agent

GitHub 星标★ 11794

上线时间2025-05-10 00:00:00

代码更新2026-11-06

仓库体积1.20 GB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

Presenton 是一个开源的 AI 演示文稿生成器，提供 API 接口，可作为 Gamma、Canva、Beautiful AI 等商业工具的替代方案。它解决的是用户快速制作专业演示文稿的需求，通过 AI 自动生成内容结构和设计。核心能力包括：基于 TypeScript 构建，支持智能体（ai-agent）驱动的自动化生成流程，能够输出 PowerPoint 等格式文件；提供 API 便于集成到其他应用；强调免费和开源，用户可自托管。项目处于成长阶段，GitHub 星标近万，社区活跃，适合开发者、内容创作者和企业用户使用。

Star 增长趋势

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

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

技术标签

ai-agent api presentation

使用教程

难度：入门约 10 分钟部署方式：Docker 7 步

环境要求

Docker（使用 Docker 方式运行时需要）
Node.js (LTS) 与 npm（使用 Electron 桌面版时需要）
Python 3.11 与 uv（Electron 桌面版内置的 FastAPI 后端 servers/fastapi 需要）
LLM 与图像服务供应商的 API Key（在应用内配置）

安装与启动步骤

1选择运行方式

README 提供两种方式：Docker 一条命令即可运行；Electron 桌面应用适合开发或离线使用，两选一即可。
2Docker 启动（Linux/macO

在 Bash/Zsh 中执行，把容器 80 端口映射到本机 5001，并把 app_data 目录挂载出来持久化数据。
```
docker run -it --name presenton -p 5001:80 -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest
```
3Docker 启动（Windows）

在 PowerShell 中执行，区别仅是挂载路径写法使用 ${PWD}，其余参数与 Linux/macOS 相同。
```
docker run -it --name presenton -p 5001:80 -v "${PWD}\app_data:/app_data" ghcr.io/presenton/presenton:latest
```
4打开 Web 界面

容器启动后，用浏览器访问 http://localhost:5001 即可使用 Presenton，并在界面内配置 LLM 与图像服务。
5Electron 首次初始化

进入 electron 目录执行 setup:env，它会安装 Node 依赖、在 FastAPI 中执行 uv sync 并安装 Next.js 依赖。
```
cd electron
npm run setup:env
```
6Electron 开发运行

执行 npm run dev，会编译 TypeScript 并启动 Electron，后端与界面在桌面窗口中本地运行。
```
npm run dev
```
7打包桌面安装包（可选）

如需 Windows/macOS/Linux 安装包，依次执行 build:all 与 dist，产物输出到 electron/dist 目录。
```
npm run build:all
npm run dist
```

关键配置

配置项	必填	说明	示例
`PRESENTON_HTTP_HOST_PORT`	否	使用 Docker Compose 时指定对外暴露的宿主机端口	`8080`
`FAST_API_INTERNAL_URL`	否	Next.js 与 FastAPI 不同源时指定后端地址，未写入 docker-compose.yml	`http://localhost:8000`

如何确认成功

浏览器打开 http://localhost:5001，能看到 Presenton 界面并能进入演示文稿生成流程即启动成功。

常见问题

Q：5001 端口已被占用怎么办？

A：把命令中的 5001 换成其他端口号即可，例如 -p 8080:80；使用 Docker Compose 时可设置 PRESENTON_HTTP_HOST_PORT，如 PRESENTON_HTTP_HOST_PORT=8080 docker compose up production。

Q：Windows 下挂载目录报错？

A：PowerShell 中使用 ${PWD}\app_data:/app_data 的写法，而不是 Bash 的 ./app_data:/app_data。

Q：在哪里填写 LLM 和图像服务的 API Key？

A：Electron 桌面版可直接在应用内配置 LLM 与图像服务供应商；Docker 方式下前端与后端读取同名环境变量，可写在 compose 文件旁的 .env 中。

Q：还有哪些环境变量可用？

A：README 未逐一列出，可查看 servers/fastapi/utils/get_env.py 以及 servers/nextjs/ 下的服务端工具文件获取受支持的变量名。

Q：macOS 打包成公开 DMG 需要什么？

A：需要先完成 Developer ID 与公证的一次性配置（见 docs/macos/dev/direct-distribution.md），再在 electron 目录执行 APPLE_KEYCHAIN_PROFILE="presenton-notary" npm run build:all:mac:signed。

注意事项

README 只提供 Docker 与 Electron 桌面应用两种运行方式，未说明其它部署形式。
Electron 方式依赖 Node.js (LTS)、npm、Python 3.11 和 uv，运行前请先装齐。
Docker 镜像是 ghcr.io/presenton/presenton:latest，建议按需改为固定版本标签。
docker-compose.yml 中还有 production、production-gpu、development、development-gpu 等配置，可按需选择。