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)

explainer-video
Searching Database…

What is this?Banana Slides is an AI-native app that turns a single idea, an outline, page descriptions, or uploaded documents/templates into a full editable slide deck in minutes, powered by the nano banana pro image model.
Is this a hosted web app or something I install myself?It's a self-hosted web app (Next.js-style frontend + backend) you run yourself via Docker Compose, and it also ships a packaged desktop build with its own auto-updater, currently documented for Windows.
How do I get it running?Clone the repo, create a .env file with your AI provider key, and start it with Docker Compose — or skip local setup entirely and deploy a ready instance with one click on Rainyun's hosting template.
Do I need my own AI API key to generate slides?Yes, you configure an AI provider key in Gemini, OpenAI, Volcengine, or Vertex format via .env; the README recommends AIHubMix to get a key cheaply, since Google's nano banana pro calls can be expensive.
Is the editable PPTX export fully finished?Not entirely — free-form editable PPTX export is still iterating in beta, and multi-layer precise-cutout export, web search, and an Agent mode are all still listed as in-progress roadmap items.
Who is this aimed at?The README targets design beginners who want polished slides with no design skills, PPT professionals looking for layout inspiration, educators turning lessons into illustrated decks, and students or employees who need quick presentations.
How does this compare to Google NotebookLM's slide feature?Unlike NotebookLM, which caps decks at 15 pages, watermarks free output, and only allows prompt-based edits, Banana Slides has no page limit, no watermark, lets you add materials after generation, and supports box-select plus spoken edits.
Can I export more than a static deck?Yes, besides editable PPTX and PDF, you can export the whole deck as an explainer video (MP4) with AI-generated voice narration and subtitles in multiple languages and voice styles.
Can I control the visual style with my own templates?You can upload reference images or PDFs as templates and apply one uniform style to the whole deck or bind a different template to each page, with AI auto-matching styles per page.
Is there anything besides the web UI for automation?Yes, a 2026-04-11 update added CLI operation support and agent skills so the generator can be driven from scripts or coding agents instead of only the browser UI.
Creator
Anionex
Size
81 MB
Stars
15.8K
Age
10mo
Commits · 90 Days