Pylint & CVE fix

.codecov.yml

@@ -1,3 +0,0 @@
-ignore:
-  # Exclude the version file from all coverage calculations
-  - "src/slidedeckai/_version.py"

.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"]
-
-    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
-        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,191 +4,48 @@ emoji: 🏢
 colorFrom: yellow
 colorTo: green
 sdk: streamlit
-sdk_version: 1.44.1
+sdk_version: 1.26.0
 app_file: app.py
 pinned: false
 license: mit
 ---
 
-
-[![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)
-[![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)
-
 # SlideDeck AI
 
-We spend a lot of time **creating** slides and organizing our thoughts for any presentation. 
-With SlideDeck AI, co-create slide decks on any topic with **Artificial Intelligence** and **Large Language Models**.
-Describe your topic and let SlideDeck AI generate a **PowerPoint slide deck** for you—it's as simple as that!
-
+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!
 
-## Star History
+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.
 
-[![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)
-
-
-## Process
+# Process
 
 SlideDeck AI works in the following way:
 
-1. Given a topic description, it uses a Large Language Model (LLM) to generate the *initial* content of the slides. 
+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. Next, it uses the keywords from the JSON output to search and download a few images with a certain probability.
-3. Subsequently, it uses the `python-pptx` library to generate the slides, 
+2. Subsequently, it uses the `python-pptx` library to generate the slides, 
 based on the JSON data from the previous step. 
-A user can choose from a set of pre-defined presentation templates.
-4. At this stage onward, a user can provide additional instructions to *refine* the content.
-For example, one can ask to add another slide or modify an existing slide.
-A history of instructions is maintained.
-5. Every time SlideDeck AI generates a PowerPoint presentation, a download button is provided.
-Clicking on the button will download the file.
-
-In addition, SlideDeck AI can also create a presentation based on PDF files.
-
-
-## Python API Usage
-
-```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
-```
-
-
-## Summary of the LLMs
-
-SlideDeck AI allows the use of different LLMs from several online providers—Azure OpenAI, Google, Cohere, Together AI, and OpenRouter. Most of these service providers offer generous free usage of relevant LLMs without requiring any billing information.  
-
-Based on several experiments, SlideDeck AI generally recommends the use of **Mistral NeMo**, **Gemini Flash**, and **GPT-4o** to generate the 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**: SlideDeck AI does **NOT** store your API keys/tokens or transmit them elsewhere. If you provide your API key, it is only used to invoke the relevant LLM to generate contents. That's it! This is an 
-Open-Source project, so feel free to audit the code and convince yourself. 
+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.
 
-In addition, offline LLMs provided by Ollama can be used. Read below to know more. 
+4. ~~Finally, it uses Stable Diffusion 2 to generate an image, based on the title and each slide heading.~~
 
 
-## Icons
+# Local Development
 
-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).
-
-### Offline LLMs Using 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
 
-- [SlideDeck AI](https://huggingface.co/spaces/barunsaha/slide-deck-ai) on Hugging Face Spaces
-- [Demo video](https://youtu.be/QvAKzNKtk9k) of the chat interface on YouTube
-- Demo video on [using Azure OpenAI](https://youtu.be/oPbH-z3q0Mw)
+[SlideDeck AI](https://huggingface.co/spaces/barunsaha/slide-deck-ai)
 
 
 # Award
 
-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 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!
-
-[![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,554 +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)
-
-            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:
-            _msg = str(ex)
-            if 'payment required' in _msg.lower():
-                handle_error(
-                    'The available inference quota has exhausted.'
-                    ' Please use your own Hugging Face access token. Paste your token in'
-                    ' the input field on the sidebar to the left.'
-                    '\n\nDon\'t have a token? Get your free'
-                    ' [HF access token](https://huggingface.co/settings/tokens) now'
-                    ' and start creating your slide deck! For gated models, you may need to'
-                    ' visit the model\'s page and accept the terms or service.'
-                    '\n\nAlternatively, choose a different LLM and provider from the list.',
-                    should_log=True
-                )
-            else:
-                handle_error(
-                    f'An unexpected error occurred while generating the content: {_msg}'
-                    '\n\nPlease try again later, possibly with different inputs.'
-                    ' Alternatively, try selecting a different LLM from the dropdown list.'
-                    ' If you are using Azure OpenAI, Cohere, Gemini, or Together AI models, make'
-                    ' sure that you have provided a correct API key.'
-                    ' Read **[how to get free LLM API keys](https://github.com/barun-saha/slide-deck-ai?tab=readme-ov-file#summary-of-the-llms)**.',
-                    True
-                )
+    return all_headers
 
 
-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.cli
-
-.. 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,26 +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_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