Quick Start

Online Demo

No installation needed — try it instantly: bananaslides.online

Self-Hosting

Step 1: Install Docker

Windows / macOS
Linux

Download and install Docker Desktop. After installation, launch it and confirm the Docker icon appears in the system tray (Windows) or menu bar (macOS).

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

Step 2: Download and Start

Create a new directory, enter it, and run the following command to download the config files and start the service:

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

Edit the .env file to fill in your API key (see Configuration), then start:

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

AIHubMix is recommended for API keys — it supports both Gemini and OpenAI formats and handles high-concurrency image generation reliably.

Step 3: Open the App

Visit http://localhost:3011 in your browser.

Default ports are 3011 (frontend) and 5011 (backend). To change them, set FRONTEND_PORT and BACKEND_PORT in .env.

Update

In the app, open Settings → About → Check for Updates to compare the current version SHA with the latest available version. Local source-code runs are checked with the current Git SHA as well.

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

View Logs

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

Deploy from Source

Expand for source deployment steps

Requirements

Python 3.10+
uv package manager
Node.js 16+ and npm

Backend

git clone https://github.com/Anionex/banana-slides
cd banana-slides
cp .env.example .env  # Edit .env and add your API key
cd backend
uv run alembic upgrade head && uv run python app.py

Frontend

cd frontend
npm install
npm run dev

Getting Started

Creation Flow

Materials & Export

Developer

More

Online Demo

Self-Hosting

Step 1: Install Docker

Step 2: Download and Start

Step 3: Open the App

Update

View Logs

Deploy from Source

Requirements

Backend

Frontend

​Online Demo

​Self-Hosting

​Step 1: Install Docker

​Step 2: Download and Start

​Step 3: Open the App

​Update

​View Logs

​Deploy from Source

​Requirements

​Backend

​Frontend

Online Demo

Self-Hosting

Step 1: Install Docker

Step 2: Download and Start

Step 3: Open the App

Update

View Logs

Deploy from Source

Requirements

Backend

Frontend