Banana Slides

项目介绍

Banana Slides 是一个基于 nano banana pro 的原生AI PPT生成应用，致力于打造真正的”Vibe PPT”体验。它能够根据一句话描述、大纲或页面描述自动生成精美的PPT，支持智能文档解析、口头修改指定区域，并可一键导出可编辑的PPTX文件。

环境要求

💡 💡
需要 nano banana pro API Key，可在 官网 申请

安装步骤

git clone https://github.com/Anionex/banana-slides.git
cd banana-slides

# 进入前端目录
cd frontend

# 安装依赖
pnpm install

# 返回根目录，进入后端目录
cd ../backend

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境 (Windows)
.\venv\Scripts\activate

# 激活虚拟环境 (Mac/Linux)
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 复制环境变量模板
cp .env.example .env

# 编辑 .env 文件，填入你的 API Key
NANO_BANANA_API_KEY="your-api-key-here"

启动服务

启动后端服务

# 在 backend 目录下
python main.py

# 或使用 uvicorn
uvicorn main:app --reload --port 8000

启动前端服务

# 在 frontend 目录下
pnpm dev

✅ ✅
启动成功后，访问 http://localhost:3000 即可使用

使用指南

方式一：一句话生成

1. 在输入框中输入PPT主题，如”钱的演变：从贝壳到纸币的旅程”
2. 点击”生成PPT”按钮
3. 等待AI生成完整的PPT
4. 预览并调整内容

方式二：大纲生成

1. 点击”大纲生成”模式
2. 输入每一页的大纲描述
3. AI根据大纲生成对应页面

方式三：文档解析

1. 上传PDF、Word、PPT或图片文件
2. AI自动解析文档内容（文字、表格、公式、图表）
3. 智能匹配内容到对应PPT页面

口头修改功能

1. 在预览页面点击”编辑”按钮
2. 选中需要修改的区域
3. 输入自然语言描述，如”把背景改成蓝色”
4. AI自动重新生成该区域

导出可编辑PPT

生成完成后，点击右上角的”导出”按钮，即可下载可编辑的 .pptx 文件。该文件可直接在 Microsoft PowerPoint 或 WPS 中打开编辑。

⚠️ ⚠️
导出的PPT保留了所有元素的可编辑性，包括文字、形状、图片等

常见问题

Q: 支持哪些文档格式？

目前支持 PDF、Word (.docx)、PowerPoint (.pptx)、图片 (JPG/PNG) 等格式。

Q: 生成的PPT可以商用吗？

是的，Banana Slides 是开源项目，生成的PPT可以自由使用，包括商业用途。

Q: 如何自定义模板？

在生成页面点击”上传模板”，上传你喜欢的PPT模板图片，AI会自动提取风格并应用到生成的PPT中。

Q: API调用失败怎么办？

请检查：1) API Key 是否正确配置；2) 网络连接是否正常；3) API 额度是否充足。

相关链接

• GitHub 仓库：https://github.com/Anionex/banana-slides
• nano banana pro：https://api.nanabanana.pro
• 使用案例：GitHub Issues #2