Pylint & CVE fix

.codecov.yml

@@ -1,10 +0,0 @@
-ignore:
-  # Exclude the version file from all coverage calculations
-  - "src/slidedeckai/_version.py"
-
-coverage:
-  status:
-    patch:
-      default:
-        target: 80%
-        threshold: 5%

.coveragerc

@@ -1,15 +0,0 @@
-[run]
-source = src/slidedeckai
-omit =
-    tests/*
-    */__init__.py
-    setup.py
-
-[report]
-exclude_lines =
-    pragma: no cover
-    def __repr__
-    if __name__ == '__main__':
-    raise NotImplementedError
-    pass
-    raise ImportError

.env.example

@@ -1,10 +0,0 @@
-# Example .env file for SlideDeck AI
-# Add your API keys and configuration values here
-
-PEXEL_API_KEY=your-pexel-key-for-images
-
-TOGETHER_API_KEY=your-together-ai-key
-OPENROUTER_API_KEY=your-openrouter-api-key
-
-RUN_IN_OFFLINE_MODE=true-or-false
-DEFAULT_MODEL_INDEX=3

.gitattributes

@@ -33,5 +33,3 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
-*.pptx filter=lfs diff=lfs merge=lfs -text
-pptx_templates/Minimalist_sales_pitch.pptx filter=lfs diff=lfs merge=lfs -text

.github/copilot-instructions.md

@@ -1,14 +0,0 @@
-1. In Python code, always use single quote for strings unless double quotes are necessary. Use triple double quotes for docstrings.
-2. When defining functions, always include type hints for parameters and return types.
-3. Except for logs, use f-strings for string formatting instead of other methods like % or .format().
-4. Use Google-style docstrings for all functions and classes.
-5. Two blank lines should precede top-level function and class definitions. One blank line between methods inside a class.
-6. Max line length is 100 characters. Use brackets to break long lines. Wrap long strings (or expressions) inside ( and ).
-7. Split long lines at braces, e.g., like this:
-   my_function(
-       param1,
-       param2
-   )
-  NOT like this:
-   my_function(param1,
-               param2)

.github/workflows/codeql.yml

@@ -1,98 +0,0 @@
-# For most projects, this workflow file will not need changing; you simply need
-# to commit it to your repository.
-#
-# You may wish to alter this file to override the set of languages analyzed,
-# or to provide custom queries or build logic.
-#
-# ******** NOTE ********
-# We have attempted to detect the languages in your repository. Please check
-# the `language` matrix defined below to confirm you have the correct set of
-# supported CodeQL languages.
-#
-name: "CodeQL Advanced"
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-  schedule:
-    - cron: '35 12 * * 6'
-
-jobs:
-  analyze:
-    name: Analyze (${{ matrix.language }})
-    # Runner size impacts CodeQL analysis time. To learn more, please see:
-    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
-    #   - https://gh.io/supported-runners-and-hardware-resources
-    #   - https://gh.io/using-larger-runners (GitHub.com only)
-    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
-    runs-on: ubuntu-latest
-    permissions:
-      # required for all workflows
-      security-events: write
-
-      # required to fetch internal or private CodeQL packs
-      packages: read
-
-      # only required for workflows in private repositories
-      actions: read
-      contents: read
-
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-        - language: python
-          build-mode: none
-        # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift'
-        # Use `c-cpp` to analyze code written in C, C++ or both
-        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
-        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
-        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
-        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
-        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
-        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v4
-
-    # Add any setup steps before running the `github/codeql-action/init` action.
-    # This includes steps like installing compilers or runtimes (`actions/setup-node`
-    # or others). This is typically only required for manual builds.
-    # - name: Setup runtime (example)
-    #   uses: actions/setup-example@v1
-
-    # Initializes the CodeQL tools for scanning.
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@v3
-      with:
-        languages: ${{ matrix.language }}
-        build-mode: ${{ matrix.build-mode }}
-        # If you wish to specify custom queries, you can do so here or in a config file.
-        # By default, queries listed here will override any specified in a config file.
-        # Prefix the list here with "+" to use these queries and those in the config file.
-
-        # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
-        # queries: security-extended,security-and-quality
-
-    # If the analyze step fails for one of the languages you are analyzing with
-    # "We were unable to automatically build your code", modify the matrix above
-    # to set the build mode to "manual" for that language. Then modify this step
-    # to build your code.
-    # ℹ️ Command-line programs to run using the OS shell.
-    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
-    - if: matrix.build-mode == 'manual'
-      shell: bash
-      run: |
-        echo 'If you are using a "manual" build mode for one or more of the' \
-          'languages you are analyzing, replace this with the commands to build' \
-          'your code, for example:'
-        echo '  make bootstrap'
-        echo '  make release'
-        exit 1
-
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v3
-      with:
-        category: "/language:${{matrix.language}}"

.github/workflows/pr-workflow.yml

@@ -1,51 +0,0 @@
-name: PR Check
-
-on:
-  pull_request:
-    branches: [ "main" ]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12"]
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
-
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
-        pip install pytest pytest-asyncio pytest-cov
-
-    - name: Run tests with coverage
-      run: |
-        pytest tests/unit --asyncio-mode=auto --cov=src/slidedeckai --cov-report=xml --cov-report=html
-
-    - name: Upload test results and coverage
-      uses: actions/upload-artifact@v4
-      if: always()
-      with:
-        name: pytest-results-py${{ matrix.python-version }}
-        path: |
-          htmlcov
-          coverage.xml
-        retention-days: 30
-
-    - name: Coverage Report
-      uses: codecov/codecov-action@v5
-      with:
-        # Provide the Codecov upload token from repo secrets
-        token: ${{ secrets.CODECOV_TOKEN }}
-        # Path to the coverage XML produced by pytest-cov
-        files: ./coverage.xml
-        # Fail the job if Codecov returns an error
-        fail_ci_if_error: true
-        verbose: true

.github/workflows/publish-to-pypi.yml

@@ -1,47 +0,0 @@
-name: Publish to PyPI
-
-on:
-  workflow_dispatch:
-  push:
-    tags:
-      - 'v*'
-
-permissions:
-  contents: read  # Default read permission for all jobs
-  id-token: write  # Overridden for the pypi-publish job
-
-jobs:
-  pypi-publish:
-    name: Upload release to PyPI
-    runs-on: ubuntu-latest
-    environment:
-      name: pypi
-      url: https://pypi.org/p/slidedeckai
-    permissions:
-      id-token: write  # Enables OIDC authentication
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          lfs: true  # This ensures Git LFS files are downloaded
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-
-      - name: Install build tools
-        run: |
-          python -m pip install --upgrade pip
-          pip install build
-
-      - name: Build package
-        run: |
-          rm -rf dist/ build/ *.egg-info
-          python -m build
-
-      - name: Publish package to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist

.gitignore

@@ -144,5 +144,3 @@ dmypy.json
 # Cython debug symbols
 cython_debug/
 
-.DS_Store
-.idea/**/.DS_Store

.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,14 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="PyPackageRequirementsInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ignoredPackages">
+        <value>
+          <list size="1">
+            <item index="0" class="java.lang.String" itemvalue="numpy" />
+          </list>
+        </value>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.10 (slide-deck-ai)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.10 (slide-deck-ai)" project-jdk-type="Python SDK" />
+</project>

.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/slide-deck-ai.iml" filepath="$PROJECT_DIR$/.idea/slide-deck-ai.iml" />
+    </modules>
+  </component>
+</project>

.idea/slide-deck-ai.iml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/venv" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

.readthedocs.yaml

@@ -1,17 +0,0 @@
-# .readthedocs.yaml
-version: 2
-
-build:
-  os: ubuntu-22.04
-  tools:
-    python: "3.10"
-
-sphinx:
-  configuration: docs/conf.py
-
-python:
-  install:
-    - method: pip
-      # Install the main project code (required for autodoc)
-      path: .
-    - requirements: docs/requirements.txt

.streamlit/config.toml

@@ -1,10 +0,0 @@
-[server]
-runOnSave = true
-headless = false
-maxUploadSize = 2
-
-[browser]
-gatherUsageStats = false
-
-[theme]
-base = "dark"

LITELLM_MIGRATION_SUMMARY.md

