title: SlideDeck AI emoji: 🏢 colorFrom: yellow colorTo: green sdk: streamlit sdk_version: 1.55.0 app_file: app.py pinned: false license: mit

SlideDeck AI: The AI Assistant for Professional Presentations

We all spend countless hours creating slides and meticulously organizing our thoughts for any presentation.

SlideDeck AI is your powerful AI assistant for presentation generation. Co-create stunning, professional slide decks on any topic with the help of cutting-edge Artificial Intelligence and Large Language Models.

The workflow is simple: Describe your topic, and let SlideDeck AI generate a complete PowerPoint slide deck for you—it's that easy!

Star History

How It Works: The Automated Deck Generation Process

SlideDeck AI streamlines the creation process through the following steps:

1. AI Content Generation: Given a topic description, a Large Language Model (LLM) generates the initial slide content as structured JSON data based on a pre-defined schema.
2. Visual Enhancement: It uses keywords from the JSON output to search and download relevant images, which are added to the presentation with a certain probability.
3. PPTX Assembly: Subsequently, the powerful python-pptx library is used to generate the slides based on the structured JSON data. A user can choose from a set of pre-defined presentation templates.
4. Refinement & Iteration: At this stage onward, a user can provide additional instructions to refine the content (e.g., "add another slide," or "modify an existing slide"). A history of instructions is maintained for seamless iteration.
5. Instant Download: Every time SlideDeck AI generates a PowerPoint presentation, a download button is provided to instantly save the file.

In addition, SlideDeck AI can also create a presentation based on PDF files, transforming documents into decks!

Python API Quickstart

from slidedeckai.core import SlideDeckAI


slide_generator = SlideDeckAI(
    model='[gg]gemini-2.5-flash-lite',
    topic='Make a slide deck on AI',
    api_key='your-google-api-key',  # Or set via environment variable
)
pptx_path = slide_generator.generate()
print(f'🤖 Generated slide deck: {pptx_path}')

CLI Usage

Generate a new slide deck:

slidedeckai generate --model '[gg]gemini-2.5-flash-lite' --topic 'Make a slide deck on AI' --api-key 'your-google-api-key'

Launch the Streamlit app:

slidedeckai launch

List supported models (these are the only models supported by SlideDeck AI):

slidedeckai --list-models

Unmatched Flexibility: Choose Your AI Brain

SlideDeck AI stands out by supporting a wide array of LLMs from several online providers—Azure/ OpenAI, Google, SambaNova, Together AI, and OpenRouter. This gives you flexibility and control over your content generation style.

Most supported service providers also offer generous free usage tiers, meaning you can often start building without immediate billing concerns.

Model names in SlideDeck AI are specified in the [code]model-name format. It begins with a two-character prefix code in square brackets to indicate the provider, for example, [oa] for OpenAI, [gg] for Google Gemini, and so on. Following the code, the model name is specified, for example, gemini-2.5-flash or gpt-4o. So, to use Google Gemini 2.5 Flash Lite, the model name would be [gg]gemini-2.5-flash-lite.

Based on several experiments, SlideDeck AI generally recommends the use of Gemini Flash and GPT-4o (Azure OpenAI) to generate the best-quality slide decks.

The supported LLMs offer different styles of content generation. Use one of the following LLMs along with relevant API keys/access tokens, as appropriate, to create the content of the slide deck:

🔒 IMPORTANT: Your Privacy and Security are Paramount

SlideDeck AI does NOT store your API keys/tokens or transmit them elsewhere. Your key is only used to invoke the relevant LLM for content generation—and that's it! As a fully Open-Source project, we encourage you to audit the code yourself for complete peace of mind.

In addition, offline LLMs provided by Ollama can be used. Read below to know more.

Icons

SlideDeck AI uses a subset of icons from bootstrap-icons-1.11.3 (MIT license) in the slides. A few icons from SVG Repo (CC0, MIT, and Apache licenses) are also used.

Local Development

SlideDeck AI uses LLMs via different providers. To run this project by yourself, you need to use an appropriate API key, for example, in a .env file. Alternatively, you can provide the access token in the app's user interface itself (UI).

Ultimate Privacy: Offline Generation with Ollama

SlideDeck AI allows the use of offline LLMs to generate the contents of the slide decks. This is typically suitable for individuals or organizations who would like to use self-hosted LLMs for privacy concerns, for example.

Offline LLMs are made available via Ollama. Therefore, a pre-requisite here is to have Ollama installed on the system and the desired LLM pulled locally. You should choose a model to use based on your hardware capacity. However, if you have no GPU, gemma3:1b can be a suitable model to run only on CPU.

In addition, the RUN_IN_OFFLINE_MODE environment variable needs to be set to True to enable the offline mode. This, for example, can be done using a .env file or from the terminal. The typical steps to use SlideDeck AI in offline mode (in a bash shell) are as follows:

# Environment initialization, especially on Debian
sudo apt update -y
sudo apt install python-is-python3 -y
sudo apt install git -y
# Change the package name based on the Python version installed: python -V
sudo apt install python3.11-venv -y

# Install Git Large File Storage (LFS)
sudo apt install git-lfs -y
git lfs install

ollama list  # View locally available LLMs
export RUN_IN_OFFLINE_MODE=True  # Enable the offline mode to use Ollama
git clone [https://github.com/barun-saha/slide-deck-ai.git](https://github.com/barun-saha/slide-deck-ai.git)
cd slide-deck-ai
git lfs pull  # Pull the PPTX template files - ESSENTIAL STEP!

python -m venv venv  # Create a virtual environment
source venv/bin/activate  # On a Linux system
pip install -r requirements.txt

streamlit run ./app.py  # Run the application

💡If you have cloned the repository locally but cannot open and view the PPTX templates, you may need to run git lfs pull to download the template files. Without this, although content generation will work, the slide deck cannot be created.

The .env file should be created inside the slide-deck-ai directory.

The UI is similar to the online mode. However, rather than selecting an LLM from a list, one has to write the name of the Ollama model to be used in a textbox. There is no API key asked here.

The online and offline modes are mutually exclusive. So, setting RUN_IN_OFFLINE_MODE to False will make SlideDeck AI use the online LLMs (i.e., the "original mode."). By default, RUN_IN_OFFLINE_MODE is set to False.

Finally, the focus is on using offline LLMs, not going completely offline. So, Internet connectivity would still be required to fetch the images from Pexels.

Live Demo

Experience the power now!

• 🚀 Live App: Try SlideDeck AI on Hugging Face Spaces
• 🎥 Quick Demo: Watch the core chat interface in action (YouTube)
• 🤝 Enterprise Showcase: See a demonstration using Azure OpenAI (YouTube)

🏆 Recognized Excellence

SlideDeck AI has won the 3rd Place in the Llama 2 Hackathon with Clarifai in 2023.

Contributors

SlideDeck AI is glad to have the following community contributions:

• Aditya: added support for page range selection for PDF files and new chat button.
• Sagar Bharatbhai Bharadia: added support for Gemini 2.5 Flash Lite and Gemini 2.5 Flash LLMs.
• Sairam Pillai: unified the project's LLM access by migrating the API calls to LiteLLM.
• Srinivasan Ragothaman: added OpenRouter support and API keys mapping from the .env file.
• Zakir Jiwani: updated SambaNova models.

Thank you all for your contributions!