# aws-samples/ml-edge-getting-started architecture

> Architecture diagram of the GitHub repository aws-samples/ml-edge-getting-started, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-samples/ml-edge-getting-started
- Repository: https://github.com/aws-samples/ml-edge-getting-started

## Overview

This repository collects two AWS ML-at-the-edge reference samples, rather than providing one shared runtime. The first covers wind-turbine anomaly detection and model lifecycle management for a simulated device fleet; the second demonstrates image classification in a browser on a local device. The tree identifies cloud, edge, and frontend/backend components, but no source excerpts or sample-specific README contents were provided, so links between those components are limited to relationships stated in the root README.

Main entry points: [`samples/onnx_accelerator_sample1/README.md`](https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample1/README.md) (Wind Sample Guide), [`samples/onnx_accelerator_sample2/README.md`](https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample2/README.md) (Image Sample Guide), [`samples/onnx_accelerator_sample1/onnxacceleratorsampleone`](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/onnxacceleratorsampleone) (Wind Cloud Stack), [`samples/onnx_accelerator_sample1/simulated_device`](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/simulated_device) (Simulated Turbine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_wind["Wind Anomaly Sample"]
  node_wind_docs["Wind Sample Guide<br/>[README.md]"]
  node_wind_train["Model Preparation"]
  node_wind_stack["Wind Cloud Stack"]
  node_wind_deploy["Greengrass Deployment"]
  node_wind_edge["Anomaly Detector"]
  node_wind_device["Simulated Turbine"]
end

subgraph group_mobile["Browser Image Sample"]
  node_mobile_docs["Image Sample Guide<br/>[README.md]"]
  node_mobile_frontend["Browser Classifier"]
  node_mobile_predict["Image Prediction<br/>[predict.ts]"]
end

subgraph group_cloud["Cloud Capabilities"]
  node_backend_stack["Mobile Backend Stack"]
  node_backend_api["Backend API"]
  node_upload_url["Image Upload URL"]
  node_model_url["Model Download URL"]
  node_log_ingestion["Log Ingestion"]
end

node_engineer(("Solution Builder"))
node_local_device(("Local Device"))

node_engineer -->|"uses guide"| node_wind_docs
node_wind_docs -->|"describes lifecycle"| node_wind_stack
node_wind_docs -->|"targets fleet"| node_wind_device
node_mobile_docs -->|"describes classifier"| node_mobile_frontend
node_mobile_docs -->|"targets device"| node_local_device

click node_wind_docs "https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample1/README.md"
click node_wind_train "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/notebooks"
click node_wind_stack "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/onnxacceleratorsampleone"
click node_wind_deploy "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/onnxacceleratorsampleone/with_ggv2"
click node_wind_edge "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/edge_application"
click node_wind_device "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/simulated_device"
click node_mobile_docs "https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample2/README.md"
click node_mobile_frontend "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/frontend"
click node_mobile_predict "https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample2/source/frontend/utils/predict.ts"
click node_backend_stack "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/onnxacceleratormobilebackend"
click node_backend_api "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/onnxacceleratormobilebackend/api"
click node_upload_url "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/functions/upload_image_url"
click node_model_url "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/functions/model_presigned_url"
click node_log_ingestion "https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/functions/logsingestion"

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_wind_docs,node_wind_train,node_wind_stack,node_wind_deploy,node_wind_edge,node_wind_device toneBlue
class node_mobile_docs,node_mobile_frontend,node_mobile_predict toneAmber
class node_backend_stack,node_backend_api,node_upload_url,node_model_url,node_log_ingestion toneMint
class node_engineer,node_local_device toneIndigo
```

## Components

### Wind Anomaly Sample

- [Wind Sample Guide](https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample1/README.md): `samples/onnx_accelerator_sample1/README.md`
- [Model Preparation](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/notebooks): `samples/onnx_accelerator_sample1/notebooks`
- [Wind Cloud Stack](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/onnxacceleratorsampleone): `samples/onnx_accelerator_sample1/onnxacceleratorsampleone`
- [Greengrass Deployment](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/onnxacceleratorsampleone/with_ggv2): `samples/onnx_accelerator_sample1/onnxacceleratorsampleone/with_ggv2`
- [Anomaly Detector](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/edge_application): `samples/onnx_accelerator_sample1/edge_application`
- [Simulated Turbine](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample1/simulated_device): `samples/onnx_accelerator_sample1/simulated_device`

### Browser Image Sample

- [Image Sample Guide](https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample2/README.md): `samples/onnx_accelerator_sample2/README.md`
- [Browser Classifier](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/frontend): `samples/onnx_accelerator_sample2/source/frontend`
- [Image Prediction](https://github.com/aws-samples/ml-edge-getting-started/blob/main/samples/onnx_accelerator_sample2/source/frontend/utils/predict.ts): `samples/onnx_accelerator_sample2/source/frontend/utils/predict.ts`

### Cloud Capabilities

- [Mobile Backend Stack](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/onnxacceleratormobilebackend): `samples/onnx_accelerator_sample2/source/backend/onnxacceleratormobilebackend`
- [Backend API](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/onnxacceleratormobilebackend/api): `samples/onnx_accelerator_sample2/source/backend/onnxacceleratormobilebackend/api`
- [Image Upload URL](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/functions/upload_image_url): `samples/onnx_accelerator_sample2/source/backend/functions/upload_image_url`
- [Model Download URL](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/functions/model_presigned_url): `samples/onnx_accelerator_sample2/source/backend/functions/model_presigned_url`
- [Log Ingestion](https://github.com/aws-samples/ml-edge-getting-started/tree/main/samples/onnx_accelerator_sample2/source/backend/functions/logsingestion): `samples/onnx_accelerator_sample2/source/backend/functions/logsingestion`

### Other components

- **Solution Builder**
- **Local Device**

## Connections

- Solution Builder → Wind Sample Guide: uses guide
- Wind Sample Guide → Wind Cloud Stack: describes lifecycle
- Wind Sample Guide → Simulated Turbine: targets fleet
- Image Sample Guide → Browser Classifier: describes classifier
- Image Sample Guide → Local Device: targets device