banana-slides

上传模板说句话，AI 自动生成可编辑 PPT

banana-slides 是一个基于 nano banana pro 模型的原生 AI PPT 生成应用，主打“Vibe PPT”体验。它解决传统 PPT 制作耗时、排版繁琐的问题，让用户通过自然语言即可快速生成演示文稿。核心能力包括：上传任意模板图片作为视觉风格参考，自动解析并适配；上传素材（如文档、图片）后智能提取关键信息；支持一句话、大纲或页面描述三种输入方式生成幻灯片；用户可口头指定修改区域，AI 精准调整；最终一键导出为可编辑的 PPT 文件。项目采用 TypeScript 构建，技术栈现代，目前已在 GitHub 获得 15.4k 星标，属于知名开源项目。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 15649

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队Anionex

所属国家

官网地址http://bananaslides.online

GitHubhttps://github.com/Anionex/banana-slides

定价模式free

价格说明开源项目，基于AGPL-3.0许可证，可自行部署使用，无付费版本。

访问状态

是否开源是

开源协议AGPL-3.0

主要语言TypeScript

技术栈/模型ai-ppt-maker,ai-slide-builder,ai-slides,editable-pptx,llm,nanobananapro,ppt,ppt-generator,slides,text2image

GitHub 星标★ 15649

30天Star增速

HF 下载量

上线时间2025-11-29 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

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

环境要求

Docker 与 Docker Compose（Windows/macOS 需安装 Docker Desktop 并保持运行，推荐启用 WSL 2 后端）
端口 3011（前端）和 5011（后端）未被占用
至少一个大模型厂商的 API Key（如 Gemini / OpenAI / 豆包 / DeepSeek / 通义千问 / 智谱 GLM 等）
源码部署需额外安装 uv、Node.js 与 npm

安装与启动步骤

1克隆代码仓库

把项目源码下载到本地并进入项目根目录，后续所有命令都在该目录下执行。
```
git clone https://github.com/Anionex/banana-slides
cd banana-slides
```
2生成环境变量文件

从模板复制出 .env，稍后在里面填写 API 密钥。默认 .env 不包含真实密钥，必须自己配置。
```
cp .env.example .env
```
3填写 API 密钥

编辑 .env，按需设置 AI_PROVIDER_FORMAT 及各厂商 API Key；也可跳过，启动后在界面里配置。
4启动容器服务

推荐用预构建镜像快速启动，跳过本地构建；也可用 docker compose up -d 从头构建镜像。
```
docker compose -f docker-compose.prod.yml up -d
```
5访问应用

浏览器打开前端地址即可使用，后端 API 在 5011 端口，两者都需正常监听。
6源码部署后端

不使用 Docker 时：安装 uv、同步 Python 依赖、执行数据库迁移并启动后端服务。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync
cd backend
uv run alembic upgrade head && uv run python app.py
```
7源码部署前端

进入 frontend 目录安装 npm 依赖并启动开发服务器，通过 Vite proxy 连接默认后端 5011。
```
cd frontend
npm install
npm run dev
```

关键配置

配置项	必填	说明	示例
`AI_PROVIDER_FORMAT`	是	指定大模型接口格式，可选 gemini/openai/volcengine/vertex/lazyllm	`gemini`
`GOOGLE_API_KEY`	否	AI_PROVIDER_FORMAT=gemini 时使用的 Google 模型密钥	`your-api-key-here`
`TEXT_MODEL_SOURCE`	否	选择文本生成所使用的模型厂商	`deepseek`
`IMAGE_MODEL_SOURCE`	否	选择图片编辑/生成所使用的模型厂商	`doubao`
`IMAGE_CAPTION_MODEL_SOURCE`	否	选择图片描述所使用的模型厂商	`qwen`
`BAIDU_API_KEY`	否	百度智能云密钥，用于新版可编辑 PPT 导出，有免费额度	`your-baidu-api-key`

如何确认成功

执行 curl http://localhost:5011/health 验证后端正常，浏览器访问 http://localhost:3011 能打开前端界面即成功。

常见问题

Q：启动后无法访问页面怎么办？

A：确认 Docker 正在运行，且端口 3011 与 5011 未被其他程序占用；Windows 用户建议在 Docker Desktop 中启用 WSL 2 后端。

Q：拉取镜像或安装依赖很慢怎么办？

A：在 .env 中取消 DOCKER_REGISTRY、GHCR_REGISTRY、APT_MIRROR、PYPI_INDEX_URL、NPM_REGISTRY 等镜像源配置的注释，再重新运行启动命令。

Q：必须先配置 API Key 才能启动吗？

A：不是。可以先用默认配置启动，再在应用界面内配置模型密钥；但未配置密钥时无法真正生成幻灯片。

Q：升级前需要做什么准备？

A：若本地已有重要数据，先备份数据库：cp backend/instance/database.db backend/instance/database.db.bak；模板、素材、成品默认在 uploads/ 文件夹中。

Q：使用 Vertex AI 需要注意什么？

A：把 GCP 服务账号 JSON 密钥保存为项目根目录的 gcp-service-account.json，设置 AI_PROVIDER_FORMAT=vertex、VERTEX_PROJECT_ID、VERTEX_LOCATION=global，Docker 部署还需在 docker-compose.yml 中挂载密钥文件。

注意事项

Google nano banana pro 模型接口调用费用较高，请留意成本。
项目中大模型接口以 AIHubMix 平台格式为标准，推荐使用 AIHubMix 获取 API 密钥以减少迁移成本。
预构建镜像为 anoinex/banana-slides-frontend:latest 与 anoinex/banana-slides-backend:latest，同步主分支最新版本。
启动后可在应用内「设置 → 关于 → 检查更新」按当前版本 SHA 判断是否有可用更新。

核心亮点

支持任意模板图片上传，AI 自动模仿版式，告别固定模板限制
多种输入方式（一句话/大纲/描述）灵活生成，降低使用门槛
口头指令修改指定区域，交互直观，省去手动调整

不足之处

依赖 nano banana pro 模型，可能受限于模型能力或 API 成本
文档/社区待观察

适用场景

快速制作工作汇报或项目提案，只需提供要点即可生成初稿
教学课件制作，上传教材素材自动生成结构化幻灯片
创意演示设计，上传灵感模板快速产出风格化 PPT

替代项目

Slidev、Marp、Presenta

项目介绍

banana-slides 是办公效率领域的开源项目，由 Anionex 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（15,649）位列前 4%，在办公效率分类的 142 个项目里位列前 8%。

近 41 天，它的 GitHub 星标从 15,438 增加到 15,649，净增 211。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。基于AGPL-3.0许可证，可自行部署使用，无付费版本。

它主要面向的使用场景是：快速制作工作汇报或项目提案，只需提供要点即可生成初稿。同类可对比的替代方案包括 Slidev、Marp、Presenta。

上一篇：meetily

下一篇：QOwnNotes