Open-Source AI Presentation Generator and API (Gamma, Beautiful AI, Decktopus Alternative)

✨ Why Presenton

No SaaS lock-in · No forced subscriptions · Full control over models and data

What makes Presenton different?

• Use Fully self-hosted in Web through Docker Package
• Or Download Desktop App (Mac, Windows & Linux)
• Works with OpenAI, Gemini, Vertex AI, Azure OpenAI, Anthropic, Ollama, or custom models
• Comes with AI Presentation Generation API
• Fully open-source (Apache 2.0)
• Works with your own design/templates

[!TIP] Star us! A ⭐ shows your support and encourages us to keep building! 😇

🎛 Features

💻 Presenton Desktop

Create AI-powered presentations using your own model provider (BYOK) or run everything locally on your own machine for full control and data privacy.

Available Platforms

Presenton gives you complete control over your AI presentation workflow. Choose your models, customize your experience, and keep your data private.

• Custom Templates & Themes — Create unlimited presentation designs with HTML and Tailwind CSS
• AI Template Generation — Create presentation templates from existing Powerpoint documents.
• Flexible Generation — Build presentations from prompts or uploaded documents
• Export Ready — Save as PowerPoint (PPTX) and PDF with professional formatting
• Built-In MCP Server — Generate presentations over Model Context Protocol
• Bring Your Own Key — Use your own API keys for OpenAI, Google Gemini, Vertex AI, Azure OpenAI, Anthropic Claude, or any compatible provider. Only pay for what you use, no hidden fees or subscriptions.
• Ollama Integration — Run open-source models locally with full privacy
• OpenAI API Compatible — Connect to any OpenAI-compatible endpoint with your own models
• Multi-Provider Support — Mix and match text and image generation providers
• Versatile Image Generation — Choose from DALL-E 3, Gemini Flash, Pexels, or Pixabay
• Rich Media Support — Icons, charts, and custom graphics for professional presentations
• Runs Locally — All processing happens on your device, no cloud dependencies
• API Deployment — Host as your own API service for your team
• Fully Open-Source — Apache 2.0 licensed, inspect, modify, and contribute
• Docker Ready — One-command deployment with GPU support for local models
• Electron Desktop App — Run Presenton as a native desktop application on Windows, macOS, and Linux (no browser required)
• Sign in with ChatGPT — Use your free or paid ChatGPT account to sign in and start creating presentations instantly — no separate API key required

☁️ Presenton Cloud

Run Presenton directly in your browser — no installation, no setup required. Start creating presentations instantly from anywhere.

⚡ Running Presenton

Option 1: Electron (Desktop App)

• Setup (First Time)

  This installs Node dependencies, runs uv sync in the FastAPI server, and installs Next.js dependencies.

• Run in Development

• Build Distributable (Optional) To create installers for Windows, macOS, or Linux:

Option 2: Docker

• Start Presenton Linux/MacOS (Bash/Zsh Shell):

  Windows (PowerShell):

• Open Presenton

⚙️ Deployment Configurations

The lists below match the environment variables forwarded in this repository’s docker-compose.yml (production, production-gpu, development, and development-gpu). Put values in a .env file next to the compose file, or export them before docker compose up. The Electron app backend can read the same names when run outside Docker.

Other optional variables exist in code (for example advanced Mem0 paths, LiteParse runners, or FAST_API_INTERNAL_URL when Next.js and FastAPI are not same-origin); they are not wired in docker-compose.yml. Supported names are discoverable from servers/fastapi/utils/get_env.py and the Next.js server utilities under servers/nextjs/.

LLM and API keys

