Presenton AI Agent

<p align="center"> <img src="./readme_assets/images/logo.png" alt="Presenton" /> </p> <p align="center"> <a href="https://presenton.ai/download"><strong>Quickstart</strong></a> &middot; <a href="https://presenton.ai/explore"><strong>Templates</strong></a> &middot; <a href="https://docs.presenton.ai/"><strong>Docs</strong></a> &middot; <a href="https://www.youtube.com/@presentonai"><strong>Youtube</strong></a> &middot; <a href="https://discord.gg/9ZsKKxudNE"><strong>Discord</strong></a> </p> <p align="center"> <a href="https://github.com/presenton/presenton/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat" alt="Apache2.0" /></a> <a href="https://github.com/presenton/presenton"><img src="https://img.shields.io/github/stars/presenton/presenton?style=flat" alt="Stars" /></a> <a href="https://presenton.ai/"><img src="https://img.shields.io/badge/Platform-Docker%20%7C%20Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?style=flat" alt="Platform" /></a> </p> <p align="center"> <a href="https://trendshift.io/repositories/18582?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-18582" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/18582" alt="presenton%2Fpresenton | Trendshift" width="250" height="55" /></a> </p>

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

Discover what Presenton can do from AI-powered presentation generation to editing, exporting, and flexible model providers.

▶ Watch Presenton in Action

✨ 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 Ollama, LM Studio, OpenAI, Gemini, Vertex AI, Azure OpenAI, Amazon Bedrock, Fireworks, Together AI, Anthropic, or any other OpenAI compatible providers
• Comes with AI Presentation Generation API
• Fully open-source (Apache 2.0)
• Works with your own design/templates
• Fully editable PPTX export

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

<p align="center"> <img src="./readme_assets/images/banner_bg.gif" alt="Presenton" /> </p>

🎛 Features

Create presentations from a prompt, an uploaded document, or your own PowerPoint design. Choose from built-in templates, bring your preferred AI provider and API key, polish manually with drag-edit interface and export a fully editable deck.

<p align="center"> <img src="./readme_assets/images/drag-and-edit.gif" alt="Drag-and-drop editing in the Presenton slide editor" /> </p> <p align="center"> <img src="./readme_assets/images/features.png" alt="Presenton features: custom designs, AI generation, bring your own API key, and built-in templates" /> </p> <p align="center"> <img src="./readme_assets/images/chatgpt-2-1.png" alt="Create presentations with your existing ChatGPT subscription: secure and private, with instant access and no API keys" /> </p>

🎨 In-Built AI Presentation Templates for PowerPoint

Browse in-built AI presentation templates for pitch decks, business reports, executive updates, educational presentations, and more. Preview each editable slide layout, choose a design, and use Presenton to generate fully editable PowerPoint (.pptx) or PDF presentations from a prompt or document.

To customize a built-in design, open its preview and select Copy to custom. The copy appears under Custom templates and uses the existing template editor.

<table border="1" cellpadding="16" cellspacing="0" width="100%"> <tr> <td align="center" width="33%"> <a href="https://presenton.ai/explore/momentum"> <img src="./readme_assets/templates/Momentum.png" alt="Momentum AI presentation template with sales report, KPI, chart, and executive summary slide layouts" /> </a> <br /> _{<b>Momentum Business Presentation Template</b> — sales reports, strategy decks, and data storytelling <br /> <a href="https://presenton.ai/explore/momentum">Preview Momentum business template ↗</a>} </td> <td align="center" width="33%"> <a href="https://presenton.ai/explore/dynamic"> <img src="./readme_assets/templates/Dynamic.png" alt="Dynamic AI presentation template with high-contrast creative and visual storytelling slide layouts" /> </a> <br /> _{<b>Dynamic Creative Presentation Template</b> — proposals, visual stories, and high-impact decks <br /> <a href="https://presenton.ai/explore/dynamic">Preview Dynamic presentation template ↗</a>} </td> <td align="center" width="33%"> <a href="https://presenton.ai/explore/executive"> <img src="./readme_assets/templates/Executive.png" alt="Executive PowerPoint template with leadership, strategy, and decision-making slide layouts" /> </a> <br /> _{<b>Executive PowerPoint Template</b> — leadership updates, strategic plans, and decision-ready reports <br /> <a href="https://presenton.ai/explore/executive">Preview Executive PowerPoint template ↗</a>} </td> </tr> <tr> <td align="center" width="33%"> <a href="https://presenton.ai/explore/general"> <img src="./readme_assets/templates/General.png" alt="General presentation template with flexible business and educational slide layouts" /> </a> <br /> _{<b>General Presentation Template</b> — adaptable layouts for business, education, and everyday topics <br /> <a href="https://presenton.ai/explore/general">Preview General presentation template ↗</a>} </td> <td align="center" width="33%"> <a href="https://presenton.ai/explore/modern"> <img src="./readme_assets/templates/Modern.png" alt="Modern pitch deck template with contemporary product, startup, and portfolio slide layouts" /> </a> <br /> _{<b>Modern Pitch Deck Template</b> — contemporary slides for startups, products, and portfolios <br /> <a href="https://presenton.ai/explore/modern">Preview Modern pitch deck template ↗</a>} </td> <td align="center" width="33%"> <a href="https://presenton.ai/explore/standard"> <img src="./readme_assets/templates/Standard.png" alt="Standard business presentation template with report, proposal, and company slide layouts" /> </a> <br /> _{<b>Standard Business Presentation Template</b> — professional reports, proposals, and company decks <br /> <a href="https://presenton.ai/explore/standard">Preview Standard business template ↗</a>} </td> </tr> </table> <p align="center"> <a href="https://presenton.ai/explore"><strong>Browse all free AI presentation templates →</strong></a> &nbsp;&middot;&nbsp; <a href="https://presenton.ai/custom-template"><strong>Create an AI-ready PowerPoint template from your PPTX →</strong></a> </p>

