# ddps-lab/ai-platform architecture

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

- Interactive diagram: https://gitdiagram.com/ddps-lab/ai-platform
- Repository: https://github.com/ddps-lab/ai-platform

## Overview

This repository is a collection of AI-platform learning examples, centered on training and serving a five-class flower image classifier. The user-facing path is image upload, preprocessing and prediction, then ranked results in a web page or serverless response. It includes EC2 and SageMaker training examples, local-model Flask inference, SageMaker endpoint inference, and a Lambda container example. The README describes the repository only broadly; several workflows are represented by unsampled notebooks or templates, so those connections are left unasserted.

Main entry points: [`ec2-deploy/flask-inference.py`](https://github.com/ddps-lab/ai-platform/blob/main/ec2-deploy/flask-inference.py) (EC2 Flask app), [`flask-inference/main.py`](https://github.com/ddps-lab/ai-platform/blob/main/flask-inference/main.py) (Local Flask app), [`sagemaker/flask-for-sagemaker.py`](https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flask-for-sagemaker.py) (SageMaker Flask app), [`serverless-inference/lambda-image-build/lambda_function_container.py`](https://github.com/ddps-lab/ai-platform/blob/main/serverless-inference/lambda-image-build/lambda_function_container.py) (Lambda handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Model training"]
  node_ec2train["EC2 training example"]
  node_smtrain["SageMaker trainer"]
  node_smdeploy["SageMaker deploy example"]
  node_model["Flower model"]
end

subgraph group_flask["Flask inference"]
  node_ec2app["EC2 Flask app<br/>[flask-inference.py]"]
  node_localapp["Local Flask app<br/>[main.py]"]
  node_smapp["SageMaker Flask app"]
  node_localmodel["Local model loader<br/>[main.py]"]
  node_ec2model["EC2 model loader<br/>[flask-inference.py]"]
  node_endpoint{{"SageMaker endpoint"}}
end

subgraph group_serverless["Serverless inference"]
  node_lambda["Lambda handler"]
  node_lambdamodel["Lambda model loader"]
end

subgraph group_presentation["User interfaces"]
  node_ec2page["EC2 upload page<br/>[index.html]"]
  node_localpage["Flask upload page<br/>[index.html]"]
  node_smpage["SageMaker upload page<br/>[index.html]"]
  node_serverpage["Serverless client page<br/>[index.html]"]
end

node_user(("Image user"))

node_smtrain -->|"saves model"| node_model
node_ec2app -->|"renders page"| node_ec2page
node_localapp -->|"renders page"| node_localpage
node_smapp -->|"renders page"| node_smpage
node_ec2app -->|"accepts upload"| node_user
node_user -.->|"uses page"| node_ec2page
node_user -.->|"uses page"| node_localpage
node_user -.->|"uses page"| node_smpage
node_localapp -->|"accepts upload"| node_user
node_smapp -->|"accepts upload"| node_user
node_ec2app -->|"predicts image"| node_ec2model
node_localapp -->|"predicts image"| node_localmodel
node_smapp -->|"requests prediction"| node_endpoint
node_lambda -->|"predicts image"| node_lambdamodel
node_user -.->|"uses page"| node_serverpage
node_serverpage -.->|"sends image"| node_lambda

click node_ec2train "https://github.com/ddps-lab/ai-platform/blob/main/ec2-train/flower_model_train.ipynb"
click node_smtrain "https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flower_model_train.py"
click node_smdeploy "https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flower_model_train_deploy.ipynb"
click node_model "https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flower_model_train.py"
click node_ec2app "https://github.com/ddps-lab/ai-platform/blob/main/ec2-deploy/flask-inference.py"
click node_localapp "https://github.com/ddps-lab/ai-platform/blob/main/flask-inference/main.py"
click node_smapp "https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flask-for-sagemaker.py"
click node_localmodel "https://github.com/ddps-lab/ai-platform/blob/main/flask-inference/main.py"
click node_ec2model "https://github.com/ddps-lab/ai-platform/blob/main/ec2-deploy/flask-inference.py"
click node_lambda "https://github.com/ddps-lab/ai-platform/blob/main/serverless-inference/lambda-image-build/lambda_function_container.py"
click node_lambdamodel "https://github.com/ddps-lab/ai-platform/blob/main/serverless-inference/lambda-image-build/lambda_function_container.py"
click node_ec2page "https://github.com/ddps-lab/ai-platform/blob/main/ec2-deploy/templates/index.html"
click node_localpage "https://github.com/ddps-lab/ai-platform/blob/main/flask-inference/templates/index.html"
click node_smpage "https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/templates/index.html"
click node_serverpage "https://github.com/ddps-lab/ai-platform/blob/main/serverless-inference/index.html"

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_ec2train,node_smtrain,node_smdeploy,node_model,node_user toneBlue
class node_ec2app,node_localapp,node_smapp,node_localmodel,node_ec2model,node_endpoint toneAmber
class node_lambda,node_lambdamodel toneMint
class node_ec2page,node_localpage,node_smpage,node_serverpage toneRose
```

## Components

### Model training

- [EC2 training example](https://github.com/ddps-lab/ai-platform/blob/main/ec2-train/flower_model_train.ipynb): `ec2-train/flower_model_train.ipynb`
- [SageMaker trainer](https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flower_model_train.py): `sagemaker/flower_model_train.py`
- [SageMaker deploy example](https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flower_model_train_deploy.ipynb): `sagemaker/flower_model_train_deploy.ipynb`
- [Flower model](https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flower_model_train.py): `sagemaker/flower_model_train.py`

### Flask inference

- [EC2 Flask app](https://github.com/ddps-lab/ai-platform/blob/main/ec2-deploy/flask-inference.py): `ec2-deploy/flask-inference.py`
- [Local Flask app](https://github.com/ddps-lab/ai-platform/blob/main/flask-inference/main.py): `flask-inference/main.py`
- [SageMaker Flask app](https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/flask-for-sagemaker.py): `sagemaker/flask-for-sagemaker.py`
- [Local model loader](https://github.com/ddps-lab/ai-platform/blob/main/flask-inference/main.py): `flask-inference/main.py`
- [EC2 model loader](https://github.com/ddps-lab/ai-platform/blob/main/ec2-deploy/flask-inference.py): `ec2-deploy/flask-inference.py`
- **SageMaker endpoint**

### Serverless inference

- [Lambda handler](https://github.com/ddps-lab/ai-platform/blob/main/serverless-inference/lambda-image-build/lambda_function_container.py): `serverless-inference/lambda-image-build/lambda_function_container.py`
- [Lambda model loader](https://github.com/ddps-lab/ai-platform/blob/main/serverless-inference/lambda-image-build/lambda_function_container.py): `serverless-inference/lambda-image-build/lambda_function_container.py`

### User interfaces

- [EC2 upload page](https://github.com/ddps-lab/ai-platform/blob/main/ec2-deploy/templates/index.html): `ec2-deploy/templates/index.html`
- [Flask upload page](https://github.com/ddps-lab/ai-platform/blob/main/flask-inference/templates/index.html): `flask-inference/templates/index.html`
- [SageMaker upload page](https://github.com/ddps-lab/ai-platform/blob/main/sagemaker/templates/index.html): `sagemaker/templates/index.html`
- [Serverless client page](https://github.com/ddps-lab/ai-platform/blob/main/serverless-inference/index.html): `serverless-inference/index.html`

### Other components

- **Image user**

## Connections

- SageMaker trainer → Flower model: saves model (evidence: `sagemaker/flower_model_train.py`)
- EC2 Flask app → EC2 upload page: renders page (evidence: `ec2-deploy/flask-inference.py`)
- Local Flask app → Flask upload page: renders page (evidence: `flask-inference/main.py`)
- SageMaker Flask app → SageMaker upload page: renders page (evidence: `sagemaker/flask-for-sagemaker.py`)
- EC2 Flask app → Image user: accepts upload (evidence: `ec2-deploy/flask-inference.py`)
- Image user → EC2 upload page: uses page
- Image user → Flask upload page: uses page
- Image user → SageMaker upload page: uses page
- Local Flask app → Image user: accepts upload (evidence: `flask-inference/main.py`)
- SageMaker Flask app → Image user: accepts upload (evidence: `sagemaker/flask-for-sagemaker.py`)
- EC2 Flask app → EC2 model loader: predicts image (evidence: `ec2-deploy/flask-inference.py`)
- Local Flask app → Local model loader: predicts image (evidence: `flask-inference/main.py`)
- SageMaker Flask app → SageMaker endpoint: requests prediction (evidence: `sagemaker/flask-for-sagemaker.py`)
- Lambda handler → Lambda model loader: predicts image (evidence: `serverless-inference/lambda-image-build/lambda_function_container.py`)
- Image user → Serverless client page: uses page
- Serverless client page → Lambda handler: sends image
