# g-zak/ai_algo_visualizer architecture

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

- Interactive diagram: https://gitdiagram.com/g-zak/ai_algo_visualizer
- Repository: https://github.com/g-zak/ai_algo_visualizer

## Overview

##### Project type and purpose
- This is a Python-based desktop application (Tkinter + ttkthemes) for experimenting with and visualizing financial machine-learning algorithms.
- Purpose: provide an interactive GUI (“Finance Explorer”) that runs five core ML workflows (linear regression, random forest classification, k-means clustering, ARIMA forecasting, k-fold cross-validation) against financial data and displays charts.

##### File structure
- Top-level files:
- main.py – entry point, launches the UI
- algorithms.py – contains the code for each ML algorithm/tab
- requirements.txt – external Python dependencies
- No separate “data/” folder: data ingestion likely happens in algorithms.py or main.py.
- Packaging via PyInstaller (not a runtime component but part of build pipeline).

##### README for additional insights
- Confirms ML libraries: numpy, pandas, matplotlib, scikit-learn, statsmodels, Pillow.
- GUI framework: Tkinter + ttkthemes.
- Build: PyInstaller → single-file .exe or .app.

##### Detailed component breakdown
- UI Layer:
- Block: main.py
- Block: style.py
- Algorithm Engine:
- Five sub-blocks inside algorithms.py, each labeled with its algorithm
- Data & Visualization:
- Block: pandas/numpy (data feed)
- Block: matplotlib (plot)
- Optional block: Pillow for assets
- Packaging:
- Block: PyInstaller

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI Layer"
        UI_main["main.py"]:::module
        UI_style["style.py"]:::module
        Tkinter["Tkinter + ttkthemes"]:::framework
    end

    %% Algorithm Engine
    subgraph "Algorithm Engine"
        Algorithms["algorithms.py"]:::module
        LR["Linear Regression"]:::algorithm
        RF["Random Forest Classification"]:::algorithm
        KM["K-Means Clustering"]:::algorithm
        ARIMA["ARIMA Forecasting"]:::algorithm
        KF["K-Fold Cross-Validation"]:::algorithm
    end

    %% Data & Visualization
    subgraph "Data & Visualization"
        Data["pandas/numpy"]:::library
        Viz["matplotlib"]:::library
        Pillow["Pillow"]:::library
    end

    %% External Libraries
    sk["scikit-learn"]:::library
    sm["statsmodels"]:::library

    %% Resources & Packaging
    Assets["assets/"]:::resource
    Requirements["requirements.txt"]:::resource
    Packaging["PyInstaller"]:::framework

    %% Relationships
    UI_main -->|applies style| UI_style
    UI_main -->|renders via| Tkinter
    UI_main -->|triggers| Algorithms
    Algorithms -->|executes| LR
    Algorithms -->|executes| RF
    Algorithms -->|executes| KM
    Algorithms -->|executes| ARIMA
    Algorithms -->|executes| KF
    Algorithms -->|processes data| Data
    Data -->|plots| Viz
    Viz -->|displays in| UI_main
    Algorithms -->|uses| sk
    Algorithms -->|uses| sm
    UI_main -->|loads assets| Assets
    Assets -->|handled by| Pillow
    Requirements -->|defines deps| Packaging
    UI_main -->|packaged by| Packaging
    UI_style -->|packaged by| Packaging
    Algorithms -->|packaged by| Packaging
    Assets -->|packaged by| Packaging

    %% Click events
    click UI_main "https://github.com/g-zak/ai_algo_visualizer/blob/main/main.py"
    click UI_style "https://github.com/g-zak/ai_algo_visualizer/blob/main/style.py"
    click Algorithms "https://github.com/g-zak/ai_algo_visualizer/blob/main/algorithms.py"
    click Assets "https://github.com/g-zak/ai_algo_visualizer/tree/main/assets/"
    click Requirements "https://github.com/g-zak/ai_algo_visualizer/blob/main/requirements.txt"

    %% Styles
    classDef module fill:#E3F2FD,stroke:#2196F3,stroke-width:1px
    classDef framework fill:#FFF3E0,stroke:#FB8C00,stroke-width:1px
    classDef library fill:#E8F5E9,stroke:#43A047,stroke-width:1px
    classDef algorithm fill:#F3E5F5,stroke:#8E24AA,stroke-width:1px
    classDef resource fill:#FBE9E7,stroke:#D84315,stroke-width:1px
```