💻 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.

<p align="center"> <a href="https://presenton.ai/download"> <img src="./readme_assets/images/banner.png" alt="Cloud deployment" /> </a> </p>

Available Platforms

<table> <tr> <th align="left">Platform</th> <th align="left">Architecture</th> <th align="left">Package</th> <th align="left">Download</th> </tr> <tr> <td><b>macOS</b></td> <td>Apple Silicon / Intel</td> <td><code>.dmg</code></td> <td><a href="https://presenton.ai/download">Download ↗</a></td> </tr> <tr> <td><b>Windows</b></td> <td>x64</td> <td><code>.exe</code></td> <td><a href="https://presenton.ai/download">Download ↗</a></td> </tr> <tr> <td><b>Linux</b></td> <td>x64</td> <td> <code>.deb</code></td> <td><a href="https://presenton.ai/download">Download ↗</a></td> </tr> </table>

Deploy to Cloud Providers

<div style="display:flex; gap:12px; align-items:center;"> <a href="https://railway.com/deploy/presenton-ai-presentations"> <img src="https://railway.com/button.svg" alt="Deploy on Railway" style="height:38px;" /> </a> <a href="https://cloud.digitalocean.com/apps/new?repo=https://github.com/presenton/presenton/tree/main"> <img src="https://www.deploytodo.com/do-btn-blue.svg" alt="Deploy to DigitalOcean" style="height:36px;" /> </a> </div>

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 GPT Image 2, 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
• Multi-User Workspaces — Give each user a private workspace and manage accounts from a built-in admin panel
• 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.

<p align="center"> <a href="https://presenton.ai"> <img src="./readme_assets/images/cloud-banner.png" alt="Presenton Cloud" /> </a> </p>

🏢 Presenton Enterprise

Deploy and manage Presenton across your organization with versioned Helm charts for Kubernetes, detailed audit logs, and a centralized admin console. Enterprise authentication supports SSO and automated user provisioning through OAuth, OIDC, and SCIM.

<p align="center"> <a href="https://presenton.ai/enterprise"> <img src="./readme_assets/images/readme_Enterprise.png" alt="Presenton Enterprise features: Helm chart deployment, audit logs, centralized administration, and enterprise SSO and provisioning" /> </a> </p>

⚡ Running Presenton

<p> You can run Presenton in two ways: <strong>Docker</strong> for a one-command setup without installing a local dev stack, or the <strong>Electron desktop app</strong> for a native app experience (ideal for development or offline use). </p>

Option 1: Electron (Desktop App)

<p> Run Presenton as a native desktop application. LLM and image provider (API keys, etc.) can be configured in the app. The same environment variables used for Docker apply when running the bundled backend. </p> <p> <strong>Prerequisites:</strong> Node.js (LTS), npm, Python 3.11, and <a href="https://docs.astral.sh/uv/">uv</a> (for the shared FastAPI backend in <code>servers/fastapi</code>). </p>

• Setup (First Time)

  <pre><code class="language-bash">cd electron npm run setup:env</code></pre>

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

• Run in Development

  <pre><code class="language-bash">npm run dev</code></pre> <p> This compiles TypeScript and starts Electron. The backend and UI run locally inside the desktop window. </p>

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

  <pre><code class="language-bash">npm run build:all npm run dist</code></pre> <p> Output files are written to <code>electron/dist</code> (or as configured in your <code>electron-builder</code> settings). </p> <p> For a public macOS DMG outside the Mac App Store, use <code>APPLE_KEYCHAIN_PROFILE="presenton-notary" npm run build:all:mac:signed</code> from <code>electron/</code> after the one-time Developer ID and notarization setup in <code>docs/macos/dev/direct-distribution.md</code>. </p>

Option 2: Docker

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

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

  Windows (PowerShell):

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -v "${PWD}\app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Open Presenton

  <p> Open <a href="http://localhost:5001">http://localhost:5001</a> in the browser of your choice to use Presenton. </p> <blockquote> <p> <strong>Note:</strong> You can replace <code>5001</code> with any other port number of your choice to run Presenton on a different port number. If you use Docker Compose, set <code>PRESENTON_HTTP_HOST_PORT</code>, for example <code>PRESENTON_HTTP_HOST_PORT=8080 docker compose up production</code>. </p> </blockquote>

