# vivalololo/aie-project architecture

> Architecture diagram of the GitHub repository vivalololo/aie-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vivalololo/aie-project
- Repository: https://github.com/vivalololo/aie-project

## Overview

This repository is both a collection of seminar homework and a chest-X-ray pneumonia classification project. The project workflow prepares image datasets, trains and evaluates a ResNet-18 classifier, saves model weights, and serves image predictions through an API. Separate HW03/HW04 EDA tools provide CSV analysis through a CLI, with HW04 adding HTTP quality checks. The graph focuses on these executable capabilities; connections for unsampled homework notebooks are limited to the README’s description of their role.

Main entry points: [`project/src/train.py`](https://github.com/vivalololo/aie-project/blob/main/project/src/train.py) (Training workflow), [`project/src/predict.py`](https://github.com/vivalololo/aie-project/blob/main/project/src/predict.py) (Image prediction), [`project/src/data.py`](https://github.com/vivalololo/aie-project/blob/main/project/src/data.py) (Image data), [`homeworks/HW03/eda-cli/src/eda_cli/cli.py`](https://github.com/vivalololo/aie-project/blob/main/homeworks/HW03/eda-cli/src/eda_cli/cli.py) (EDA CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coursework["Coursework"]
  node_homeworks["Seminar assignments"]
end

subgraph group_eda["Dataset quality"]
  node_hw03_cli["EDA CLI<br/>[cli.py]"]
  node_hw03_core["EDA analysis<br/>[core.py]"]
  node_hw03_viz["EDA charts<br/>[viz.py]"]
  node_hw04_api["Quality API<br/>[api.py]"]
  node_hw04_core["Quality analysis<br/>[core.py]"]
end

subgraph group_xray["X-ray classifier"]
  node_training["Training workflow<br/>[train.py]"]
  node_image_data["Image data<br/>[data.py]"]
  node_classifier["ResNet-18<br/>[model.py]"]
  node_evaluation["Model evaluation<br/>[evaluate.py]"]
  node_saved_weights["Saved weights<br/>[model.pth]"]
  node_prediction["Image prediction<br/>[predict.py]"]
  node_prediction_api["Prediction API<br/>[api.py]"]
end

node_student(("Student"))
node_xray_user(("Prediction user"))
node_kaggle(("Kaggle dataset"))

node_student -->|"completes"| node_homeworks
node_hw03_cli -->|"analyzes"| node_hw03_core
node_hw03_cli -->|"generates charts"| node_hw03_viz
node_hw04_api -->|"checks CSV"| node_hw04_core
node_training -->|"loads datasets"| node_image_data
node_training -->|"builds model"| node_classifier
node_training -->|"evaluates model"| node_evaluation
node_training -->|"saves weights"| node_saved_weights
node_image_data -->|"downloads dataset"| node_kaggle
node_prediction_api -->|"routes prediction"| node_prediction
node_prediction -->|"builds model"| node_classifier
node_prediction -->|"uses transforms"| node_image_data
node_prediction -->|"loads weights"| node_saved_weights
node_xray_user -.->|"requests prediction"| node_prediction_api

click node_homeworks "https://github.com/vivalololo/aie-project/tree/main/homeworks"
click node_hw03_cli "https://github.com/vivalololo/aie-project/blob/main/homeworks/HW03/eda-cli/src/eda_cli/cli.py"
click node_hw03_core "https://github.com/vivalololo/aie-project/blob/main/homeworks/HW03/eda-cli/src/eda_cli/core.py"
click node_hw03_viz "https://github.com/vivalololo/aie-project/blob/main/homeworks/HW03/eda-cli/src/eda_cli/viz.py"
click node_hw04_api "https://github.com/vivalololo/aie-project/blob/main/homeworks/HW04/eda-cli/src/eda_cli/api.py"
click node_hw04_core "https://github.com/vivalololo/aie-project/blob/main/homeworks/HW04/eda-cli/src/eda_cli/core.py"
click node_training "https://github.com/vivalololo/aie-project/blob/main/project/src/train.py"
click node_image_data "https://github.com/vivalololo/aie-project/blob/main/project/src/data.py"
click node_classifier "https://github.com/vivalololo/aie-project/blob/main/project/src/model.py"
click node_evaluation "https://github.com/vivalololo/aie-project/blob/main/project/src/evaluate.py"
click node_saved_weights "https://github.com/vivalololo/aie-project/blob/main/project/artifacts/model.pth"
click node_prediction "https://github.com/vivalololo/aie-project/blob/main/project/src/predict.py"
click node_prediction_api "https://github.com/vivalololo/aie-project/blob/main/project/src/api.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_homeworks,node_xray_user toneBlue
class node_hw03_cli,node_hw03_core,node_hw03_viz,node_hw04_api,node_hw04_core toneAmber
class node_training,node_image_data,node_classifier,node_evaluation,node_saved_weights,node_prediction,node_prediction_api toneMint
class node_student,node_kaggle toneIndigo
```

## Components

### Coursework

- [Seminar assignments](https://github.com/vivalololo/aie-project/tree/main/homeworks): `homeworks`

### Dataset quality

- [EDA CLI](https://github.com/vivalololo/aie-project/blob/main/homeworks/HW03/eda-cli/src/eda_cli/cli.py): `homeworks/HW03/eda-cli/src/eda_cli/cli.py`
- [EDA analysis](https://github.com/vivalololo/aie-project/blob/main/homeworks/HW03/eda-cli/src/eda_cli/core.py): `homeworks/HW03/eda-cli/src/eda_cli/core.py`
- [EDA charts](https://github.com/vivalololo/aie-project/blob/main/homeworks/HW03/eda-cli/src/eda_cli/viz.py): `homeworks/HW03/eda-cli/src/eda_cli/viz.py`
- [Quality API](https://github.com/vivalololo/aie-project/blob/main/homeworks/HW04/eda-cli/src/eda_cli/api.py): `homeworks/HW04/eda-cli/src/eda_cli/api.py`
- [Quality analysis](https://github.com/vivalololo/aie-project/blob/main/homeworks/HW04/eda-cli/src/eda_cli/core.py): `homeworks/HW04/eda-cli/src/eda_cli/core.py`

### X-ray classifier

- [Training workflow](https://github.com/vivalololo/aie-project/blob/main/project/src/train.py): `project/src/train.py`
- [Image data](https://github.com/vivalololo/aie-project/blob/main/project/src/data.py): `project/src/data.py`
- [ResNet-18](https://github.com/vivalololo/aie-project/blob/main/project/src/model.py): `project/src/model.py`
- [Model evaluation](https://github.com/vivalololo/aie-project/blob/main/project/src/evaluate.py): `project/src/evaluate.py`
- [Saved weights](https://github.com/vivalololo/aie-project/blob/main/project/artifacts/model.pth): `project/artifacts/model.pth`
- [Image prediction](https://github.com/vivalololo/aie-project/blob/main/project/src/predict.py): `project/src/predict.py`
- [Prediction API](https://github.com/vivalololo/aie-project/blob/main/project/src/api.py): `project/src/api.py`

### Other components

- **Student**
- **Prediction user**
- **Kaggle dataset**

## Connections

- Student → Seminar assignments: completes (evidence: `README.md`)
- EDA CLI → EDA analysis: analyzes (evidence: `homeworks/HW03/eda-cli/src/eda_cli/cli.py`)
- EDA CLI → EDA charts: generates charts (evidence: `homeworks/HW03/eda-cli/src/eda_cli/cli.py`)
- Quality API → Quality analysis: checks CSV (evidence: `homeworks/HW04/eda-cli/src/eda_cli/api.py`)
- Training workflow → Image data: loads datasets (evidence: `project/src/train.py`)
- Training workflow → ResNet-18: builds model (evidence: `project/src/train.py`)
- Training workflow → Model evaluation: evaluates model (evidence: `project/src/train.py`)
- Training workflow → Saved weights: saves weights (evidence: `project/src/train.py`)
- Image data → Kaggle dataset: downloads dataset (evidence: `project/src/data.py`)
- Prediction API → Image prediction: routes prediction (evidence: `project/src/api.py`)
- Image prediction → ResNet-18: builds model (evidence: `project/src/predict.py`)
- Image prediction → Image data: uses transforms (evidence: `project/src/predict.py`)
- Image prediction → Saved weights: loads weights (evidence: `project/src/predict.py`)
- Prediction user → Prediction API: requests prediction
