banana-slides README

The project's README from github.com/Anionex/banana-slides. As one markdown file: README.md.

Banana Slides

Anionex%2Fbanana-slides | Trendshift
Featured|HelloGitHub

简体中文  •  English

GitHub Stars GitHub Forks GitHub Watchers Version License
Docker Build Ask DeepWiki

一个基于 nano banana pro 🍌 的原生 AI PPT 生成应用
在几分钟内从想法到演示文稿,无需繁琐排版、口头提出修改,迈向真正的 "Vibe PPT"

🚀 在线 Demo  |  📖 文档  |  💻 桌面版 RC7  |  部署方法

如果该项目对你有用,欢迎 Star 🌟 & Fork 🍴

公开 Demo 提供 Inferera、APIMart 和火山 Agent Plan 的固定模型配置,API Key 按访客隔离。公开版不提供历史记录,请保存预览页链接以便再次访问;描述额外字段配置固定,正文和生成要求仍可编辑。设置页的各项服务测试可同时运行,分别显示结果。站主可在 .env 设置 PUBLIC_DEMO_ADMIN_PASSWORD,通过 /admin/history 口令入口查看历史。参见公开 Demo 使用与迁移说明。

❤️ 赞助

想赞助本项目?请发送邮件至 [email protected]。

点击折叠
AIHubMix 感谢 AIHubMix 赞助本项目!AIHubMix 是稳定、高并发的 AI 大模型 API 聚合平台,一个 API Key 即可接入 Claude、GPT、Gemini、DeepSeek 等主流模型,兼容多种协议。注册时,海外用户请使用 AIHubMix 入口,中国大陆用户请使用 Inferera 入口。
APIMart 感谢 APIMart 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,通过此注册链接注册即可开用。
火山引擎 感谢 火山引擎 赞助了本项目!相比海外主流官方 API 价格更低、性价比更高,生成效果接近;国内直连,无需特殊网络环境。订阅后还能用于日常使用和其他兼容工具,不局限于 Banana Slides。
查看优惠并订阅 →

🔥 最新动态

✨ 项目缘起

你是否也曾陷入这样的困境:明天就要汇报,但PPT还是一片空白;脑中有无数精彩的想法,却被繁琐的排版和设计消磨掉所有热情?

我(们)渴望能快速创作出既专业又具设计感的演示文稿,传统的AI PPT生成app,虽然大体满足“快”这一需求,却还存在以下问题:

以上这些缺陷,让传统的AI ppt生成器难以同时满足我们“快”和“美”的两大PPT制作需求。即使自称Vibe PPT,但是在我的眼中还远不够“Vibe”。

但是,nano banana🍌模型的出现让一切有了转机。我尝试使用🍌pro进行ppt页面生成,发现生成的结果无论是质量、美感还是一致性,都做的非常好,且几乎能精确渲染prompt要求的所有文字+遵循参考图的风格。那为什么不基于🍌pro,做一个原生的"Vibe PPT"应用呢?

👨‍💻 适用场景

  1. 小白:零门槛快速生成美观PPT,无需设计经验,减少模板选择烦恼
  2. PPT专业人士:参考AI生成的布局和图文元素组合,快速获取设计灵感
  3. 教育工作者:将教学内容快速转换为配图教案PPT,提升课堂效果
  4. 学生:快速完成作业Pre,把精力专注于内容而非排版美化
  5. 职场人士:商业提案、产品介绍快速可视化,多场景快速适配

🎯目标: 降低 PPT 制作门槛,让每个人都能快速创作出美观专业的演示文稿

🎨 结果案例

案例3 案例2
软件开发最佳实践 DeepSeek-V3.2技术展示
案例4 案例1
预制菜智能产线装备研发和产业化 钱的演变:从贝壳到纸币的旅程

更多可见 使用案例

🎯 功能介绍

1. 灵活多样的创作路径

支持想法、大纲、页面描述三种起步方式,满足不同创作习惯。

image

2. 强大的素材解析能力

文件解析与素材处理

3. "Vibe" 式自然语言修改

不再受限于复杂的菜单按钮,直接通过自然语言下达修改指令。

image

4. 开箱即用的格式导出

image PPT与PDF导出

5. 可自由编辑的pptx导出(Beta迭代中)

image

6. 一键导出讲解视频


🌟和notebooklm slide deck功能对比

功能 notebooklm 本项目
页数上限 15页 无限制
二次编辑 提示词修改 框选编辑+口头编辑
素材添加 生成后无法添加 生成后自由添加
导出格式 支持导出为 PDF、(不可编辑图片)pptx 导出为PDF、(图片or可编辑)pptx、讲解视频
水印 免费版有水印 无水印,自由增删元素

注:随着新功能添加,对比可能过时

🗺️ 开发计划

状态 里程碑
✅ 已完成 PPT 单页添加更多素材
✅ 已完成 PPT 单页框选区域Vibe口头编辑
✅ 已完成 素材模块: 素材生成、上传等
✅ 已完成 支持多种文件的上传+解析
✅ 已完成 支持Vibe口头调整大纲和描述
✅ 已完成 初步支持可编辑版本pptx文件导出
🔄 进行中 支持多层次、精确抠图的可编辑pptx导出
🔄 进行中 网络搜索
🔄 进行中 Agent 模式
✅ 已完成 TTS 讲解视频导出(中/英/日多音色、字幕)

📦 使用方法

(新)使用应用模板一键部署