⚙️ Deployment Configurations

The tables 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/.

Air-gapped deployments

The Community gallery is enabled by default and reads presentation designs from the Presenton community service. Air-gapped deployments must disable it:

PRESENTON_COMMUNITY_ENABLED=false

For Docker Compose, add the value to the .env file next to docker-compose.yml before starting Presenton. For docker run, pass -e PRESENTON_COMMUNITY_ENABLED=false. This removes Community from the UI and prevents the backend from sending Community gallery or design-reference requests.

LLM and API keys

Provider settings are managed by account roles: admins can view and update shared keys, while regular users receive only redacted runtime configuration. The legacy CAN_CHANGE_KEYS variable is ignored and can be removed from existing deployments. Missing provider configuration leaves login status and initial account setup available so an admin can finish configuration in Settings.

Variable	Values / default	Purpose
PRESENTON_PUBLIC_URL	Optional URL	Browser-reachable Presenton origin, such as http://localhost:5001 or https://slides.example.com. Generated download, edit, and preview links use this origin.
PRESENTATION_GENERATION_MODE	both (default), standard, smart	Controls the modes available in the UI and MCP server. A single-mode value hides the selector; smart also hides template features. See the presentation generation modes guide.
PRESENTON_COMMUNITY_ENABLED	true (default), false	Controls the cloud-backed Community gallery and design references. Set to false for air-gapped deployments to hide the feature and prevent community API requests.
PRESENTON_COMMUNITY_API_URL	https://api.presenton.ai/api/v3/community/presentations (default)	Community API base URL. Requests use the catalog or a positive presentation ID and do not follow redirects; configure the service's final API URL.
LLM	openai, deepseek, google, vertex, azure, bedrock, openrouter, fireworks, together, cerebras, anthropic, litellm, lmstudio, ollama, custom, codex	Selects the text LLM provider.
OPENAI_API_KEY	Required for LLM=openai	OpenAI API key.
OPENAI_MODEL	gpt-4.1 (default)	OpenAI model.
DEEPSEEK_API_KEY	Required for LLM=deepseek	DeepSeek API key.
DEEPSEEK_MODEL	deepseek-chat (default)	DeepSeek model.
DEEPSEEK_BASE_URL	https://api.deepseek.com (default)	DeepSeek base URL.
GOOGLE_API_KEY	Required for LLM=google	Google API key.
GOOGLE_MODEL	models/gemini-2.0-flash (default)	Google model.
VERTEX_MODEL	gemini-2.5-flash (default)	Vertex AI model.
VERTEX_API_KEY	Optional	Vertex Express API key authentication.
VERTEX_PROJECT / VERTEX_LOCATION	Optional pair	GCP project credential authentication; do not combine with VERTEX_API_KEY.
VERTEX_BASE_URL	Optional URL	Vertex gateway or base URL override.
AZURE_OPENAI_MODEL	Required for LLM=azure	Azure deployment or model name.
AZURE_OPENAI_API_KEY	Required for LLM=azure	Azure OpenAI API key.
AZURE_OPENAI_API_VERSION	Required; for example 2024-10-21	Azure OpenAI API version.
AZURE_OPENAI_ENDPOINT / AZURE_OPENAI_BASE_URL	At least one required	Azure OpenAI endpoint.
AZURE_OPENAI_DEPLOYMENT	Optional	Azure deployment override.
BEDROCK_REGION	us-east-1 (default)	AWS Bedrock region.
BEDROCK_MODEL	Required for LLM=bedrock	Standard model ID or full inference-profile ARN, passed to Bedrock Converse as modelId. See the Amazon Bedrock guide.
BEDROCK_API_KEY	Optional	Bedrock API-key authentication; alternative to AWS keys.
BEDROCK_AWS_ACCESS_KEY_ID / BEDROCK_AWS_SECRET_ACCESS_KEY	Required together when BEDROCK_API_KEY is unset	AWS credential authentication for Bedrock.
BEDROCK_AWS_SESSION_TOKEN	Optional	AWS session token.
BEDROCK_PROFILE_NAME	Optional	AWS profile name.
OPENROUTER_API_KEY	Required for LLM=openrouter	OpenRouter API key.
OPENROUTER_MODEL	openai/gpt-4o (default)	OpenRouter model.
OPENROUTER_BASE_URL	https://openrouter.ai/api/v1 (default)	OpenRouter base URL. Provider discovery accepts the default or this server-configured URL and does not follow redirects; configure the proxy's final API URL.
OPENROUTER_PROVIDER_ORDER	Optional comma-separated list	Provider routing order.
OPENROUTER_ALLOW_FALLBACKS	true / false	Optional provider fallback override.
OPENROUTER_REQUIRE_PARAMETERS	true / false	Only route to providers supporting every request parameter.
OPENROUTER_DATA_COLLECTION	allow / deny	Optional data-collection policy.
OPENROUTER_ZDR	true / false	Optional zero-data-retention requirement.
FIREWORKS_API_KEY	Required for LLM=fireworks	Fireworks API key.
FIREWORKS_MODEL	For example accounts/fireworks/models/llama-v3p1-8b-instruct	Fireworks model.
FIREWORKS_BASE_URL	https://api.fireworks.ai/inference/v1 (default)	Fireworks base URL.
TOGETHER_API_KEY	Required for LLM=together	Together AI API key.
TOGETHER_MODEL	For example openai/gpt-oss-20b	Together AI model.
TOGETHER_BASE_URL	https://api.together.ai/v1 (default)	Together AI base URL. Model discovery requires a final HTTP(S) API base URL without a query or fragment and does not follow redirects.
CEREBRAS_API_KEY	Required for LLM=cerebras	Cerebras API key.
CEREBRAS_MODEL	llama-3.3-70b (default)	Cerebras model.
CEREBRAS_BASE_URL	https://api.cerebras.ai/v1 (default)	Cerebras base URL.
ANTHROPIC_API_KEY	Required for LLM=anthropic	Anthropic API key.
ANTHROPIC_MODEL	claude-3-5-sonnet-20241022 (default)	Anthropic model.
CODEX_MODEL	Required for LLM=codex	Codex model. The OAuth flow maps host port 1455 for its callback.
CUSTOM_LLM_URL	Required for LLM=custom	OpenAI-compatible base URL. The server must implement POST /v1/chat/completions; a provider-specific completion endpoint is insufficient. Model discovery supports local servers and proxy prefixes, requires a URL without a query or fragment, and does not follow redirects.
CUSTOM_LLM_API_KEY	Provider-dependent	Custom-provider API key.
CUSTOM_MODEL	Required for LLM=custom	Custom-provider model ID.
LITELLM_BASE_URL	Required for LLM=litellm	LiteLLM proxy or gateway base URL.
LITELLM_API_KEY	Optional	LiteLLM API key.
LITELLM_MODEL	gpt-4.1 (default)	LiteLLM model.
LMSTUDIO_BASE_URL	http://localhost:1234/v1 (default)	LM Studio base URL; /v1 is appended when omitted.
LMSTUDIO_API_KEY	Optional	LM Studio API key.
LMSTUDIO_MODEL	For example openai/gpt-oss-20b	LM Studio model.
DISABLE_THINKING	true / false	Disables thinking for providers that support it, including DeepSeek.
WEB_GROUNDING	true / false	Enables web search by default.
WEB_SEARCH_PROVIDER	auto, native, searxng, tavily, exa	Selects the search mode. auto uses native search for OpenAI, Google, and Anthropic and otherwise leaves search off unless an external provider is selected.
WEB_SEARCH_MAX_RESULTS	5 (default), maximum 10	Maximum external search results added to model context.
SEARXNG_BASE_URL	Optional URL	Self-hosted SearXNG base URL.
TAVILY_API_KEY, EXA_API_KEY	Optional	Credentials for hosted search providers.
EXTENDED_REASONING	true / false	Enables extended reasoning where supported.
LLM_GENERATION_PROFILE	fast, balanced (default), deep, model_max	Global generation profile.
LLM_MAX_OUTPUT_TOKENS	Optional positive integer	Output-token override for every text provider.
LLM_CONTEXT_WINDOW	Optional positive integer	AI editor context limit in tokens. Set this to the actual deployed limit for custom/local models. Otherwise the editor uses model metadata, or assumes 32,768 for unknown aliases. Budgeting estimates messages and tool schemas with a safety margin, compacts older context, and retries a provider-rejected overflow once.
MAX_OUTLINE_WORDS	100 (default), positive integer	Maximum words in each generated, edited, or slides_markdown slide outline.
LLM_REASONING_MODE	auto, enabled, disabled	Global reasoning-mode override.
LLM_REASONING_EFFORT	default, none, minimal, low, medium, high, xhigh, max	Reasoning-effort override.
LLM_REASONING_BUDGET_TOKENS	Optional non-negative integer	Reasoning token budget.