@@ -1,145 +0,0 @@
-# LiteLLM Integration Summary
-
-## Overview
-Successfully replaced LangChain with LiteLLM in the SlideDeck AI project, providing a uniform API to access all LLMs while reducing software dependencies and build times.
-
-## Changes Made
-
-### 1. Updated Dependencies (`requirements.txt`)
-**Before:**
-```txt
-langchain~=0.3.27
-langchain-core~=0.3.35
-langchain-community~=0.3.27
-langchain-google-genai==2.0.10
-langchain-cohere~=0.4.4
-langchain-together~=0.3.0
-langchain-ollama~=0.3.6
-langchain-openai~=0.3.28
-```
-
-**After:**
-```txt
-litellm>=1.55.0
-google-generativeai  # ~=0.8.3
-```
-
-### 2. Replaced LLM Helper (`helpers/llm_helper.py`)
-- **Removed:** All LangChain-specific imports and implementations
-- **Added:** LiteLLM-based implementation with:
-  - `stream_litellm_completion()`: Handles streaming responses from LiteLLM
-  - `get_litellm_llm()`: Creates LiteLLM-compatible wrapper objects
-  - `get_litellm_model_name()`: Converts provider/model to LiteLLM format
-  - `get_litellm_api_key()`: Manages API keys for different providers
-  - Backward compatibility alias: `get_langchain_llm = get_litellm_llm`
-
-### 3. Replaced Chat Components (`app.py`)
-**Removed LangChain imports:**
-```python
-from langchain_community.chat_message_histories import StreamlitChatMessageHistory
-from langchain_core.messages import HumanMessage
-from langchain_core.prompts import ChatPromptTemplate
-```
-
-**Added custom implementations:**
-```python
-class ChatMessage:
-    def __init__(self, content: str, role: str):
-        self.content = content
-        self.role = role
-        self.type = role  # For compatibility
-
-class HumanMessage(ChatMessage):
-    def __init__(self, content: str):
-        super().__init__(content, "user")
-
-class AIMessage(ChatMessage):
-    def __init__(self, content: str):
-        super().__init__(content, "ai")
-
-class StreamlitChatMessageHistory:
-    def __init__(self, key: str):
-        self.key = key
-        if key not in st.session_state:
-            st.session_state[key] = []
-    
-    @property
-    def messages(self):
-        return st.session_state[self.key]
-    
-    def add_user_message(self, content: str):
-        st.session_state[self.key].append(HumanMessage(content))
-    
-    def add_ai_message(self, content: str):
-        st.session_state[self.key].append(AIMessage(content))
-
-class ChatPromptTemplate:
-    def __init__(self, template: str):
-        self.template = template
-    
-    @classmethod
-    def from_template(cls, template: str):
-        return cls(template)
-    
-    def format(self, **kwargs):
-        return self.template.format(**kwargs)
-```
-
-### 4. Updated Function Calls
-- Changed `llm_helper.get_langchain_llm()` to `llm_helper.get_litellm_llm()`
-- Maintained backward compatibility with existing function names
-
-## Supported Providers
-
-The LiteLLM integration supports all the same providers as before:
-
-- **Azure OpenAI** (`az`): `azure/{model}`
-- **Cohere** (`co`): `cohere/{model}`
-- **Google Gemini** (`gg`): `gemini/{model}`
-- **Hugging Face** (`hf`): `huggingface/{model}` (commented out in config)
-- **Ollama** (`ol`): `ollama/{model}` (offline models)
-- **OpenRouter** (`or`): `openrouter/{model}`
-- **Together AI** (`to`): `together_ai/{model}`
-
-## Benefits Achieved
-
-1. **Reduced Dependencies:** Eliminated 8 LangChain packages, replaced with single LiteLLM package
-2. **Faster Build Times:** Fewer packages to install and resolve
-3. **Uniform API:** Single interface for all LLM providers
-4. **Maintained Compatibility:** All existing functionality preserved
-5. **Offline Support:** Ollama integration continues to work for offline models
-6. **Streaming Support:** Maintained streaming capabilities for real-time responses
-
-## Testing Results
-
-✅ **LiteLLM Import:** Successfully imported and initialized  
-✅ **LLM Helper:** Provider parsing and validation working correctly  
-✅ **Ollama Integration:** Compatible with offline Ollama models  
-✅ **Custom Chat Components:** Message history and prompt templates working  
-✅ **App Structure:** All required files present and functional  
-
-## Migration Notes
-
-- **Backward Compatibility:** Existing function names maintained (`get_langchain_llm` still works)
-- **No Breaking Changes:** All existing functionality preserved
-- **Environment Variables:** Same API key environment variables used
-- **Configuration:** No changes needed to `global_config.py`
-
-## Next Steps
-
-1. **Deploy:** The app is ready for deployment with LiteLLM
-2. **Monitor:** Watch for any provider-specific issues in production
-3. **Optimize:** Consider LiteLLM-specific optimizations (caching, retries, etc.)
-4. **Document:** Update user documentation to reflect the simplified dependency structure
-
-## Verification
-
-The integration has been thoroughly tested and verified to work with:
-- Multiple LLM providers (Google Gemini, Cohere, Together AI, etc.)
-- Ollama for offline models
-- Streaming responses
-- Chat message history
-- Prompt template formatting
-- Error handling and validation
-
-The SlideDeck AI application is now successfully running on LiteLLM with reduced dependencies and improved maintainability.

MANIFEST.in

@@ -1,6 +0,0 @@
-include src/slidedeckai/strings.json
-recursive-include src/slidedeckai/prompts *.txt
-recursive-include src/slidedeckai/pptx_templates *.pptx
-recursive-include src/slidedeckai/icons *.png
-recursive-include src/slidedeckai/icons *.txt
-recursive-include src/slidedeckai/file_embeddings *.npy

README.md

@@ -4,199 +4,48 @@ emoji: 🏢
 colorFrom: yellow
 colorTo: green
 sdk: streamlit
-sdk_version: 1.52.1
+sdk_version: 1.26.0
 app_file: app.py
 pinned: false
 license: mit
 ---
 
+# SlideDeck AI
 