• CAN_CHANGE_KEYS=[true/false]: Set to false if you want to keep API keys hidden and make them unmodifiable.
• LLM=[openai/google/vertex/azure/anthropic/ollama/custom/codex]: Select the text LLM.
• OPENAI_API_KEY: Required if LLM is openai.
• OPENAI_MODEL: Required if LLM is openai (default: gpt-4.1).
• GOOGLE_API_KEY: Required if LLM is google.
• GOOGLE_MODEL: Required if LLM is google (default: models/gemini-2.0-flash).
• VERTEX_MODEL: Required if LLM is vertex (default: gemini-2.5-flash).
• VERTEX_API_KEY: Optional auth path for LLM=vertex (Vertex Express).
• VERTEX_PROJECT / VERTEX_LOCATION: Optional auth path for LLM=vertex when using GCP project credentials (do not combine with VERTEX_API_KEY).
• VERTEX_BASE_URL: Optional Vertex gateway/base URL override.
• AZURE_OPENAI_MODEL: Required if LLM is azure (deployment/model name).
• AZURE_OPENAI_API_KEY: Required if LLM is azure.
• AZURE_OPENAI_API_VERSION: Required if LLM is azure (for example 2024-10-21).
• AZURE_OPENAI_ENDPOINT / AZURE_OPENAI_BASE_URL: At least one is required if LLM is azure.
• AZURE_OPENAI_DEPLOYMENT: Optional deployment override for LLM is azure.
• ANTHROPIC_API_KEY: Required if LLM is anthropic.
• ANTHROPIC_MODEL: Required if LLM is anthropic (default: claude-3-5-sonnet-20241022).
• CODEX_MODEL: Required if LLM is codex (Codex OAuth flow; compose maps host port 1455 for the callback).
• CUSTOM_LLM_URL: OpenAI-compatible base URL if LLM is custom.
• CUSTOM_LLM_API_KEY: API key if LLM is custom.
• CUSTOM_MODEL: Model id if LLM is custom.
• DISABLE_THINKING=[true/false]: If true, disables “thinking” on the custom LLM.
• WEB_GROUNDING=[true/false]: If true, enables web search for OpenAI, Google, and Anthropic models.
• EXTENDED_REASONING=[true/false]: Enables extended reasoning where supported by the configured stack.

Ollama

Use when LLM is ollama:

