# singlezombie/dl-demos architecture

> Architecture diagram of the GitHub repository singlezombie/dl-demos, 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/singlezombie/dl-demos
- Repository: https://github.com/singlezombie/dl-demos

## Overview

DL-Demos is a collection of runnable deep-learning demonstrations, not one end-user application. Its principal workflow is per-demo: prepare data, instantiate a model, train/evaluate it, then produce predictions, generated samples, or visualizations. The graph preserves the README’s major learning and generative-model branches. README and source-index references support many component links; unexcerpted demos are represented by their exact directory paths, and their internal wiring is left unasserted where it was not shown.

Main entry points: [`dldemos/AdvancedOptimizer/main.py`](https://github.com/singlezombie/dl-demos/blob/master/dldemos/AdvancedOptimizer/main.py) (Optimizer variants), [`dldemos/ddpm/main.py`](https://github.com/singlezombie/dl-demos/blob/master/dldemos/ddpm/main.py) (DDPM), [`dldemos/pixelcnn/main.py`](https://github.com/singlezombie/dl-demos/blob/master/dldemos/pixelcnn/main.py) (PixelCNN), [`dldemos/ddim/main.py`](https://github.com/singlezombie/dl-demos/blob/master/dldemos/ddim/main.py) (DDIM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning demos"]
  node_logistic["Logistic regression<br/>[main.py]"]
  node_shallow["Shallow network"]
  node_deep["Deep network"]
  node_initialization["Initialization<br/>[main.py]"]
  node_regularization["Regularization<br/>[main.py]"]
  node_optimizer["Optimizer variants<br/>[main.py]"]
  node_multiclass["Multiclass classification"]
  node_distributed["Distributed training<br/>[main.py]"]
end

subgraph group_vision["Vision demos"]
  node_cnn["Basic CNN"]
  node_resnet["ResNet<br/>[tf_main.py]"]
  node_nms["NMS and boxes<br/>[nms.py]"]
  node_yolo["YOLO data demo<br/>[load_coco.py]"]
end

subgraph group_generative["Generative models"]
  node_vae["VAE<br/>[main.py]"]
  node_ddpm["DDPM<br/>[main.py]"]
  node_pixelcnn["PixelCNN<br/>[main.py]"]
  node_vqvae["VQVAE<br/>[main.py]"]
  node_ddim["DDIM<br/>[main.py]"]
  node_style["Style transfer<br/>[style_transfer.py]"]
end

subgraph group_sequence["Sequence models"]
  node_rnn["Letter language model<br/>[main.py]"]
  node_sentiment["Sentiment analysis<br/>[main.py]"]
  node_attention["Attention translation<br/>[main.py]"]
  node_transformer["Transformer translation"]
end

subgraph group_shared["Shared runtime"]
  node_utils["Activation functions<br/>[function.py]"]
  node_lmdb["LMDB loader<br/>[lmdb_loader.py]"]
end

node_user(("Demo user"))

node_user -.->|"runs demo"| node_logistic
node_user -.->|"runs demo"| node_shallow
node_user -.->|"runs demo"| node_deep
node_user -.->|"runs demo"| node_initialization
node_user -.->|"runs demo"| node_regularization
node_user -->|"runs demo"| node_optimizer
node_optimizer -->|"loads data"| node_deep
node_optimizer -->|"uses activations"| node_utils
node_initialization -->|"uses activations"| node_utils
node_regularization -->|"uses activations"| node_utils
node_user -.->|"runs demo"| node_multiclass
node_user -.->|"runs demo"| node_cnn
node_user -->|"runs demo"| node_resnet
node_user -.->|"runs demo"| node_nms
node_user -.->|"runs demo"| node_yolo
node_yolo -->|"uses boxes"| node_nms
node_user -->|"runs demo"| node_vae
node_user -->|"runs demo"| node_ddpm
node_ddpm -->|"samples images"| node_ddpm
node_user -->|"runs demo"| node_pixelcnn
node_pixelcnn -->|"samples images"| node_pixelcnn
node_user -->|"runs demo"| node_vqvae
node_vqvae -->|"loads data"| node_lmdb
node_user -->|"runs demo"| node_ddim
node_ddim -->|"samples images"| node_ddim
node_user -->|"runs demo"| node_style
node_user -->|"runs demo"| node_rnn
node_rnn -->|"trains model"| node_rnn
node_user -->|"runs demo"| node_sentiment
node_sentiment -->|"trains model"| node_sentiment
node_user -->|"runs demo"| node_attention
node_attention -->|"evaluates model"| node_attention
node_user -.->|"runs demo"| node_transformer
node_user -->|"runs demo"| node_distributed

click node_logistic "https://github.com/singlezombie/dl-demos/blob/master/dldemos/LogisticRegression/main.py"
click node_shallow "https://github.com/singlezombie/dl-demos/tree/master/dldemos/ShallowNetwork"
click node_deep "https://github.com/singlezombie/dl-demos/tree/master/dldemos/DeepNetwork"
click node_initialization "https://github.com/singlezombie/dl-demos/blob/master/dldemos/Initialization/main.py"
click node_regularization "https://github.com/singlezombie/dl-demos/blob/master/dldemos/Regularization/main.py"
click node_optimizer "https://github.com/singlezombie/dl-demos/blob/master/dldemos/AdvancedOptimizer/main.py"
click node_multiclass "https://github.com/singlezombie/dl-demos/tree/master/dldemos/MulticlassClassification"
click node_cnn "https://github.com/singlezombie/dl-demos/tree/master/dldemos/BasicCNN"
click node_resnet "https://github.com/singlezombie/dl-demos/blob/master/dldemos/ResNet/tf_main.py"
click node_nms "https://github.com/singlezombie/dl-demos/blob/master/dldemos/nms/nms.py"
click node_yolo "https://github.com/singlezombie/dl-demos/blob/master/dldemos/MyYOLO/load_coco.py"
click node_vae "https://github.com/singlezombie/dl-demos/blob/master/dldemos/VAE/main.py"
click node_ddpm "https://github.com/singlezombie/dl-demos/blob/master/dldemos/ddpm/main.py"
click node_pixelcnn "https://github.com/singlezombie/dl-demos/blob/master/dldemos/pixelcnn/main.py"
click node_vqvae "https://github.com/singlezombie/dl-demos/blob/master/dldemos/VQVAE/main.py"
click node_ddim "https://github.com/singlezombie/dl-demos/blob/master/dldemos/ddim/main.py"
click node_style "https://github.com/singlezombie/dl-demos/blob/master/dldemos/StyleTransfer/style_transfer.py"
click node_rnn "https://github.com/singlezombie/dl-demos/blob/master/dldemos/BasicRNN/main.py"
click node_sentiment "https://github.com/singlezombie/dl-demos/blob/master/dldemos/SentimentAnalysis/main.py"
click node_attention "https://github.com/singlezombie/dl-demos/blob/master/dldemos/attention/main.py"
click node_transformer "https://github.com/singlezombie/dl-demos/tree/master/dldemos/Transformer"
click node_distributed "https://github.com/singlezombie/dl-demos/blob/master/dldemos/PyTorchDistributed/main.py"
click node_utils "https://github.com/singlezombie/dl-demos/blob/master/dldemos/utils/function.py"
click node_lmdb "https://github.com/singlezombie/dl-demos/blob/master/dldemos/lmdb_loader.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_logistic,node_shallow,node_deep,node_initialization,node_regularization,node_optimizer,node_multiclass,node_distributed,node_user toneBlue
class node_cnn,node_resnet,node_nms,node_yolo toneAmber
class node_vae,node_ddpm,node_pixelcnn,node_vqvae,node_ddim,node_style toneMint
class node_rnn,node_sentiment,node_attention,node_transformer toneRose
class node_utils,node_lmdb toneIndigo
```

## Components

### Learning demos

- [Logistic regression](https://github.com/singlezombie/dl-demos/blob/master/dldemos/LogisticRegression/main.py): `dldemos/LogisticRegression/main.py`
- [Shallow network](https://github.com/singlezombie/dl-demos/tree/master/dldemos/ShallowNetwork): `dldemos/ShallowNetwork`
- [Deep network](https://github.com/singlezombie/dl-demos/tree/master/dldemos/DeepNetwork): `dldemos/DeepNetwork`
- [Initialization](https://github.com/singlezombie/dl-demos/blob/master/dldemos/Initialization/main.py): `dldemos/Initialization/main.py`
- [Regularization](https://github.com/singlezombie/dl-demos/blob/master/dldemos/Regularization/main.py): `dldemos/Regularization/main.py`
- [Optimizer variants](https://github.com/singlezombie/dl-demos/blob/master/dldemos/AdvancedOptimizer/main.py): `dldemos/AdvancedOptimizer/main.py`
- [Multiclass classification](https://github.com/singlezombie/dl-demos/tree/master/dldemos/MulticlassClassification): `dldemos/MulticlassClassification`
- [Distributed training](https://github.com/singlezombie/dl-demos/blob/master/dldemos/PyTorchDistributed/main.py): `dldemos/PyTorchDistributed/main.py`

### Vision demos

- [Basic CNN](https://github.com/singlezombie/dl-demos/tree/master/dldemos/BasicCNN): `dldemos/BasicCNN`
- [ResNet](https://github.com/singlezombie/dl-demos/blob/master/dldemos/ResNet/tf_main.py): `dldemos/ResNet/tf_main.py`
- [NMS and boxes](https://github.com/singlezombie/dl-demos/blob/master/dldemos/nms/nms.py): `dldemos/nms/nms.py`
- [YOLO data demo](https://github.com/singlezombie/dl-demos/blob/master/dldemos/MyYOLO/load_coco.py): `dldemos/MyYOLO/load_coco.py`

### Generative models

- [VAE](https://github.com/singlezombie/dl-demos/blob/master/dldemos/VAE/main.py): `dldemos/VAE/main.py`
- [DDPM](https://github.com/singlezombie/dl-demos/blob/master/dldemos/ddpm/main.py): `dldemos/ddpm/main.py`
- [PixelCNN](https://github.com/singlezombie/dl-demos/blob/master/dldemos/pixelcnn/main.py): `dldemos/pixelcnn/main.py`
- [VQVAE](https://github.com/singlezombie/dl-demos/blob/master/dldemos/VQVAE/main.py): `dldemos/VQVAE/main.py`
- [DDIM](https://github.com/singlezombie/dl-demos/blob/master/dldemos/ddim/main.py): `dldemos/ddim/main.py`
- [Style transfer](https://github.com/singlezombie/dl-demos/blob/master/dldemos/StyleTransfer/style_transfer.py): `dldemos/StyleTransfer/style_transfer.py`

### Sequence models

- [Letter language model](https://github.com/singlezombie/dl-demos/blob/master/dldemos/BasicRNN/main.py): `dldemos/BasicRNN/main.py`
- [Sentiment analysis](https://github.com/singlezombie/dl-demos/blob/master/dldemos/SentimentAnalysis/main.py): `dldemos/SentimentAnalysis/main.py`
- [Attention translation](https://github.com/singlezombie/dl-demos/blob/master/dldemos/attention/main.py): `dldemos/attention/main.py`
- [Transformer translation](https://github.com/singlezombie/dl-demos/tree/master/dldemos/Transformer): `dldemos/Transformer`

### Shared runtime

- [Activation functions](https://github.com/singlezombie/dl-demos/blob/master/dldemos/utils/function.py): `dldemos/utils/function.py`
- [LMDB loader](https://github.com/singlezombie/dl-demos/blob/master/dldemos/lmdb_loader.py): `dldemos/lmdb_loader.py`

### Other components

- **Demo user**

## Connections

- Demo user → Logistic regression: runs demo
- Demo user → Shallow network: runs demo
- Demo user → Deep network: runs demo
- Demo user → Initialization: runs demo
- Demo user → Regularization: runs demo
- Demo user → Optimizer variants: runs demo (evidence: `dldemos/AdvancedOptimizer/main.py`)
- Optimizer variants → Deep network: loads data (evidence: `dldemos/AdvancedOptimizer/main.py`)
- Optimizer variants → Activation functions: uses activations
- Initialization → Activation functions: uses activations (evidence: `dldemos/Initialization/main.py`)
- Regularization → Activation functions: uses activations (evidence: `dldemos/Regularization/main.py`)
- Demo user → Multiclass classification: runs demo
- Demo user → Basic CNN: runs demo
- Demo user → ResNet: runs demo
- Demo user → NMS and boxes: runs demo
- Demo user → YOLO data demo: runs demo
- YOLO data demo → NMS and boxes: uses boxes (evidence: `dldemos/MyYOLO/load_coco.py`)
- Demo user → VAE: runs demo
- Demo user → DDPM: runs demo (evidence: `dldemos/ddpm/main.py`)
- DDPM → DDPM: samples images (evidence: `dldemos/ddpm/main.py`)
- Demo user → PixelCNN: runs demo (evidence: `dldemos/pixelcnn/main.py`)
- PixelCNN → PixelCNN: samples images (evidence: `dldemos/pixelcnn/main.py`)
- Demo user → VQVAE: runs demo (evidence: `dldemos/VQVAE/main.py`)
- VQVAE → LMDB loader: loads data
- Demo user → DDIM: runs demo (evidence: `dldemos/ddim/main.py`)
- DDIM → DDIM: samples images (evidence: `dldemos/ddim/main.py`)
- Demo user → Style transfer: runs demo
- Demo user → Letter language model: runs demo (evidence: `dldemos/BasicRNN/main.py`)
- Letter language model → Letter language model: trains model (evidence: `dldemos/BasicRNN/main.py`)
- Demo user → Sentiment analysis: runs demo (evidence: `dldemos/SentimentAnalysis/main.py`)
- Sentiment analysis → Sentiment analysis: trains model (evidence: `dldemos/SentimentAnalysis/main.py`)
- Demo user → Attention translation: runs demo (evidence: `dldemos/attention/main.py`)
- Attention translation → Attention translation: evaluates model (evidence: `dldemos/attention/main.py`)
- Demo user → Transformer translation: runs demo
- Demo user → Distributed training: runs demo