-[![PyPI](https://img.shields.io/pypi/v/slidedeckai.svg)](https://pypi.org/project/slidedeckai/)
-[![codecov](https://codecov.io/gh/barun-saha/slide-deck-ai/branch/main/graph/badge.svg)](https://codecov.io/gh/barun-saha/slide-deck-ai)
-[![Documentation Status](https://readthedocs.org/projects/slidedeckai/badge/?version=latest)](https://slidedeckai.readthedocs.io/en/latest/?badge=latest)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Open in Streamlit](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://huggingface.co/spaces/barunsaha/slide-deck-ai)
+We spend a lot of time on creating the slides and organizing our thoughts for any presentation. 
+With SlideDeck AI, co-create slide decks on any topic with Generative Artificial Intelligence.
+Describe your topic and let SlideDeck AI generate a PowerPoint slide deck for you—it's as simple as that!
 
+SlideDeck AI is powered by [Mistral 7B Instruct](https://huggingface.co/mistralai/Mistral-7B-Instruct-v0.1).
+Originally, it was built using the Llama 2 API provided by Clarifai.
 
-# SlideDeck AI: The AI Assistant for Professional Presentations
+# Process
 
-We all spend countless hours **creating** slides and meticulously organizing our thoughts for any presentation.
+SlideDeck AI works in the following way:
 
-**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**.
+1. Given a topic description, it uses Mistral 7B Instruct to generate the outline/contents of the slides. 
+The output is generated as structured JSON data based on a pre-defined schema.
+2. Subsequently, it uses the `python-pptx` library to generate the slides, 
+based on the JSON data from the previous step. 
+Here, a user can choose from a set of three pre-defined presentation templates.
+3. In addition, it uses Metaphor to fetch Web pages related to the topic.
 
-**The workflow is simple:** Describe your topic, and let SlideDeck AI generate a complete **PowerPoint slide deck** for you—it's that easy!
+4. ~~Finally, it uses Stable Diffusion 2 to generate an image, based on the title and each slide heading.~~
 
 
-## Star History
+# Local Development
 
-[![Star History Chart](https://api.star-history.com/svg?repos=barun-saha/slide-deck-ai&type=Date)](https://star-history.com/#barun-saha/slide-deck-ai&Date)
-
-
-## 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
-
-<a target="_blank" href="https://colab.research.google.com/drive/1YA9EEmyiQFk03bOSc7lZnxK5l2hAL60l?usp=sharing">
-  <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
-</a>
-
-```python
-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:
-```bash
-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:
-```bash
-slidedeckai launch
-```
-
-List supported models (these are the only models supported by SlideDeck AI):
-```bash
-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.0-flash` or `gpt-4o`. So, to use Google Gemini 2.0 Flash Lite, the model name would be `[gg]gemini-2.0-flash-lite`.
-
-Based on several experiments, SlideDeck AI generally recommends the use of Gemini Flash and GPT-4o 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:
-
-| LLM                                 | Provider (code)          | Requires API key                                                                                                         | Characteristics          |
-|:------------------------------------|:-------------------------|:-------------------------------------------------------------------------------------------------------------------------|:-------------------------|
-| Claude Haiku 4.5                    | Anthropic (`an`)         | Mandatory; [get here](https://platform.claude.com/settings/keys)                                                         | Faster, detailed         |
-| Gemini 2.0 Flash                    | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey)                                                                | Faster, longer content   |
-| Gemini 2.0 Flash Lite               | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey)                                                                | Fastest, longer content  |
-| Gemini 2.5 Flash                    | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey)                                                                | Faster, longer content   |
-| Gemini 2.5 Flash Lite               | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey)                                                                | Fastest, longer content  |
-| GPT-4.1-mini                        | OpenAI (`oa`)            | Mandatory; [get here](https://platform.openai.com/settings/organization/api-keys)                                        | Faster, medium content   |
-| GPT-4.1-nano                        | OpenAI (`oa`)            | Mandatory; [get here](https://platform.openai.com/settings/organization/api-keys)                                        | Faster, shorter content  |
-| GPT-5                               | OpenAI (`oa`)            | Mandatory; [get here](https://platform.openai.com/settings/organization/api-keys)                                        | Slow, shorter content    |
-| GPT                                 | Azure OpenAI (`az`)      | Mandatory; [get here](https://ai.azure.com/resource/playground)  NOTE: You need to have your subscription/billing set up | Faster, longer content   |
-| Command R+                          | Cohere (`co`)            | Mandatory; [get here](https://dashboard.cohere.com/api-keys)                                                             | Shorter, simpler content |
-| Gemini-2.0-flash-001                | OpenRouter (`or`)        | Mandatory; [get here](https://openrouter.ai/settings/keys)                                                               | Faster, longer content   |
-| GPT-3.5 Turbo                       | OpenRouter (`or`)        | Mandatory; [get here](https://openrouter.ai/settings/keys)                                                               | Faster, longer content   |
-| DeepSeek-V3.1-Terminus              | SambaNova (`sn`)         | Mandatory; [get here](https://cloud.sambanova.ai/apis)                                                                   | Fast, detailed content   |
-| Llama-3.3-Swallow-70B-Instruct-v0.4 | SambaNova (`sn`)         | Mandatory; [get here](https://cloud.sambanova.ai/apis)                                                                   | Fast, shorter            |
-| DeepSeek V3-0324                    | Together AI (`to`)       | Mandatory; [get here](https://api.together.ai/settings/api-keys)                                                         | Slower, medium-length    |
-| Llama 3.3 70B Instruct Turbo        | Together AI (`to`)       | Mandatory; [get here](https://api.together.ai/settings/api-keys)                                                         | Slower, detailed         |
-| Llama 3.1 8B Instruct Turbo 128K    | Together AI (`to`)       | Mandatory; [get here](https://api.together.ai/settings/api-keys)                                                         | Faster, shorter          |
-
-> **🔒 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](https://github.com/twbs/icons) (MIT license) in the slides. A few icons from [SVG Repo](https://www.svgrepo.com/)
-(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](https://ollama.com/download) on the system and the desired [LLM](https://ollama.com/search) pulled locally. You should choose a model to use based on your hardware capacity. However, if you have no GPU, [gemma3:1b](https://ollama.com/library/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:
-
-```bash
-# 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. 
+SlideDeck AI uses [Mistral 7B Instruct](https://huggingface.co/mistralai/Mistral-7B-Instruct-v0.1) 
+via the Hugging Face Inference API.
+To run this project by yourself, you need to provide the `HUGGINGFACEHUB_API_TOKEN` and `METAPHOR_API_KEY` API keys,
+for example, in a `.env` file. Visit the respective websites to obtain the keys.
 
 
 # Live Demo
 
-Experience the power now!
-
-- 🚀 Live App: [Try SlideDeck AI on Hugging Face Spaces](https://huggingface.co/spaces/barunsaha/slide-deck-ai)
-- 🎥 Quick Demo: [Watch the core chat interface in action (YouTube)](https://youtu.be/QvAKzNKtk9k)
-- 🤝 Enterprise Showcase: [See a demonstration using Azure OpenAI (YouTube)](https://youtu.be/oPbH-z3q0Mw)
-
-
-# 🏆 Recognized Excellence
-
-SlideDeck AI has won the 3rd Place in the [Llama 2 Hackathon with Clarifai](https://lablab.ai/event/llama-2-hackathon-with-clarifai) in 2023.
-
-
-# Contributors
+[SlideDeck AI](https://huggingface.co/spaces/barunsaha/slide-deck-ai)
 
-SlideDeck AI is glad to have the following community contributions:
-- [Aditya](https://github.com/AdiBak): added support for page range selection for PDF files and new chat button.
-- [Sagar Bharatbhai Bharadia](https://github.com/sagarbharadia17): added support for Gemini 2.5 Flash Lite and Gemini 2.5 Flash LLMs.
-- [Sairam Pillai](https://github.com/sairampillai): unified the project's LLM access by migrating the API calls to **LiteLLM**.
-- [Srinivasan Ragothaman](https://github.com/rsrini7): added OpenRouter support and API keys mapping from the `.env` file.
 
-Thank you all for your contributions!
+# Award
 
-[![All Contributors](https://img.shields.io/badge/all_contributors-4-orange.svg?style=flat-square)](#contributors)
+SlideDeck AI has won the 3rd Place in the [Llama 2 Hackathon with Clarifai](https://lablab.ai/event/llama-2-hackathon-with-clarifai).

app.py

@@ -1,540 +1,319 @@
-"""
-Streamlit app containing the UI and the application logic.
-"""
-import datetime
-import logging
-import os
 import pathlib
-import random
-import sys
+import logging
+import tempfile
+from typing import List, Tuple
 
-import httpx
 import json5
-import ollama
-import requests
+import metaphor_python as metaphor
 import streamlit as st
-from dotenv import load_dotenv
 
-sys.path.insert(0, os.path.abspath('src'))
-from slidedeckai.core import SlideDeckAI
-from slidedeckai import global_config as gcfg
-from slidedeckai.global_config import GlobalConfig
-from slidedeckai.helpers import llm_helper, text_helper
-import slidedeckai.helpers.file_manager as filem
-from slidedeckai.helpers.chat_helper import ChatMessage, HumanMessage, AIMessage
-from slidedeckai.helpers import chat_helper
+import llm_helper
+import pptx_helper
+from global_config import GlobalConfig
 
 
-load_dotenv()
-logger = logging.getLogger(__name__)
+APP_TEXT = json5.loads(open(GlobalConfig.APP_STRINGS_FILE, 'r', encoding='utf-8').read())
+GB_CONVERTER = 2 ** 30
 
 
-RUN_IN_OFFLINE_MODE = os.getenv('RUN_IN_OFFLINE_MODE', 'False').lower() == 'true'
+logging.basicConfig(
+    level=GlobalConfig.LOG_LEVEL,
+    format='%(asctime)s - %(message)s',
+)
 
-# Session variables
-SLIDE_GENERATOR = 'slide_generator_instance'
-CHAT_MESSAGES = 'chat_messages'
-DOWNLOAD_FILE_KEY = 'download_file_name'
-IS_IT_REFINEMENT = 'is_it_refinement'
-ADDITIONAL_INFO = 'additional_info'
-PDF_FILE_KEY = 'pdf_file'
-API_INPUT_KEY = 'api_key_input'
 
-TEXTS = list(GlobalConfig.PPTX_TEMPLATE_FILES.keys())
-CAPTIONS = [GlobalConfig.PPTX_TEMPLATE_FILES[x]['caption'] for x in TEXTS]
+@st.cache_data
+def get_contents_wrapper(text: str) -> str:
+    """
+    Fetch and cache the slide deck contents on a topic by calling an external API.
 
+    :param text: The presentation topic
+    :return: The slide deck contents or outline in JSON format
+    """
 
-class StreamlitChatMessageHistory:
-    """Chat message history stored in Streamlit session state."""
+    logging.info('LLM call because of cache miss...')
+    return llm_helper.generate_slides_content(text).strip()
 
-    def __init__(self, key: str):
-        """Initialize the chat message history."""
-        self.key = key
-        if key not in st.session_state:
-            st.session_state[key] = []
 
-    @property
-    def messages(self):
-        """Get all chat messages in the history."""
-        return st.session_state[self.key]
+@st.cache_resource
+def get_metaphor_client_wrapper() -> metaphor.Metaphor:
+    """
+    Create a Metaphor client for semantic Web search.
 
-    def add_user_message(self, content: str):
-        """Add a user message to the history."""
-        st.session_state[self.key].append(HumanMessage(content))
+    :return: Metaphor instance
+    """
 
-    def add_ai_message(self, content: str):
-        """Add an AI message to the history."""
-        st.session_state[self.key].append(AIMessage(content))
+    return metaphor.Metaphor(api_key=GlobalConfig.METAPHOR_API_KEY)
 
 
 @st.cache_data
-def _load_strings() -> dict:
+def get_web_search_results_wrapper(text: str) -> List[Tuple[str, str]]:
     """
-    Load various strings to be displayed in the app.
+    Fetch and cache the Web search results on a given topic.
 
-    Returns:
-        The dictionary of strings.
+    :param text: The topic
+    :return: A list of (title, link) tuples
     """
-    with open(GlobalConfig.APP_STRINGS_FILE, 'r', encoding='utf-8') as in_file:
-        return json5.loads(in_file.read())
 
+    results = []
+    search_results = get_metaphor_client_wrapper().search(
+        text,
+        use_autoprompt=True,
+        num_results=5
+    )
 
-@st.cache_data
-def _get_prompt_template(is_refinement: bool) -> str:
-    """
-    Return a prompt template.
+    for a_result in search_results.results:
+        results.append((a_result.title, a_result.url))
+
+    return results
+
+
+# def get_disk_used_percentage() -> float:
+#     """
+#     Compute the disk usage.
+#
+#     :return: Percentage of the disk space currently used
+#     """
+#
+#     total, used, free = shutil.disk_usage(__file__)
+#     total = total // GB_CONVERTER
+#     used = used // GB_CONVERTER
+#     free = free // GB_CONVERTER
+#     used_perc = 100.0 * used / total
+#
+#     logging.debug(f'Total: {total} GB\n'
+#                   f'Used: {used} GB\n'
+#                   f'Free: {free} GB')
+#
+#     logging.debug('\n'.join(os.listdir()))
+#
+#     return used_perc
 
-    Args:
-        is_refinement: Whether this is the initial or refinement prompt.
 
-    Returns:
-        The prompt template as f-string.
+def build_ui():
+    """
+    Display the input elements for content generation. Only covers the first step.
     """
-    if is_refinement:
-        with open(GlobalConfig.REFINEMENT_PROMPT_TEMPLATE, 'r', encoding='utf-8') as in_file:
-            template = in_file.read()
-    else:
-        with open(GlobalConfig.INITIAL_PROMPT_TEMPLATE, 'r', encoding='utf-8') as in_file:
-            template = in_file.read()
 
-    return template
+    # get_disk_used_percentage()
 
+    st.title(APP_TEXT['app_name'])
+    st.subheader(APP_TEXT['caption'])
+    st.markdown(
+        'Powered by'
+        ' [Mistral-7B-Instruct-v0.2](https://huggingface.co/mistralai/Mistral-7B-Instruct-v0.2).'
+    )
+    st.markdown(
+        '*If the JSON is generated or parsed incorrectly, try again later by making minor changes'
+        ' to the input text.*'
+    )
 
-def are_all_inputs_valid(
-        user_prompt: str,
-        provider: str,
-        selected_model: str,
-        user_key: str,
-        azure_deployment_url: str = '',
-        azure_endpoint_name: str = '',
-        azure_api_version: str = '',
-) -> bool:
-    """
-    Validate user input and LLM selection.
-
-    Args:
-        user_prompt: The prompt.
-        provider: The LLM provider.
-        selected_model: Name of the model.
-        user_key: User-provided API key.
-        azure_deployment_url: Azure OpenAI deployment URL.
-        azure_endpoint_name: Azure OpenAI model endpoint.
-        azure_api_version: Azure OpenAI API version.
-
-    Returns:
-        `True` if all inputs "look" OK; `False` otherwise.
-    """
-    if not text_helper.is_valid_prompt(user_prompt):
-        handle_error(
-            'Not enough information provided!'
-            ' Please be a little more descriptive and type a few words'
-            ' with a few characters :)',
-            False
-        )
-        return False
-
-    if not provider or not selected_model:
-        handle_error('No valid LLM provider and/or model name found!', False)
-        return False
-
-    if not llm_helper.is_valid_llm_provider_model(
-            provider, selected_model, user_key,
-            azure_endpoint_name, azure_deployment_url, azure_api_version
-    ):
-        handle_error(
-            'The LLM settings do not look correct. Make sure that an API key/access token'
-            ' is provided if the selected LLM requires it. An API key should be 6-200 characters'
-            ' long, only containing alphanumeric characters, hyphens, and underscores.\n\n'
-            'If you are using Azure OpenAI, make sure that you have provided the additional and'
-            ' correct configurations.',
-            False
+    with st.form('my_form'):
+        # Topic input
+        try:
+            with open(GlobalConfig.PRELOAD_DATA_FILE, 'r', encoding='utf-8') as in_file:
+                preload_data = json5.loads(in_file.read())
+        except (FileExistsError, FileNotFoundError):
+            preload_data = {'topic': '', 'audience': ''}
+
+        topic = st.text_area(
+            APP_TEXT['input_labels'][0],
+            value=preload_data['topic']
         )
-        return False
 
-    return True
+        texts = list(GlobalConfig.PPTX_TEMPLATE_FILES.keys())
+        captions = [GlobalConfig.PPTX_TEMPLATE_FILES[x]['caption'] for x in texts]
 
+        pptx_template = st.radio(
+            'Select a presentation template:',
+            texts,
+            captions=captions,
+            horizontal=True
+        )
 
-def handle_error(error_msg: str, should_log: bool):
-    """
-    Display an error message in the app.
+        st.divider()
+        submit = st.form_submit_button('Generate slide deck')
 
-    Args:
-        error_msg: The error message to be displayed.
-        should_log: If `True`, log the message.
-    """
-    if should_log:
-        logger.error(error_msg)
+    if submit:
+        # st.write(f'Clicked {time.time()}')
+        st.session_state.submitted = True
 
-    st.error(error_msg)
+    # https://github.com/streamlit/streamlit/issues/3832#issuecomment-1138994421
+    if 'submitted' in st.session_state:
+        progress_text = 'Generating the slides...give it a moment'
+        progress_bar = st.progress(0, text=progress_text)
 
+        topic_txt = topic.strip()
+        generate_presentation(topic_txt, pptx_template, progress_bar)
 
-def reset_api_key():
-    """
-    Clear API key input when a different LLM is selected from the dropdown list.
-    """
-    st.session_state.api_key_input = ''
+    st.divider()
+    st.text(APP_TEXT['tos'])
+    st.text(APP_TEXT['tos2'])
 
+    st.markdown(
+        '![Visitors]'
+        '(https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fhuggingface.co%2Fspaces%2Fbarunsaha%2Fslide-deck-ai&countColor=%23263759)'
+    )
 
-def reset_chat_history():
+
+def generate_presentation(topic: str, pptx_template: str, progress_bar):
     """
-    Clear the chat history and related session state variables.
+    Process the inputs to generate the slides.
+
+    :param topic: The presentation topic based on which contents are to be generated
+    :param pptx_template: The PowerPoint template name to be used
+    :param progress_bar: Progress bar from the page
+    :return:
     """
-    # Clear session state variables using pop with None default
-    st.session_state.pop(SLIDE_GENERATOR, None)
-    st.session_state.pop(CHAT_MESSAGES, None)
-    st.session_state.pop(IS_IT_REFINEMENT, None)
-    st.session_state.pop(ADDITIONAL_INFO, None)
-    st.session_state.pop(PDF_FILE_KEY, None)
-    
-    # Remove previously generated temp PPTX file
-    temp_pptx_path = st.session_state.pop(DOWNLOAD_FILE_KEY, None)
-    if temp_pptx_path:
-        pptx_path = pathlib.Path(temp_pptx_path)
-        if pptx_path.exists() and pptx_path.is_file():
-            pptx_path.unlink()
-
-
-APP_TEXT = _load_strings()
-
-
-# -----= UI display begins here =-----
-
-
-with st.sidebar:
-    # New Chat button at the top of sidebar
-    col1, col2, col3 = st.columns([.17, 0.8, .1])
-    with col2:
-        if st.button('New Chat 💬', help='Start a new conversation', key='new_chat_button'):
-            reset_chat_history()  # Reset the chat history when the button is clicked
-    
-    # The PPT templates
-    pptx_template = st.sidebar.radio(
-        '1: Select a presentation template:',
-        TEXTS,
-        captions=CAPTIONS,
-        horizontal=True
-    )
 
-    if RUN_IN_OFFLINE_MODE:
-        llm_provider_to_use = st.text_input(
-            label='2: Enter Ollama model name to use (e.g., gemma3:1b):',
-            help=(
-                'Specify a correct, locally available LLM, found by running `ollama list`, for'
-                ' example, `gemma3:1b`, `mistral:v0.2`, and `mistral-nemo:latest`. Having an'
-                ' Ollama-compatible and supported GPU is strongly recommended.'
-            )
-        )
-        # If a SlideDeckAI instance already exists in session state, update its model
-        # to reflect the user change rather than reusing the old model
-        # No API key required for local models
-        if SLIDE_GENERATOR in st.session_state and llm_provider_to_use:
-            try:
-                st.session_state[SLIDE_GENERATOR].set_model(llm_provider_to_use)
-            except Exception as e:
-                logger.error('Failed to update model on existing SlideDeckAI: %s', e)
-                # If updating fails, drop the stored instance so a new one is created
-                st.session_state.pop(SLIDE_GENERATOR, None)
-
-        api_key_token: str = ''
-        azure_endpoint: str = ''
-        azure_deployment: str = ''
-        api_version: str = ''
-    else:
-        # The online LLMs
-        llm_provider_to_use = st.sidebar.selectbox(
-            label='2: Select a suitable LLM to use:\n\n(Gemini and Mistral-Nemo are recommended)',
-            options=[f'{k} ({v["description"]})' for k, v in GlobalConfig.VALID_MODELS.items()],
-            index=GlobalConfig.DEFAULT_MODEL_INDEX,
-            help=GlobalConfig.LLM_PROVIDER_HELP,
-            on_change=reset_api_key
-        ).split(' ')[0]
-        
-        # --- Automatically fetch API key from .env if available ---
-        # Extract provider key using regex
-        provider_match = GlobalConfig.PROVIDER_REGEX.match(llm_provider_to_use)
-        if provider_match:
-            selected_provider = provider_match.group(1)
-        else:
-            # If regex doesn't match, try to extract provider from the beginning
-            selected_provider = (
-                llm_provider_to_use.split(' ')[0]
-                if ' ' in llm_provider_to_use else llm_provider_to_use
-            )
-            logger.warning(
-                'Provider regex did not match for: %s, using: %s',
-                llm_provider_to_use, selected_provider
-            )
-        
-        # Validate that the selected provider is valid
-        if selected_provider not in GlobalConfig.VALID_PROVIDERS:
-            logger.error('Invalid provider: %s', selected_provider)
-            handle_error(f'Invalid provider selected: {selected_provider}', True)
-            st.stop()
-        
-        env_key_name = GlobalConfig.PROVIDER_ENV_KEYS.get(selected_provider)
-        default_api_key = os.getenv(env_key_name, '') if env_key_name else ''
-
-        # Always sync session state to env value if needed (autofill on provider change)
-        if default_api_key and st.session_state.get(API_INPUT_KEY, None) != default_api_key:
-            st.session_state[API_INPUT_KEY] = default_api_key
-
-        api_key_token = st.text_input(
-            label=(
-                '3: Paste your API key/access token:\n\n'
-                '*Mandatory* for all providers.'
-            ),
-            key=API_INPUT_KEY,
-            type='password',
-            disabled=bool(default_api_key),
-        )
+    topic_length = len(topic)
+    logging.debug('Input length:: topic: %s', topic_length)
 
-        # If a model was updated in the sidebar, make sure to update it in the SlideDeckAI instance
-        if SLIDE_GENERATOR in st.session_state and llm_provider_to_use:
-            try:
-                st.session_state[SLIDE_GENERATOR].set_model(llm_provider_to_use, api_key_token)
-            except Exception as e:
-                logger.error('Failed to update model on existing SlideDeckAI: %s', e)
-                # If updating fails, drop the stored instance so a new one is created
-                st.session_state.pop(SLIDE_GENERATOR, None)
-
-        # Additional configs for Azure OpenAI
-        with st.expander('**Azure OpenAI-specific configurations**'):
-            azure_endpoint = st.text_input(
-                label=(
-                    '4: Azure endpoint URL, e.g., https://example.openai.azure.com/.\n\n'
-                    '*Mandatory* for Azure OpenAI (only).'
+    if topic_length >= 10:
+        logging.debug('Topic: %s', topic)
+        target_length = min(topic_length, GlobalConfig.LLM_MODEL_MAX_INPUT_LENGTH)
+
+        try:
+            # Step 1: Generate the contents in JSON format using an LLM
+            json_str = process_slides_contents(topic[:target_length], progress_bar)
+            logging.debug('Truncated topic: %s', topic[:target_length])
+            logging.debug('Length of JSON: %d', len(json_str))
+
+            # Step 2: Generate the slide deck based on the template specified
+            if len(json_str) > 0:
+                st.info(
+                    'Tip: The generated content doesn\'t look so great?'
+                    ' Need alternatives? Just change your description text and try again.',
+                    icon="💡️"
                 )
-            )
-            azure_deployment = st.text_input(
-                label=(
-                    '5: Deployment name on Azure OpenAI:\n\n'
-                    '*Mandatory* for Azure OpenAI (only).'
-                ),
-            )
-            api_version = st.text_input(
-                label=(
-                    '6: API version:\n\n'
-                    '*Mandatory* field. Change based on your deployment configurations.'
-                ),
-                value='2024-05-01-preview',
-            )
-
-    # Make slider with initial values
-    page_range_slider = st.slider(
-        'Specify a page range for the uploaded PDF file (if any):',
-        1, GlobalConfig.MAX_ALLOWED_PAGES,
-        [1, GlobalConfig.MAX_ALLOWED_PAGES]
-    )
-    st.session_state['page_range_slider'] = page_range_slider
+            else:
+                st.error(
+                    'Unfortunately, JSON generation failed, so the next steps would lead'
+                    ' to nowhere. Try again or come back later.'
+                )
+                return
 
+            all_headers = generate_slide_deck(json_str, pptx_template, progress_bar)
 
-def build_ui():
+            # Step 3: Bonus stuff: Web references and AI art
+            show_bonus_stuff(all_headers)
+
+        except ValueError as ve:
+            st.error(f'Unfortunately, an error occurred: {ve}! '
+                     f'Please change the text, try again later, or report it, sharing your inputs.')
+
+    else:
+        st.error('Not enough information provided! Please be little more descriptive :)')
+
+
+def process_slides_contents(text: str, progress_bar: st.progress) -> str:
     """
-    Display the input elements for content generation.
+    Convert given text into structured data and display. Update the UI.
+
+    :param text: The topic description for the presentation
+    :param progress_bar: Progress bar for this step
+    :return: The contents as a JSON-formatted string
     """
-    st.title(APP_TEXT['app_name'])
-    st.subheader(APP_TEXT['caption'])
-    st.markdown(
-        '![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fhuggingface.co%2Fspaces%2Fbarunsaha%2Fslide-deck-ai&countColor=%23263759)'  # noqa: E501
-    )
 
-    today = datetime.date.today()
-    if today.month == 1 and 1 <= today.day <= 15:
-        st.success(
-            (
-                'Wishing you a happy and successful New Year!'
-                ' It is your appreciation that keeps SlideDeck AI going.'
-                f' May you make some great slide decks in {today.year} ✨'
-            ),
-            icon='🎆'
+    json_str = ''
+
+    try:
+        logging.info('Calling LLM for content generation on the topic: %s', text)
+        json_str = get_contents_wrapper(text)
+    except Exception as ex:
+        st.error(
+            f'An exception occurred while trying to convert to JSON. It could be because of heavy'
+            f' traffic or something else. Try doing it again or try again later.'
+            f'\nError message: {ex}'
         )
 
-    with st.expander('Usage Policies and Limitations'):
-        st.text(APP_TEXT['tos'] + '\n\n' + APP_TEXT['tos2'])
+    progress_bar.progress(50, text='Contents generated')
 
-    set_up_chat_ui()
+    with st.expander('The generated contents (in JSON format)'):
+        st.code(json_str, language='json')
 
+    return json_str
 
-def set_up_chat_ui():
-    """
-    Prepare the chat interface and related functionality.
+
+def generate_slide_deck(json_str: str, pptx_template: str, progress_bar) -> List:
     """
-    # Set start and end page
-    st.session_state['start_page'] = st.session_state['page_range_slider'][0]
-    st.session_state['end_page'] = st.session_state['page_range_slider'][1]
+    Create a slide deck.
 
-    with st.expander('Usage Instructions'):
-        st.markdown(GlobalConfig.CHAT_USAGE_INSTRUCTIONS)
+    :param json_str: The contents in JSON format
+    :param pptx_template: The PPTX template name
+    :param progress_bar: Progress bar
+    :return: A list of all slide headers and the title
+    """
 
-    st.info(APP_TEXT['like_feedback'])
-    st.chat_message('ai').write(random.choice(APP_TEXT['ai_greetings']))
+    progress_text = 'Creating the slide deck...give it a moment'
+    progress_bar.progress(75, text=progress_text)
 
-    history = StreamlitChatMessageHistory(key=CHAT_MESSAGES)
+    # # Get a unique name for the file to save -- use the session ID
+    # ctx = st_sr.get_script_run_ctx()
+    # session_id = ctx.session_id
+    # timestamp = time.time()
+    # output_file_name = f'{session_id}_{timestamp}.pptx'
 
-    # Since Streamlit app reloads at every interaction, display the chat history
-    # from the save session state
-    for msg in history.messages:
-        st.chat_message(msg.type).code(msg.content, language='json')
+    temp = tempfile.NamedTemporaryFile(delete=False, suffix='.pptx')
+    path = pathlib.Path(temp.name)
 
-    # Chat input at the bottom
-    prompt = st.chat_input(
-        placeholder=APP_TEXT['chat_placeholder'],
-        max_chars=GlobalConfig.LLM_MODEL_MAX_INPUT_LENGTH,
-        accept_file=True,
-        file_type=['pdf', ],
+    logging.info('Creating PPTX file...')
+    all_headers = pptx_helper.generate_powerpoint_presentation(
+        json_str,
+        as_yaml=False,
+        slides_template=pptx_template,
+        output_file_path=path
     )
+    progress_bar.progress(100, text='Done!')
 
-    if prompt:
-        prompt_text = prompt.text or ''
-        if prompt['files']:
-            # Store uploaded pdf in session state
-            uploaded_pdf = prompt['files'][0]
-            st.session_state[PDF_FILE_KEY] = uploaded_pdf
-            # Apparently, Streamlit stores uploaded files in memory and clears on browser close
-            # https://docs.streamlit.io/knowledge-base/using-streamlit/where-file-uploader-store-when-deleted
-
-        # Check if pdf file is uploaded
-        # (we can use the same file if the user doesn't upload a new one)
-        if PDF_FILE_KEY in st.session_state:
-            # Get validated page range
-            (
-                st.session_state['start_page'],
-                st.session_state['end_page']
-            ) = filem.validate_page_range(
-                st.session_state[PDF_FILE_KEY],
-                st.session_state['start_page'],
-                st.session_state['end_page']
-            )
-            # Show sidebar text for page selection and file name
-            with st.sidebar:
-                if st.session_state['end_page'] is None:  # If the PDF has only one page
-                    st.text(
-                        f'Extracting page {st.session_state["start_page"]} in'
-                        f' {st.session_state["pdf_file"].name}'
-                    )
-                else:
-                    st.text(
-                        f'Extracting pages {st.session_state["start_page"]} to'
-                        f' {st.session_state["end_page"]} in {st.session_state["pdf_file"].name}'
-                    )
-
-        st.chat_message('user').write(prompt_text)
-
-        if SLIDE_GENERATOR in st.session_state:
-            slide_generator = st.session_state[SLIDE_GENERATOR]
-        else:
-            slide_generator = SlideDeckAI(
-                model=llm_provider_to_use,
-                topic=prompt_text,
-                api_key=api_key_token.strip(),
-                template_idx=list(GlobalConfig.PPTX_TEMPLATE_FILES.keys()).index(pptx_template),
-                pdf_path_or_stream=st.session_state.get(PDF_FILE_KEY),
-                pdf_page_range=(
-                    st.session_state.get('start_page'), st.session_state.get('end_page')
-                ),
-            )
-            st.session_state[SLIDE_GENERATOR] = slide_generator
-
-        progress_bar = st.progress(0, 'Preparing to call LLM...')
-
-        def progress_callback(current_progress):
-            progress_bar.progress(
-                min(current_progress / gcfg.get_max_output_tokens(llm_provider_to_use), 0.95),
-                text='Streaming content...this might take a while...'
-            )
+    with open(path, 'rb') as f:
+        st.download_button('Download PPTX file', f, file_name='Presentation.pptx')
 
-        try:
-            if _is_it_refinement():
-                path = slide_generator.revise(
-                    instructions=prompt_text, progress_callback=progress_callback
-                )
-            else:
-                path = slide_generator.generate(progress_callback=progress_callback)
+    return all_headers
 
-            progress_bar.progress(1.0, text='Done!')
-
-            if path:
-                st.session_state[DOWNLOAD_FILE_KEY] = str(path)
-                history.add_user_message(prompt_text)
-                history.add_ai_message(slide_generator.last_response)
-                st.chat_message('ai').code(slide_generator.last_response, language='json')
-                _display_download_button(path)
-            else:
-                handle_error('Failed to generate slide deck.', True)
-
-        except (httpx.ConnectError, requests.exceptions.ConnectionError):
-            handle_error(
-                'A connection error occurred while streaming content from the LLM endpoint.'
-                ' Unfortunately, the slide deck cannot be generated. Please try again later.'
-                ' Alternatively, try selecting a different LLM from the dropdown list. If you are'
-                ' using Ollama, make sure that Ollama is already running on your system.',
-                True
-            )
-        except ollama.ResponseError:
-            handle_error(
-                'The model is unavailable with Ollama on your system.'
-                ' Make sure that you have provided the correct LLM name or pull it.'
-                ' View LLMs available locally by running `ollama list`.',
-                True
-            )
-        except Exception as ex:
-            if 'litellm.AuthenticationError' in str(ex):
-                handle_error(
-                    f'LLM API authentication failed: {ex}'
-                    '\nMake sure that you have provided a valid, correct API key.'
-                    ' Read **[how to get free LLM API keys](https://github.com/barun-saha/slide-deck-ai?tab=readme-ov-file#unmatched-flexibility-choose-your-ai-brain)**.',
-                    True
-                )
-            else:
-                handle_error('An unexpected error occurred: ' + str(ex), True)
 
-
-def _is_it_refinement() -> bool:
+def show_bonus_stuff(ppt_headers: List[str]):
     """
-    Whether it is the initial prompt or a refinement.
+    Show bonus stuff for the presentation.
 
-    Returns:
-        True if it is the initial prompt; False otherwise.
+    :param ppt_headers: A list of the slide headings.
     """
-    if IS_IT_REFINEMENT in st.session_state:
-        return True
 
-    if len(st.session_state[CHAT_MESSAGES]) >= 2:
-        # Prepare for the next call
-        st.session_state[IS_IT_REFINEMENT] = True
-        return True
+    # Use the presentation title and the slide headers to find relevant info online
+    logging.info('Calling Metaphor search...')
+    ppt_text = ' '.join(ppt_headers)
+    search_results = get_web_search_results_wrapper(ppt_text)
+    md_text_items = []
 
-    return False
+    for (title, link) in search_results:
+        md_text_items.append(f'[{title}]({link})')
 
+    with st.expander('Related Web references'):
+        st.markdown('\n\n'.join(md_text_items))
 
-def _get_user_messages() -> list[str]:
-    """
-    Get a list of user messages submitted until now from the session state.
+    logging.info('Done!')
 
-    Returns:
-        The list of user messages.
-    """
-    return [
-        msg.content for msg in st.session_state[CHAT_MESSAGES]
-        if isinstance(msg, chat_helper.HumanMessage)
-    ]
+    # # Avoid image generation. It costs time and an API call, so just limit to the text generation.
+    # with st.expander('AI-generated image on the presentation topic'):
+    #     logging.info('Calling SDXL for image generation...')
+    #     # img_empty.write('')
+    #     # img_text.write(APP_TEXT['image_info'])
+    #     image = get_ai_image_wrapper(ppt_text)
+    #
+    #     if len(image) > 0:
+    #         image = base64.b64decode(image)
+    #         st.image(image, caption=ppt_text)
+    #         st.info('Tip: Right-click on the image to save it.', icon="💡️")
+    #         logging.info('Image added')
 
 
-def _display_download_button(file_path: pathlib.Path):
+def main():
     """
-    Display a download button to download a slide deck.
-
-    Args:
-        file_path: The path of the .pptx file.
+    Trigger application run.
     """
-    with open(file_path, 'rb') as download_file:
-        st.download_button(
-            'Download PPTX file ⬇️',
-            data=download_file,
-            file_name='Presentation.pptx',
-            key=datetime.datetime.now()
-        )
+
+    build_ui()
 
 
 if __name__ == '__main__':
-    build_ui()
+    main()

clarifai_grpc_helper.py

@@ -0,0 +1,71 @@
+from clarifai_grpc.channel.clarifai_channel import ClarifaiChannel
+from clarifai_grpc.grpc.api import resources_pb2, service_pb2, service_pb2_grpc
+from clarifai_grpc.grpc.api.status import status_code_pb2
+
+from global_config import GlobalConfig
+
+
+CHANNEL = ClarifaiChannel.get_grpc_channel()
+STUB = service_pb2_grpc.V2Stub(CHANNEL)
+
+METADATA = (
+    ('authorization', 'Key ' + GlobalConfig.CLARIFAI_PAT),
+)
+
+USER_DATA_OBJECT = resources_pb2.UserAppIDSet(
+    user_id=GlobalConfig.CLARIFAI_USER_ID,
+    app_id=GlobalConfig.CLARIFAI_APP_ID
+)
+
+RAW_TEXT = '''You are a helpful, intelligent chatbot. Create the slides for a presentation on the given topic. Include main headings for each slide, detailed bullet points for each slide. Add relevant content to each slide. Do not output any blank line.
+
+Topic:
+Talk about AI, covering what it is and how it works. Add its pros, cons, and future prospects. Also, cover its job prospects.
+'''
+
+
+def get_text_from_llm(prompt: str) -> str:
+    post_model_outputs_response = STUB.PostModelOutputs(
+        service_pb2.PostModelOutputsRequest(
+            user_app_id=USER_DATA_OBJECT,  # The userDataObject is created in the overview and is required when using a PAT
+            model_id=GlobalConfig.CLARIFAI_MODEL_ID,
+            # version_id=MODEL_VERSION_ID,  # This is optional. Defaults to the latest model version
+            inputs=[
+                resources_pb2.Input(
+                    data=resources_pb2.Data(
+                        text=resources_pb2.Text(
+                            raw=prompt
+                        )
+                    )
+                )
+            ]
+        ),
+        metadata=METADATA
+    )
+
+    if post_model_outputs_response.status.code != status_code_pb2.SUCCESS:
+        print(post_model_outputs_response.status)
+        raise Exception(f"Post model outputs failed, status: {post_model_outputs_response.status.description}")
+
+    # Since we have one input, one output will exist here
+    output = post_model_outputs_response.outputs[0]
+
+    # print("Completion:\n")
+    # print(output.data.text.raw)
+
+    return output.data.text.raw
+
+
+if __name__ == '__main__':
+    topic = ('Talk about AI, covering what it is and how it works.'
+             ' Add its pros, cons, and future prospects.'
+             ' Also, cover its job prospects.'
+             )
+    print(topic)
+
+    with open(GlobalConfig.SLIDES_TEMPLATE_FILE, 'r') as in_file:
+        prompt_txt = in_file.read()
+        prompt_txt = prompt_txt.replace('{topic}', topic)
+        response_txt = get_text_from_llm(prompt_txt)
+
+        print('Output:\n', response_txt)

docs/_templates/module.rst

@@ -1,25 +0,0 @@
-{{ fullname | escape | underline }}
-===================================
-
-.. currentmodule:: {{ module }}
-
-.. automodule:: {{ fullname }}
-   :noindex:
-
-.. autosummary::
-   :toctree:
-   :nosignatures:
-
-   {% for item in functions %}
-   {{ item }}
-   {% endfor %}
-
-   {% for item in classes %}
-   {{ item }}
-   {% endfor %}
-
-.. automodule:: {{ fullname }}
-   :members:
-   :undoc-members:
-   :show-inheritance:
-   :member-order: alphabetical

docs/api.rst

@@ -1,18 +0,0 @@
-API Reference
-=============
-
-.. autosummary::
-   :toctree: generated/
-   :template: module.rst
-   :nosignatures:
-   :caption: Core Modules and Classes
-
-   slidedeckai.cli
-   slidedeckai.core
-   slidedeckai.helpers.chat_helper
-   slidedeckai.helpers.file_manager
-   slidedeckai.helpers.icons_embeddings
-   slidedeckai.helpers.image_search
-   slidedeckai.helpers.llm_helper
-   slidedeckai.helpers.pptx_helper
-   slidedeckai.helpers.text_helper

docs/conf.py

@@ -1,50 +0,0 @@
-"""
-Sphinx configuration file for the SlideDeck AI documentation.
-This file sets up Sphinx to generate documentation from the source code
-located in the 'src' directory, and includes support for Markdown files
-using the MyST parser.
-"""
-import os
-import sys
-
-# --- Path setup ---
-# Crucial: This tells Sphinx to look in 'src' to find the 'slidedeckai' package.
-sys.path.insert(0, os.path.abspath('../src'))
-
-# --- Project information ---
-project = 'SlideDeck AI'
-copyright = '2025, Barun Saha'
-author = 'Barun Saha'
-
-# --- General configuration ---
-extensions = [
-    'sphinx.ext.autodoc',
-    'sphinx.ext.autosummary',
-    'sphinx.ext.napoleon',    # Converts Google/NumPy style docstrings
-    'sphinx.ext.viewcode',
-    'myst_parser',            # Enables Markdown support (.md files)
-]
-autosummary_generate = True
-
-# --- Autodoc configuration for sorting ---
-autodoc_member_order = 'alphabetical'
-
-# Tell Sphinx to look for custom templates
-templates_path = ['_templates']
-
-# Configure MyST to allow cross-referencing and nested structure
-myst_enable_extensions = [
-    'deflist',
-    'html_image',
-    'linkify',
-    'replacements',
-    'html_admonition'
-]
-source_suffix = {
-    '.rst': 'restructuredtext',
-    '.md': 'markdown',
-}
-
-html_theme = 'pydata_sphinx_theme'
-master_doc = 'index'
-html_show_sourcelink = True

docs/generated/slidedeckai.cli.CustomArgumentParser.rst

@@ -1,40 +0,0 @@
-slidedeckai.cli.CustomArgumentParser
-====================================
-
-.. currentmodule:: slidedeckai.cli
-
-.. autoclass:: CustomArgumentParser
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~CustomArgumentParser.__init__
-      ~CustomArgumentParser.add_argument
-      ~CustomArgumentParser.add_argument_group
-      ~CustomArgumentParser.add_mutually_exclusive_group
-      ~CustomArgumentParser.add_subparsers
-      ~CustomArgumentParser.convert_arg_line_to_args
-      ~CustomArgumentParser.error
-      ~CustomArgumentParser.exit
-      ~CustomArgumentParser.format_help
-      ~CustomArgumentParser.format_usage
-      ~CustomArgumentParser.get_default
-      ~CustomArgumentParser.parse_args
-      ~CustomArgumentParser.parse_intermixed_args
-      ~CustomArgumentParser.parse_known_args
-      ~CustomArgumentParser.parse_known_intermixed_args
-      ~CustomArgumentParser.print_help
-      ~CustomArgumentParser.print_usage
-      ~CustomArgumentParser.register
-      ~CustomArgumentParser.set_defaults
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.cli.CustomHelpFormatter.rst

@@ -1,29 +0,0 @@
-slidedeckai.cli.CustomHelpFormatter
-===================================
-
-.. currentmodule:: slidedeckai.cli
-
-.. autoclass:: CustomHelpFormatter
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~CustomHelpFormatter.__init__
-      ~CustomHelpFormatter.add_argument
-      ~CustomHelpFormatter.add_arguments
-      ~CustomHelpFormatter.add_text
-      ~CustomHelpFormatter.add_usage
-      ~CustomHelpFormatter.end_section
-      ~CustomHelpFormatter.format_help
-      ~CustomHelpFormatter.start_section
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.cli.format_model_help.rst

@@ -1,6 +0,0 @@
-slidedeckai.cli.format\_model\_help
-===================================
-
-.. currentmodule:: slidedeckai.cli
-
-.. autofunction:: format_model_help

docs/generated/slidedeckai.cli.format_models_as_bullets.rst

@@ -1,6 +0,0 @@
-slidedeckai.cli.format\_models\_as\_bullets
-===========================================
-
-.. currentmodule:: slidedeckai.cli
-
-.. autofunction:: format_models_as_bullets

docs/generated/slidedeckai.cli.format_models_list.rst

@@ -1,6 +0,0 @@
-slidedeckai.cli.format\_models\_list
-====================================
-
-.. currentmodule:: slidedeckai.cli
-
-.. autofunction:: format_models_list

docs/generated/slidedeckai.cli.group_models_by_provider.rst

@@ -1,6 +0,0 @@
-slidedeckai.cli.group\_models\_by\_provider
-===========================================
-
-.. currentmodule:: slidedeckai.cli
-
-.. autofunction:: group_models_by_provider

docs/generated/slidedeckai.cli.main.rst

@@ -1,6 +0,0 @@
-slidedeckai.cli.main
-====================
-
-.. currentmodule:: slidedeckai.cli
-
-.. autofunction:: main

docs/generated/slidedeckai.cli.rst

@@ -1,36 +0,0 @@
-slidedeckai.cli
-===============
-===================================
-
-.. currentmodule:: slidedeckai
-
-.. automodule:: slidedeckai.cli
-   :noindex:
-
-.. autosummary::
-   :toctree:
-   :nosignatures:
-
-   
-   format_model_help
-   
-   format_models_as_bullets
-   
-   format_models_list
-   
-   group_models_by_provider
-   
-   main
-   
-
-   
-   CustomArgumentParser
-   
-   CustomHelpFormatter
-   
-
-.. automodule:: slidedeckai.cli
-   :members:
-   :undoc-members:
-   :show-inheritance:
-   :member-order: alphabetical

docs/generated/slidedeckai.core.SlideDeckAI.rst

@@ -1,27 +0,0 @@
-slidedeckai.core.SlideDeckAI
-============================
-
-.. currentmodule:: slidedeckai.core
-
-.. autoclass:: SlideDeckAI
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~SlideDeckAI.__init__
-      ~SlideDeckAI.generate
-      ~SlideDeckAI.reset
-      ~SlideDeckAI.revise
-      ~SlideDeckAI.set_model
-      ~SlideDeckAI.set_template
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.core.rst

@@ -1,24 +0,0 @@
-slidedeckai.core
-================
-===================================
-
-.. currentmodule:: slidedeckai
-
-.. automodule:: slidedeckai.core
-   :noindex:
-
-.. autosummary::
-   :toctree:
-   :nosignatures:
-
-   
-
-   
-   SlideDeckAI
-   
-
-.. automodule:: slidedeckai.core
-   :members:
-   :undoc-members:
-   :show-inheritance:
-   :member-order: alphabetical

docs/generated/slidedeckai.helpers.chat_helper.AIMessage.rst

@@ -1,22 +0,0 @@
-slidedeckai.helpers.chat\_helper.AIMessage
-==========================================
-
-.. currentmodule:: slidedeckai.helpers.chat_helper
-
-.. autoclass:: AIMessage
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~AIMessage.__init__
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.helpers.chat_helper.ChatMessage.rst

@@ -1,22 +0,0 @@
-slidedeckai.helpers.chat\_helper.ChatMessage
-============================================
-
-.. currentmodule:: slidedeckai.helpers.chat_helper
-
-.. autoclass:: ChatMessage
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~ChatMessage.__init__
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.helpers.chat_helper.ChatMessageHistory.rst

@@ -1,24 +0,0 @@
-slidedeckai.helpers.chat\_helper.ChatMessageHistory
-===================================================
-
-.. currentmodule:: slidedeckai.helpers.chat_helper
-
-.. autoclass:: ChatMessageHistory
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~ChatMessageHistory.__init__
-      ~ChatMessageHistory.add_ai_message
-      ~ChatMessageHistory.add_user_message
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.helpers.chat_helper.ChatPromptTemplate.rst

@@ -1,24 +0,0 @@
-slidedeckai.helpers.chat\_helper.ChatPromptTemplate
-===================================================
-
-.. currentmodule:: slidedeckai.helpers.chat_helper
-
-.. autoclass:: ChatPromptTemplate
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~ChatPromptTemplate.__init__
-      ~ChatPromptTemplate.format
-      ~ChatPromptTemplate.from_template
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.helpers.chat_helper.HumanMessage.rst

@@ -1,22 +0,0 @@
-slidedeckai.helpers.chat\_helper.HumanMessage
-=============================================
-
-.. currentmodule:: slidedeckai.helpers.chat_helper
-
-.. autoclass:: HumanMessage
-
-   
-   .. automethod:: __init__
-
-   
-   .. rubric:: Methods
-
-   .. autosummary::
-   
-      ~HumanMessage.__init__
-   
-   
-
-   
-   
-   

docs/generated/slidedeckai.helpers.chat_helper.rst

@@ -1,32 +0,0 @@
-slidedeckai.helpers.chat\_helper
-================================
-===================================
-
-.. currentmodule:: slidedeckai.helpers
-
-.. automodule:: slidedeckai.helpers.chat_helper
-   :noindex:
-
-.. autosummary::
-   :toctree:
-   :nosignatures:
-
-   
-
-   
-   AIMessage
-   
-   ChatMessage
-   
-   ChatMessageHistory
-   
-   ChatPromptTemplate
-   
-   HumanMessage
-   
-
-.. automodule:: slidedeckai.helpers.chat_helper
-   :members:
-   :undoc-members:
-   :show-inheritance:
-   :member-order: alphabetical

docs/generated/slidedeckai.helpers.file_manager.get_pdf_contents.rst

@@ -1,6 +0,0 @@
-slidedeckai.helpers.file\_manager.get\_pdf\_contents
-====================================================
-
-.. currentmodule:: slidedeckai.helpers.file_manager
-
-.. autofunction:: get_pdf_contents

docs/generated/slidedeckai.helpers.file_manager.rst

@@ -1,26 +0,0 @@
-slidedeckai.helpers.file\_manager
-=================================
-===================================
-
-.. currentmodule:: slidedeckai.helpers
-
-.. automodule:: slidedeckai.helpers.file_manager
-   :noindex:
-
-.. autosummary::
-   :toctree:
-   :nosignatures:
-
-   
-   get_pdf_contents
-   
-   validate_page_range
-   
-
-   
-
-.. automodule:: slidedeckai.helpers.file_manager
-   :members:
-   :undoc-members:
-   :show-inheritance:
-   :member-order: alphabetical

docs/generated/slidedeckai.helpers.file_manager.validate_page_range.rst

@@ -1,6 +0,0 @@
-slidedeckai.helpers.file\_manager.validate\_page\_range
-=======================================================
-
-.. currentmodule:: slidedeckai.helpers.file_manager
-
-.. autofunction:: validate_page_range

docs/generated/slidedeckai.helpers.icons_embeddings.find_icons.rst

@@ -1,6 +0,0 @@
-slidedeckai.helpers.icons\_embeddings.find\_icons
-=================================================
-
-.. currentmodule:: slidedeckai.helpers.icons_embeddings
-
-.. autofunction:: find_icons

docs/generated/slidedeckai.helpers.icons_embeddings.get_embeddings.rst

@@ -1,6 +0,0 @@
-slidedeckai.helpers.icons\_embeddings.get\_embeddings
-=====================================================
-
-.. currentmodule:: slidedeckai.helpers.icons_embeddings
-
-.. autofunction:: get_embeddings

docs/generated/slidedeckai.helpers.icons_embeddings.get_icons_list.rst

@@ -1,6 +0,0 @@
-slidedeckai.helpers.icons\_embeddings.get\_icons\_list
-======================================================
-
-.. currentmodule:: slidedeckai.helpers.icons_embeddings
-
-.. autofunction:: get_icons_list

docs/generated/slidedeckai.helpers.icons_embeddings.load_saved_embeddings.rst

@@ -1,6 +0,0 @@
-slidedeckai.helpers.icons\_embeddings.load\_saved\_embeddings
-=============================================================
-
-.. currentmodule:: slidedeckai.helpers.icons_embeddings
-
-.. autofunction:: load_saved_embeddings

docs/generated/slidedeckai.helpers.icons_embeddings.main.rst

@@ -1,6 +0,0 @@
-slidedeckai.helpers.icons\_embeddings.main
-==========================================
-
-.. currentmodule:: slidedeckai.helpers.icons_embeddings
-
-.. autofunction:: main