• OLLAMA_URL: Base URL of the Ollama HTTP API (e.g. http://host.docker.internal:11434 from Docker).
• OLLAMA_MODEL: Model name in Ollama (e.g. llama3.2:3b).
• START_OLLAMA=[true/false]: Container entrypoint (start.js): optional install + ollama serve. Default false (development / production compose).

Presentation memory (Mem0 OSS)

Mem0 uses local Qdrant + SQLite (OSS); memory is scoped per presentation.

By default the Docker runtime now points Mem0 at a local Ollama-compatible LLM endpoint, so it no longer needs an OpenAI key just to initialize. If you want to use OpenAI instead, set MEM0_LLM_BASE_URL/MEM0_LLM_API_KEY to your OpenAI-compatible endpoint and key. Docker images install the default spaCy model (en_core_web_sm) during build so Mem0 can start without extra setup on each run.

Variable	Purpose
MEM0_ENABLED	true/false (compose default true).
MEM0_LLM_MODEL	Mem0 LLM model name (compose default llama3.1:latest or OLLAMA_MODEL).
MEM0_LLM_API_KEY	Mem0 LLM API key placeholder for OpenAI-compatible clients (compose default ollama).
MEM0_LLM_BASE_URL	Mem0 LLM base URL (compose default OLLAMA_URL or http://host.docker.internal:11434).
MEM0_DIR	Root directory (compose default /app_data/mem0).
MEM0_EMBEDDER_PROVIDER	Embedder backend (compose default fastembed).
MEM0_EMBEDDER_MODEL	Model id (compose default BAAI/bge-small-en-v1.5).
MEM0_EMBEDDING_DIMS	Vector size (compose default 384).
MEM0_SPACY_MODEL	Optional spaCy model override (default en_core_web_sm).
MEM0_REQUIRE_SPACY_MODEL	Keep as true (default). Set to false only if you intentionally want Mem0 to run without spaCy lemmatization.

Document parsing (LiteParse)

Variable	Purpose
LITEPARSE_DPI	OCR render DPI (compose default 120).
LITEPARSE_NUM_WORKERS	Worker count (compose default 1).

Database

• DATABASE_URL: SQLAlchemy URL; if unset, the app falls back to SQLite under app data.
• MIGRATE_DATABASE_ON_STARTUP: Compose sets true for all services so migrations run on startup.

Image generation

These variables match docker-compose.yml. IMAGE_PROVIDER selects the backend (pexels, pixabay, gemini_flash, nanobanana_pro, dall-e-3, gpt-image-1.5, comfyui, open_webui). Use OPENAI_API_KEY for OpenAI image modes and GOOGLE_API_KEY for Gemini image modes (same keys as the LLM section).

• DISABLE_IMAGE_GENERATION=[true/false]: Disable slide image generation.
• IMAGE_PROVIDER: Provider id (see enum above).
• PEXELS_API_KEY: Pexels stock images.
• PIXABAY_API_KEY: Pixabay stock images.
• DALL_E_3_QUALITY=[standard/hd]: Optional for dall-e-3 (default standard).
• GPT_IMAGE_1_5_QUALITY=[low/medium/high]: Optional for gpt-image-1.5 (default medium).
• COMFYUI_URL / COMFYUI_WORKFLOW: Self-hosted ComfyUI workflow JSON.
• OPEN_WEBUI_IMAGE_URL / OPEN_WEBUI_IMAGE_API_KEY: Open WebUI–compatible image endpoint.

Telemetry

• DISABLE_ANONYMOUS_TRACKING=[true/false]: Set to true to disable anonymous telemetry.

Authentication (web login)

Presenton uses a single admin account per instance. Credentials live in app_data (hashed; see userConfig.json). Pass these with -e or via .env for compose:

• AUTH_USERNAME / AUTH_PASSWORD — Preseed the admin login on first boot (password at least 6 characters). Ignored if a user already exists unless AUTH_OVERRIDE_FROM_ENV is set.
• AUTH_OVERRIDE_FROM_ENV=[true/false] — If true, replace stored credentials from the env vars on every FastAPI startup and rotate the session signing secret (invalidates existing sessions). Remove after a one-off rotation.
• RESET_AUTH=[true/false] — If true, clear stored credentials on startup. Use for a single boot to recover access, then unset.

Examples

docker run -it --name presenton -p 5000:80 -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest

docker run -it --name presenton -p 5000:80 -e AUTH_USERNAME=admin -e AUTH_PASSWORD=changeme123 -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest

docker run -it --name presenton -p 5000:80 -e AUTH_USERNAME=admin -e AUTH_PASSWORD=changeme123 -v "${PWD}\app_data:/app_data" ghcr.io/presenton/presenton:latest

docker stop presenton && docker rm presenton && docker run -it --name presenton -p 5000:80 -e AUTH_USERNAME=admin -e AUTH_PASSWORD=newcred456 -e AUTH_OVERRIDE_FROM_ENV=true -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest

docker stop presenton && docker rm presenton && docker run -it --name presenton -p 5000:80 -e RESET_AUTH=true -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest

docker stop presenton && docker rm presenton && docker run -it --name presenton -p 5000:80 -e AUTH_USERNAME=admin -e AUTH_PASSWORD=changeme123 -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest

Manual reset: stop the container, edit ./app_data/userConfig.json, delete AUTH_USERNAME, AUTH_PASSWORD_HASH, and AUTH_SECRET_KEY, save, and start again.

Sign out from the app: Settings → Other → Sign out.

Note: LLM and image variables above are forwarded from docker-compose.yml when set in .env.

Docker Run Examples by Provider

Same variables as compose; use -e instead of .env when running docker run directly.

• Using OpenAI

• Using Google

• Using Vertex AI (API key mode)

• Using Azure OpenAI

• Using Ollama

• Using Anthropic

• Using OpenAI Compatible API

• Running Presenton with GPU Support To use GPU acceleration with Ollama models, you need to install and configure the NVIDIA Container Toolkit. This allows Docker containers to access your NVIDIA GPU. Once the NVIDIA Container Toolkit is installed and configured, you can run Presenton with GPU support by adding the --gpus=all flag:

✨ Generate Presentation via API

Generate Presentation

Request Body

Response

Example (curl + HTTP Basic auth with -u)

Example Response

Documentation & Tutorials

🚀 Roadmap

Track the public roadmap on GitHub Projects: https://github.com/orgs/presenton/projects/2