# glitchmill/insoluble-py architecture

> Architecture diagram of the GitHub repository glitchmill/insoluble-py, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/glitchmill/insoluble-py
- Repository: https://github.com/glitchmill/insoluble-py

## Overview

##### Main Application Component
- That it uses Python’s Pillow (PIL) and NumPy libraries for image manipulation and effect applications.

##### Assets Component
- Split into subcomponents: “Background Images” and “Fonts.” This directory provides the visual resources needed for the final output.

##### Dependency & Build Tools
- “requirements.txt” to denote the external dependencies (Pillow, NumPy, etc.).
- A “Build Configuration” component which covers:
- The “insoluble.spec” file used with PyInstaller for compiling binaries.
- The GitHub Actions workflow (.github/workflows/release.yml) to illustrate the CI/CD process for releasing the compiled binary.

##### User Interface (CLI Layer)
- Command-line interface that accepts various arguments (title text, subtitles, effect options, etc.) and passes them to the main application.
- This component should be clearly connected to “Title Card Generator (app.py)” to indicate control and input flow.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "User Input Layer"
        CLI["CLI Interface"]:::cli
    end

    subgraph "Core Application"
        App["Title Card Generator (app.py)"]:::app
    end

    subgraph "Assets"
        Bg["Background Images"]:::asset
        Fn["Fonts"]:::asset
    end

    subgraph "Output"
        Out["Generated Title Card (PNG Output)"]:::output
    end

    subgraph "Dependencies & Build Tools"
        Req["requirements.txt"]:::dep
        Spec["insoluble.spec"]:::dep
        CI[".github/workflows/release.yml"]:::dep
    end

    subgraph "Documentation"
        Readme["README"]:::doc
        Demo["Video Demo"]:::doc
    end

    CLI -->|"inputs"| App
    App -->|"uses"| Bg
    App -->|"uses"| Fn
    App -->|"produces"| Out
    Req -->|"dependencies"| App
    Spec -->|"builds"| App
    CI -->|"deploys"| App
    Readme -.->|"supports"| CLI
    Demo -.->|"demo"| CLI

    click App "https://github.com/glitchmill/insoluble-py/blob/main/app.py"
    click CLI "https://github.com/glitchmill/insoluble-py/blob/main/app.py"
    click Bg "https://github.com/glitchmill/insoluble-py/tree/main/assets/background"
    click Fn "https://github.com/glitchmill/insoluble-py/tree/main/assets/fonts"
    click Req "https://github.com/glitchmill/insoluble-py/blob/main/requirements.txt"
    click Spec "https://github.com/glitchmill/insoluble-py/blob/main/insoluble.spec"
    click CI "https://github.com/glitchmill/insoluble-py/blob/main/.github/workflows/release.yml"
    click Readme "https://github.com/glitchmill/insoluble-py/blob/main/README.md"
    click Demo "https://github.com/glitchmill/insoluble-py/blob/main/assets/demo.mp4"

    classDef cli fill:#ffdead,stroke:#b8860b,stroke-width:2px,font-size:12px;
    classDef app fill:#add8e6,stroke:#0000ff,stroke-width:2px,font-size:12px;
    classDef asset fill:#90ee90,stroke:#006400,stroke-width:2px,font-size:12px;
    classDef output fill:#ffb6c1,stroke:#ff69b4,stroke-width:2px,font-size:12px;
    classDef dep fill:#d3d3d3,stroke:#696969,stroke-width:2px,font-size:12px;
    classDef doc fill:#ffd700,stroke:#daa520,stroke-width:2px,font-size:12px;
```
