快速开始

在线 Demo

无需安装，直接体验：bananaslides.online

自托管部署

第一步：安装 Docker

Windows / macOS
Linux

下载并安装 Docker Desktop，安装完成后启动它，确保系统托盘（Windows）或菜单栏（macOS）中出现 Docker 图标。

curl -fsSL https://get.docker.com | sh

第二步：一键下载并启动

新建一个目录，进入后执行以下命令，自动下载配置文件并启动服务：

mkdir banana-slides && cd banana-slides && \
curl -O https://raw.githubusercontent.com/Anionex/banana-slides/main/docker-compose.prod.yml && \
curl -O https://raw.githubusercontent.com/Anionex/banana-slides/main/.env.example && \
cp .env.example .env

然后编辑 .env 文件，填入你的 API 密钥（详见配置说明），再启动：

docker compose -f docker-compose.prod.yml up -d

推荐使用 AIHubMix 获取 API 密钥，同时支持 Gemini 和 OpenAI 格式，且能稳定进行高并发生图。

第三步：访问应用

浏览器打开 http://localhost:3011，即可开始使用。

默认端口为 3011（前端）和 5011（后端）。如需修改，在 .env 中设置 FRONTEND_PORT 和 BACKEND_PORT。

更新

在应用内进入 设置 → 关于 → 检查更新，可以根据当前版本 SHA 判断是否已有可用更新；源码运行时也会用当前 Git SHA 参与判断。

docker compose -f docker-compose.prod.yml pull && \
docker compose -f docker-compose.prod.yml up -d

查看日志

docker logs -f --tail 100 banana-slides-backend

从源码部署

展开查看源码部署步骤

环境要求

Python 3.10+
uv 包管理器
Node.js 16+ 和 npm

后端

git clone https://github.com/Anionex/banana-slides
cd banana-slides
cp .env.example .env  # 编辑 .env 填入 API 密钥
cd backend
uv run alembic upgrade head && uv run python app.py

前端

cd frontend
npm install
npm run dev

快速上手

创作流程

素材与导出

开发者

其他

在线 Demo

自托管部署

第一步：安装 Docker

第二步：一键下载并启动

第三步：访问应用

更新

查看日志

从源码部署

环境要求

后端

前端

​在线 Demo

​自托管部署

​第一步：安装 Docker

​第二步：一键下载并启动

​第三步：访问应用

​更新

​查看日志

​从源码部署

​环境要求

​后端

​前端

在线 Demo

自托管部署

第一步：安装 Docker

第二步：一键下载并启动

第三步：访问应用

更新

查看日志

从源码部署

环境要求

后端

前端