<!-- Brave and Serper search providers and their credentials are hidden until they are tested. -->

All advanced text-provider settings are optional. Use Reset advanced settings in Settings or onboarding to remove overrides and inherit application/provider defaults.

Ollama

Use when LLM is ollama:

Variable	Values / default	Purpose
OLLAMA_URL	For example http://host.docker.internal:11434 from Docker	Ollama HTTP API base URL. Local servers and proxy path prefixes are supported. Model discovery and downloads reject query/fragment URLs and redirects; configure the final API base URL.
OLLAMA_MODEL	For example llama3.2:3b	Ollama model name.
START_OLLAMA	false (default), true	Allows the container entrypoint (start.js) to install Ollama and run ollama serve.

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

Variable	Values / default	Purpose
DATABASE_URL	Optional SQLAlchemy URL	Configures the database; when unset, the app uses SQLite under app data.
MIGRATE_DATABASE_ON_STARTUP	true (default), false	Runs database migrations during startup. Set to false only when migrations are managed externally.

Image generation

These variables match docker-compose.yml. IMAGE_PROVIDER selects the backend (pexels, pixabay, gemini_flash, nanobanana_pro, gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, 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).

Variable	Values / default	Purpose
DISABLE_IMAGE_GENERATION	true / false	Disables slide image generation.
ENABLE_PARALLEL_IMAGE_GENERATION	true (default), false	Allows concurrent image-provider requests. Set to false for providers with strict rate limits.
IMAGE_PROVIDER	pexels, pixabay, gemini_flash, nanobanana_pro, gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, comfyui, open_webui, openai_compatible	Selects the image backend.
PEXELS_API_KEY	Required for IMAGE_PROVIDER=pexels	Pexels stock-image API key.
PIXABAY_API_KEY	Required for IMAGE_PROVIDER=pixabay	Pixabay stock-image API key.
GPT_IMAGE_2_QUALITY	low, medium (default), high	GPT Image 2 image quality.
GPT_IMAGE_2_5_QUALITY	low, medium (default), high, xhigh, max, auto	Shared image quality for GPT Image 2.5 Flare and Sunburst.
COMFYUI_URL / COMFYUI_WORKFLOW	Required for IMAGE_PROVIDER=comfyui	Self-hosted ComfyUI endpoint and workflow JSON.
OPEN_WEBUI_IMAGE_URL / OPEN_WEBUI_IMAGE_API_KEY	Required for IMAGE_PROVIDER=open_webui	Open WebUI API root (http://host:8080/api/v1; a bare origin gets /api/v1 appended) and API key.
OPENAI_COMPAT_IMAGE_BASE_URL / OPENAI_COMPAT_IMAGE_API_KEY / OPENAI_COMPAT_IMAGE_MODEL	Required for IMAGE_PROVIDER=openai_compatible	Sends image requests to an OpenAI-compatible /v1/images/* endpoint such as LiteLLM, Azure, or a vLLM gateway.

When no image provider is set and only OpenAI credentials are configured, Presenton defaults to gpt-image-2.5-flare at medium quality. Set IMAGE_PROVIDER=gpt-image-2.5-sunburst to use Sunburst instead. Both use OPENAI_API_KEY and GPT_IMAGE_2_5_QUALITY.

Existing IMAGE_PROVIDER=gpt-image-1.5 and gpt-image-1.5-2025-12-16 configurations automatically migrate to gpt-image-2.5-flare. Their GPT_IMAGE_1_5_QUALITY value is preserved unless GPT_IMAGE_2_5_QUALITY is explicitly set. The old quality variable is accepted only for migration.

Existing IMAGE_PROVIDER=dall-e-3 configurations automatically migrate to gpt-image-2. Legacy standard quality maps to medium, and hd maps to high. Set GPT_IMAGE_2_QUALITY to choose a different quality.

The parallel image generation option applies everywhere images are generated: initial presentation generation, slide editing and regeneration, direct image requests, and assistant image tools.

Telemetry

Variable	Values / default	Purpose
DISABLE_ANONYMOUS_TRACKING	true / false	Set to true to disable anonymous telemetry.

Multi-user authentication

Presenton supports multiple accounts with a private workspace for each user. The first account becomes the primary administrator and can create, reset, or remove other accounts from Admin → Users.

Existing single-user installations are upgraded automatically: the current account becomes the primary administrator, while its presentations, templates, tasks, and other owned data stay attached to the same account.

Set up the primary administrator

On a new installation, open Presenton and follow the account setup screen. For an unattended Docker deployment, you can create the primary administrator on first boot with environment variables:

docker run -it --name presenton \
  -p 5001:80 \
  -e AUTH_USERNAME=admin \
  -e AUTH_PASSWORD=change-this-password \
  -v "./app_data:/app_data" \
  ghcr.io/presenton/presenton:latest

Usernames must contain at least 3 characters, and new passwords must contain at least 8 characters. Older six- or seven-character passwords remain valid after an upgrade.

Authentication environment variables

Variable	Purpose
AUTH_USERNAME	Username used to create the primary administrator on first boot. It can also change the username during a rotation or recovery.
AUTH_PASSWORD	Password used for first-time setup, rotation, or recovery. Required when using either flag below.
AUTH_OVERRIDE_FROM_ENV=[true/false]	Replace the primary administrator's credentials from the environment on the next startup. Use this for a deployment-managed credential rotation.
RESET_AUTH=[true/false]	Recover access to the existing primary administrator without replacing the account or its data.

Presenton Cloud provider

Presenton Cloud is an optional, installation-wide generation provider. It is not an authentication method for the self-hosted instance. Create or sign in to the local administrator account first, then connect Presenton from provider onboarding.

Only the local administrator can connect, replace, or disconnect the provider. The browser displays a short device code and opens the hosted Presenton approval page. After approval, the delegated access and rotating refresh tokens are encrypted at rest and stored as one global provider credential; they are never returned to the browser or stored per local user.

Selecting Presenton as the text provider saves LLM=presenton. Presentation generation and document uploads then use the Presenton Cloud API and its token. Connecting the provider alone does not change generation: when another provider is selected, the existing local generation pipeline remains unchanged. Disconnecting revokes and removes the global credentials and deselects Presenton.

No OAuth client registration, client secret, or environment configuration is required. Official builds contain the cloud URL and first-party public device-flow client ID.

To rotate credentials from the environment:

docker stop presenton
docker rm presenton
docker run -it --name presenton \
  -p 5001:80 \
  -e AUTH_USERNAME=admin \
  -e AUTH_PASSWORD=new-secure-password \
  -e AUTH_OVERRIDE_FROM_ENV=true \
  -v "./app_data:/app_data" \
  ghcr.io/presenton/presenton:latest

For account recovery, use the same command with RESET_AUTH=true instead of AUTH_OVERRIDE_FROM_ENV=true. Both operations preserve the administrator's user ID and owned data, and invalidate existing browser sessions and API keys. Remove the one-time flag after the successful startup.

[!IMPORTANT] Do not remove authentication fields from app_data/userConfig.json to reset access. Presenton stores a hashed recovery copy of the primary administrator credentials and the session-signing secret there. Use the recovery variables above to preserve the database account and its ownership links.

To sign out, open Settings → Other → Sign out.

API and MCP authentication

Presenton exposes a client-neutral MCP 2025-11-25 Streamable HTTP endpoint at /mcp. When authentication is enabled, REST API and MCP clients use the same administrator-provisioned, user-scoped API key. Browser JWT cookies are not accepted as MCP credentials.

1. An administrator creates the target Presenton user, then calls POST /api/v1/admin/api-keys from an authenticated admin session with {"user_id":"...","label":"My API client","expiry_days":90}. The response contains the new key. Listing and revocation use GET /api/v1/admin/api-keys and POST /api/v1/admin/api-keys/{api_key_id}/revoke. An administrator can securely reveal a key again with GET /api/v1/admin/api-keys/{api_key_id}/token.

2. Configure any Streamable HTTP MCP client to send the generated sk-presenton-... key on every request:

{
  "servers": {
    "presenton": {
      "url": "http://localhost:5001/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer sk-presenton-0123456789abcdef.REPLACE_WITH_SECRET"
      }
    }
  },
  "inputs": []
}

Notes:

• This example uses VS Code's .vscode/mcp.json format. Use the equivalent Streamable HTTP and bearer-header configuration in Open WebUI or any other conforming MCP client.
• API keys retain an Argon2 authentication hash and an encrypted, admin-only recoverable copy. They expire by default after 90 days and represent exactly the selected Presenton user. The same key authenticates general REST endpoints and MCP, but cannot sign in to the browser or change admin/provider settings.
• The API key is exchanged inside the MCP process for a short-lived internal user session. The long-lived key is never forwarded to presentation APIs.
• Revoking the key through the admin API takes effect immediately.
• Standard, Smart Mode, and template generation tools return an async task ID. Poll get_job_status until completed or error; template listing is immediate.
• MCP exposes only the polling Smart workflow (start_smart_presentation followed by get_job_status) so Standard and Smart generation use the same job model.
• upload_template_assets accepts one PPTX and its replacement fonts in a single call, then returns the data needed by start_template_generation.
• upload_files accepts reference documents and images as base64 and returns user-scoped paths that can be passed unchanged to Standard or Smart generation.
• External REST API and MCP access are not available in the Electron desktop app (PRESENTON_ELECTRON=true). Its local HTTP servers are internal application services. Electron runs without account login by default and supplies a private credential generated at each launch to its own app and export requests; anonymous local clients cannot access those services. The MCP server remains disabled there.
• Only asset subdirectories are served under /app_data; configuration, databases and logs are never web assets. Document preview readers accept .txt document files within the allowed asset/temp directories and reject export task JSON and private application files.

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

<br> <br>

Docker Run Examples by Provider

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

• Using OpenAI

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="openai" -e OPENAI_API_KEY="******" -e IMAGE_PROVIDER="gpt-image-2.5-flare" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Google

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="google" -e GOOGLE_API_KEY="******" -e IMAGE_PROVIDER="gemini_flash" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Vertex AI (API key mode)

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="vertex" -e VERTEX_API_KEY="******" -e VERTEX_MODEL="gemini-2.5-flash" -e IMAGE_PROVIDER="gemini_flash" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Azure OpenAI

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="azure" -e AZURE_OPENAI_API_KEY="******" -e AZURE_OPENAI_MODEL="gpt-4.1" -e AZURE_OPENAI_API_VERSION="2024-10-21" -e AZURE_OPENAI_ENDPOINT="https://YOUR-RESOURCE.openai.azure.com" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Amazon Bedrock (on-demand model ID) — see docs/amazon-bedrock.md for inference profiles, IAM, and troubleshooting.

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="bedrock" -e BEDROCK_REGION="us-east-1" -e BEDROCK_AWS_ACCESS_KEY_ID="******" -e BEDROCK_AWS_SECRET_ACCESS_KEY="******" -e BEDROCK_MODEL="us.anthropic.claude-3-5-haiku-20241022-v1:0" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Amazon Bedrock (inference profile ARN, e.g. Claude Sonnet 4.6)

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="bedrock" -e BEDROCK_REGION="us-east-1" -e BEDROCK_AWS_ACCESS_KEY_ID="******" -e BEDROCK_AWS_SECRET_ACCESS_KEY="******" -e BEDROCK_MODEL="arn:aws:bedrock:us-east-1:YOUR_ACCOUNT_ID:inference-profile/us.anthropic.claude-sonnet-4-6" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Fireworks

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="fireworks" -e FIREWORKS_API_KEY="******" -e FIREWORKS_MODEL="accounts/fireworks/models/llama-v3p1-8b-instruct" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Together AI

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="together" -e TOGETHER_API_KEY="******" -e TOGETHER_MODEL="openai/gpt-oss-20b" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Ollama

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="ollama" -e OLLAMA_MODEL="llama3.2:3b" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="*******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using Anthropic

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="anthropic" -e ANTHROPIC_API_KEY="******" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using LM Studio (local)

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e LLM="lmstudio" -e LMSTUDIO_BASE_URL="http://host.docker.internal:1234" -e LMSTUDIO_MODEL="openai/gpt-oss-20b" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using OpenAI Compatible LLM API

  <pre><code class="language-bash">docker run -it -p 5001:80 -e LLM="custom" -e CUSTOM_LLM_URL="http://*****" -e CUSTOM_LLM_API_KEY="*****" -e CUSTOM_MODEL="llama3.2:3b" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="********" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• 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:

  <pre><code class="language-bash">docker run -it --name presenton --gpus=all -p 5001:80 -e LLM="ollama" -e OLLAMA_MODEL="llama3.2:3b" -e IMAGE_PROVIDER="pexels" -e PEXELS_API_KEY="*******" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

• Using an OpenAI-Compatible Image Provider

  This routes all slide image requests through your OpenAI-compatible gateway (LiteLLM, Azure, vLLM, etc.) while keeping the text LLM configuration independent:

  <pre><code class="language-bash">docker run -it --name presenton -p 5001:80 -e IMAGE_PROVIDER="openai_compatible" -e OPENAI_COMPAT_IMAGE_BASE_URL="https://proxy.example.com/v1" -e OPENAI_COMPAT_IMAGE_API_KEY="******" -e OPENAI_COMPAT_IMAGE_MODEL="gpt-image-1" -v "./app_data:/app_data" ghcr.io/presenton/presenton:latest</code></pre>

✨ Generate Presentation via API

Generate Presentation

<p> <strong>Endpoint:</strong> <code>/api/v1/ppt/presentation/generate</code><br> <strong>Method:</strong> <code>POST</code><br> <strong>Content-Type:</strong> <code>application/json</code> </p> <p> <strong>Authentication (API key):</strong><br> All <code>/api/v1/</code> routes except the public authentication endpoints require authentication. An administrator creates an access key under <strong>Admin → API keys</strong>. Send that <code>sk-presenton-...</code> key as <code>Authorization: Bearer YOUR_KEY</code>. API keys act as their owning user and cannot call browser-session-only administrator endpoints. </p>

Request Body

<table> <thead> <tr> <th>Parameter</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>content</code></td> <td>string</td> <td>Yes</td> <td>Main content used to generate the presentation. When using <code>slides_markdown</code> without an additional overall prompt, pass an empty string.</td> </tr> <tr> <td><code>slides_markdown</code></td> <td>string[] | null</td> <td>No</td> <td>Provide one Markdown string per slide instead of asking Presenton to generate the slide outlines. The array length determines the number of slides.</td> </tr> <tr> <td><code>instructions</code></td> <td>string | null</td> <td>No</td> <td>Additional generation instructions.</td> </tr> <tr> <td><code>tone</code></td> <td>string</td> <td>No</td> <td> Text tone (default: <code>"default"</code>). Options: <code>default</code>, <code>casual</code>, <code>professional</code>, <code>funny</code>, <code>educational</code>, <code>sales_pitch</code> </td> </tr> <tr> <td><code>verbosity</code></td> <td>string</td> <td>No</td> <td> Content density (default: <code>"standard"</code>). Options: <code>concise</code>, <code>standard</code>, <code>text-heavy</code> </td> </tr> <tr> <td><code>web_search</code></td> <td>boolean</td> <td>No</td> <td>Enable web search grounding (default: <code>false</code>).</td> </tr> <tr> <td><code>n_slides</code></td> <td>integer</td> <td>No</td> <td>Number of slides to generate. When omitted, the count is auto-detected. When using <code>slides_markdown</code>, its array length is used and <code>n_slides</code> can be omitted.</td> </tr> <tr> <td><code>language</code></td> <td>string</td> <td>No</td> <td>Presentation language (default: <code>"English"</code>).</td> </tr> <tr> <td><code>template</code></td> <td>string</td> <td>No</td> <td>Template name (default: <code>"general"</code>).</td> </tr> <tr> <td><code>include_table_of_contents</code></td> <td>boolean</td> <td>No</td> <td>Include table of contents slide (default: <code>false</code>).</td> </tr> <tr> <td><code>include_title_slide</code></td> <td>boolean</td> <td>No</td> <td>Include title slide (default: <code>true</code>).</td> </tr> <tr> <td><code>files</code></td> <td>string[] | null</td> <td>No</td> <td> Files to use in generation. Upload first via <code>/api/v1/ppt/files/upload</code>. </td> </tr> <tr> <td><code>export_as</code></td> <td>string</td> <td>No</td> <td> Export format (default: <code>"pptx"</code>). Options: <code>pptx</code>, <code>pdf</code> </td> </tr> </tbody> </table>

Response

<pre><code class="language-json">{ "presentation_id": "string", "path": "string", "edit_path": "string" }</code></pre>

Example (curl + API key)

<pre><code class="language-bash">curl \ -X POST http://localhost:5001/api/v1/ppt/presentation/generate \ -H "Authorization: Bearer sk-presenton-YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "content": "Introduction to Machine Learning", "n_slides": 5, "language": "English", "template": "general", "export_as": "pptx" }'</code></pre>

Example: provide the content for every slide with slides_markdown

Each array item becomes one slide. Use ordinary Markdown headings, lists, emphasis, and tables to describe the audience-facing content. The <code>content</code> field is currently required by the API schema, so set it to an empty string when you do not want to provide an additional overall prompt.

<pre><code class="language-bash">curl \ -X POST http://localhost:5001/api/v1/ppt/presentation/generate \ -H "Authorization: Bearer sk-presenton-YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "content": "", "slides_markdown": [ "# Acme Q2 Review\n\nRevenue grew **18% year over year** while customer retention reached 94%.", "# What changed\n\n- Enterprise revenue increased 24%\n- Support response time fell to 42 minutes\n- Expansion revenue offset slower new-logo growth", "# Next quarter\n\n1. Launch the self-service onboarding flow\n2. Expand the enterprise pilot program\n3. Reduce infrastructure cost per account by 10%" ], "template": "general", "language": "English", "export_as": "pdf" }'</code></pre>

Example: provide numeric data for a chart or table layout

Markdown tables with numeric columns help Presenton select a compatible chart or table layout. You can use <code>instructions</code> for presentation-level visual direction without adding those directions to the visible slide text.

<pre><code class="language-bash">curl \ -X POST http://localhost:5001/api/v1/ppt/presentation/generate \ -H "Authorization: Bearer sk-presenton-YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "content": "", "slides_markdown": [ "# Regional revenue\n\n| Region | Q1 | Q2 |\n| --- | ---: | ---: |\n| North America | 2.4 | 2.9 |\n| Europe | 1.7 | 2.1 |\n| Asia Pacific | 1.1 | 1.6 |", "# Key takeaway\n\nAsia Pacific grew fastest at **45%**, while North America remained the largest market." ], "instructions": "Use a bar chart for slide 1 and an emphasis layout for slide 2.", "template": "general", "export_as": "pptx" }'</code></pre> <blockquote> <strong>How <code>slides_markdown</code> works:</strong> It skips AI outline generation, but it is not a deterministic Markdown-to-slide renderer. Presenton still uses the configured text LLM to select suitable layouts and map each Markdown item into the template's structured fields, so text may be rephrased to fit. Provide at most 50 array items. Each item is limited to 100 words by default; longer items are truncated. Self-hosted deployments can change the per-slide limit with <code>MAX_OUTLINE_WORDS</code>. </blockquote>

Example Response

<pre><code class="language-json">{ "presentation_id": "d3000f96-096c-4768-b67b-e99aed029b57", "path": "/app_data/d3000f96-096c-4768-b67b-e99aed029b57/Introduction_to_Machine_Learning.pptx", "edit_path": "/presentation?id=d3000f96-096c-4768-b67b-e99aed029b57" }</code></pre> <blockquote> <strong>Note:</strong> Prepend your server’s root URL to <code>path</code> and <code>edit_path</code> to construct valid links. </blockquote>

Documentation & Tutorials

<ul> <li> <a href="https://docs.presenton.ai/v3/get-started/quickstart"> Deploy Presenton </a> </li> <li> <a href="https://docs.presenton.ai/v3/get-started/api-introduction"> Full API Documentation </a> </li> <li> <a href="https://docs.presenton.ai/v3/guide/using-presenton-api"> Generate Presentations via API in 5 Minutes </a> </li> <li> <a href="https://docs.presenton.ai/tutorial/generate-presentation-from-csv"> Create Presentations from CSV using AI </a> </li> <li> <a href="https://docs.presenton.ai/tutorial/create-data-reports-using-ai"> Create Data Reports Using AI </a> </li> </ul>

🚀 Roadmap

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