这是最简单的方式,无需安装docker或下载项目,创建后可直接进入应用

  1. 通过雨云一键部署和启动本应用 (带宽大,适合高清图片生成和下载。新用户有免费试用)

通过雨云一键部署

  1. 敬请期待

使用 Docker Compose🐳

通过docker compose快速启动前后端服务。

📒 Windows/Mac用户说明

如果你使用 Windows 或 macOS,请先安装 Docker Desktop,并确保 Docker 正在运行(Windows 可检查系统托盘图标;macOS 可检查菜单栏图标),然后按文档中的相同步骤操作。

提示:如果遇到问题,Windows 用户请在 Docker Desktop 设置中启用 WSL 2 后端(推荐);同时确保端口 3011 和 5011 未被占用。

  1. 克隆代码仓库
git clone https://github.com/Anionex/banana-slides
cd banana-slides
  1. 配置环境变量

创建 .env 文件(参考 .env.example):

cp .env.example .env

(可选, 也可以启动后在用户界面配置,教程可点击此处) 编辑 .env 文件,配置必要的环境变量:

点击展开详情

项目中大模型接口以AIHubMix平台格式为标准,推荐使用 AIHubMix(点击此处可直接访问) 获取API密钥,减小迁移成本
友情提示:谷歌nano banana pro模型接口费用较高,请注意调用成本

# AI Provider格式配置 (gemini / openai / volcengine / vertex)
AI_PROVIDER_FORMAT=gemini

# Gemini 格式配置(当 AI_PROVIDER_FORMAT=gemini 时使用)
GOOGLE_API_KEY=your-api-key-here
GOOGLE_API_BASE=https://generativelanguage.googleapis.com
# 代理示例: https://api.inferera.com/gemini

# OpenAI 格式配置(当 AI_PROVIDER_FORMAT=openai 时使用)
OPENAI_API_KEY=your-api-key-here
OPENAI_API_BASE=https://api.openai.com/v1
# 代理示例: https://api.inferera.com/v1

# 商汤日日新 U1 图片模型(保留旧 Provider,图片走 OpenAI 兼容路径)
# 推荐:文本继续用 Gemini,只让图片走商汤
# IMAGE_MODEL_SOURCE=openai
# IMAGE_API_KEY=your-sensenova-api-key
# IMAGE_API_BASE=https://token.sensenova.cn/v1
# IMAGE_MODEL=sensenova-u1.5-lite

# 火山方舟 Agent Plans 配置(当 AI_PROVIDER_FORMAT=volcengine 时使用)
# 注意: Agent Plan 需使用专属 API Key 与模型名 (doubao-seed-2.1-turbo / doubao-seedream-5.0-lite)
VOLCENGINE_API_KEY=your-volcengine-api-key-here
VOLCENGINE_API_BASE=https://ark.cn-bei

banana-slides (Anionex/banana-slides)

Searching Database…

这是什么?Banana Slides 是一款 AI 原生应用,只需一个想法、一份大纲、页面描述,或上传的文档/模板,几分钟内就能生成一份完整、可编辑的幻灯片,由 nano banana pro 图像模型驱动。
这是在线托管的网页应用,还是需要我自己安装的?这是一个自托管的网页应用(类 Next.js 风格的前端 + 后端),你可以通过 Docker Compose 自行运行。它也提供打包好的桌面版,带有自动更新功能,目前文档中说明的是 Windows 版本。
怎么把它跑起来?克隆仓库,创建一个 .env 文件并填入 AI 服务商的密钥,然后用 Docker Compose 启动即可;或者完全跳过本地部署,直接在雨云的托管模板上一键部署现成的实例。
生成幻灯片需要我自己的 AI API 密钥吗?需要。你需要通过 .env 配置 Gemini、OpenAI、Volcengine 或 Vertex 格式的 AI 服务商密钥。README 推荐通过 AIHubMix 获取密钥,价格更划算,因为谷歌的 nano banana pro 调用费用可能较高。
可编辑 PPTX 导出功能已经完全完成了吗?还没有完全完成。自由排版的可编辑 PPTX 导出仍处于测试版并在持续迭代中;多图层精确抠图导出、联网搜索和 Agent 模式仍是路线图上的进行中项目。
这款工具主要面向谁?README 面向的人群包括:希望无需设计技能就能做出精美幻灯片的设计新手、寻找排版灵感的 PPT 专业人士、想把课程内容做成配图课件的教育工作者,以及需要快速制作演示文稿的学生或职场人士。
它和 Google NotebookLM 的幻灯片功能相比如何?与 NotebookLM 不同,NotebookLM 的幻灯片最多 15 页,免费版输出带水印,且只能通过提示词修改。Banana Slides 没有页数限制、没有水印,生成后仍可补充素材,并支持框选修改和语音指令修改。
除了静态幻灯片,我还能导出别的吗?可以。除了可编辑的 PPTX 和 PDF,还能将整套幻灯片导出为讲解视频(MP4),附带 AI 生成的语音旁白和多语言字幕,并可选择多种声音风格。
我能用自己的模板来控制视觉风格吗?可以。你可以上传参考图片或 PDF 作为模板,将同一种风格应用到整套幻灯片,也可以为每一页绑定不同的模板,还能让 AI 为每页自动匹配风格。
除了网页界面,还有别的自动化方式吗?有。2026-04-11 的更新新增了命令行(CLI)操作支持和 Agent 技能,因此可以通过脚本或编程类 Agent 来驱动生成器,而不必只能用浏览器界面。
Creator
Anionex
Size
81 MB
Stars
15.8K
Age
10mo
Commits · 90 Days