# m1t8e6/llm-powerpoint architecture

> Architecture diagram of the GitHub repository m1t8e6/llm-powerpoint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/m1t8e6/llm-powerpoint
- Repository: https://github.com/m1t8e6/llm-powerpoint

## Overview

##### Project Type and Purpose
- This is a lightweight, open-source Python tool (delivered as a Jupyter notebook) for programmatically generating PowerPoint presentations by orchestrating:
- A Large Language Model (LLM) API (e.g. OpenAI)
- The python-pptx library
- Custom slide templates

##### File Structure Analysis
- Top level:
- `.env.example` + `config.py`: configuration of API keys and defaults
- `requirements.txt`: dependency list (openai, pptx, pandas, jupyter)
- `ppt-gen.ipynb`: the central orchestration notebook
- `templates/basic_template.pptx`: slide layout blueprint
- `powerpoints/output.pptx`: generated artifact
- No separate “frontend/backend”—it’s a single pipeline with clearly delineated stages.

##### README Insights
- Describes usage flow: clone → configure → run notebook → feed input → generate PPTX
- Highlights customization points: slide count, order, style via template and notebook cells
- Clarifies core components: LLM integration, slide template, generation logic

## Diagram (Mermaid)

```mermaid
graph TB
    %% Nodes
    Notebook["Jupyter Notebook\n(ppt-gen.ipynb)"]:::code
    subgraph "Configuration Module"
        Env[".env.example"]:::code
        Config["config.py"]:::code
    end
    Template["basic_template.pptx"]:::storage
    LLM["OpenAI API"]:::external
    PPTX["python-pptx Engine"]:::code
    FSDir["Directory: powerpoints/"]:::storage
    OutputFile["output.pptx"]:::storage

    %% Connections
    Notebook -->|"loads settings"| Env
    Notebook -->|"loads settings"| Config
    Notebook -->|"reads template"| Template
    Notebook -->|"prompt JSON"| LLM
    LLM -->|"structured content"| Notebook
    Notebook -->|"content + template"| PPTX
    PPTX -->|".pptx file"| FSDir
    FSDir -->|"writes file"| OutputFile

    %% Click Events
    click Notebook "https://github.com/m1t8e6/llm-powerpoint/blob/main/ppt-gen.ipynb"
    click Env "https://github.com/m1t8e6/llm-powerpoint/blob/main/.env.example"
    click Config "https://github.com/m1t8e6/llm-powerpoint/blob/main/config.py"
    click Template "https://github.com/m1t8e6/llm-powerpoint/blob/main/templates/basic_template.pptx"
    click FSDir "https://github.com/m1t8e6/llm-powerpoint/tree/main/powerpoints/"
    click OutputFile "https://github.com/m1t8e6/llm-powerpoint/blob/main/powerpoints/output.pptx"

    %% Styles
    classDef code fill:#DEEBFF,stroke:#0366d6,stroke-width:2px
    classDef external fill:#E6FFEB,stroke:#28a745,stroke-width:2px
    classDef storage fill:#FFF4E6,stroke:#d15704,stroke-width:2px
```
