# deepjavalibrary/djl-spring-boot-starter architecture

> Architecture diagram of the GitHub repository deepjavalibrary/djl-spring-boot-starter, 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/deepjavalibrary/djl-spring-boot-starter
- Repository: https://github.com/deepjavalibrary/djl-spring-boot-starter

## Overview

DJL Spring Boot Starter lets Spring applications configure DJL inference through dependency choices and `djl.*` properties. The documented flow is: select an engine starter, configure model criteria, let Spring auto-configuration load a model, then obtain a predictor for inference. The source excerpt confirms property-to-model configuration and predictor creation; sample application internals and engine starter POM contents were not provided, so those connections are limited to README-supported statements.

Main entry points: [`djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java) (Model autoconfig), [`djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlConfigurationProperties.java`](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlConfigurationProperties.java) (DJL properties), [`djl-spring-boot-starter-mxnet-auto/pom.xml`](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-auto/pom.xml) (MXNet auto), [`djl-spring-boot-starter-mxnet-linux-x86_64/pom.xml`](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-linux-x86_64/pom.xml) (MXNet Linux)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_starters["Engine starters"]
  node_mxauto["MXNet auto<br/>[pom.xml]"]
  node_mxlinux["MXNet Linux<br/>[pom.xml]"]
  node_mxosx["MXNet macOS<br/>[pom.xml]"]
  node_pytorch["PyTorch auto<br/>[pom.xml]"]
  node_tensorflow["TensorFlow auto<br/>[pom.xml]"]
end

subgraph group_configuration["Spring configuration"]
  node_properties["DJL properties"]
  node_app_types["Application types"]
  node_autoconfig["Model autoconfig"]
end

subgraph group_inference["Inference runtime"]
  node_criteria["DJL criteria"]
  node_model_zoo["Model Zoo"]
  node_model["Loaded model"]
  node_predictor["Predictor provider"]
  node_inference_result["Inference result"]
end

node_developer(("Application developer"))
node_springapp["Spring application"]

node_developer -->|"configures"| node_springapp
node_developer -->|"selects engine"| node_mxauto
node_developer -->|"selects engine"| node_mxlinux
node_developer -->|"selects engine"| node_mxosx
node_developer -->|"selects engine"| node_pytorch
node_developer -->|"selects engine"| node_tensorflow
node_springapp -->|"sets properties"| node_properties
node_autoconfig -->|"binds properties"| node_properties
node_autoconfig -->|"reads application type"| node_app_types
node_autoconfig -->|"builds criteria"| node_criteria
node_autoconfig -->|"loads model"| node_model
node_criteria -.->|"selects model"| node_model_zoo
node_autoconfig -->|"lists models"| node_model_zoo
node_predictor -->|"creates predictor"| node_model
node_springapp -.->|"requests inference"| node_predictor
node_predictor -.->|"returns prediction"| node_inference_result

click node_mxauto "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-auto/pom.xml"
click node_mxlinux "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-linux-x86_64/pom.xml"
click node_mxosx "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-osx-x86_64/pom.xml"
click node_pytorch "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-pytorch-auto/pom.xml"
click node_tensorflow "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-tensorflow-auto/pom.xml"
click node_properties "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlConfigurationProperties.java"
click node_app_types "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/ApplicationType.java"
click node_autoconfig "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java"
click node_model "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java"
click node_predictor "https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java"

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_mxauto,node_mxlinux,node_mxosx,node_pytorch,node_tensorflow toneBlue
class node_properties,node_app_types,node_autoconfig toneAmber
class node_criteria,node_model_zoo,node_model,node_predictor,node_inference_result toneMint
class node_developer,node_springapp toneIndigo
```

## Components

### Engine starters

- [MXNet auto](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-auto/pom.xml): `djl-spring-boot-starter-mxnet-auto/pom.xml`
- [MXNet Linux](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-linux-x86_64/pom.xml): `djl-spring-boot-starter-mxnet-linux-x86_64/pom.xml`
- [MXNet macOS](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-mxnet-osx-x86_64/pom.xml): `djl-spring-boot-starter-mxnet-osx-x86_64/pom.xml`
- [PyTorch auto](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-pytorch-auto/pom.xml): `djl-spring-boot-starter-pytorch-auto/pom.xml`
- [TensorFlow auto](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-tensorflow-auto/pom.xml): `djl-spring-boot-starter-tensorflow-auto/pom.xml`

### Spring configuration

- [DJL properties](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlConfigurationProperties.java): `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlConfigurationProperties.java`
- [Application types](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/ApplicationType.java): `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/ApplicationType.java`
- [Model autoconfig](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java): `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`

### Inference runtime

- **DJL criteria**
- **Model Zoo**
- [Loaded model](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java): `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`
- [Predictor provider](https://github.com/deepjavalibrary/djl-spring-boot-starter/blob/master/djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java): `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`
- **Inference result**

### Other components

- **Application developer**
- **Spring application**

## Connections

- Application developer → Spring application: configures (evidence: `README.md`)
- Application developer → MXNet auto: selects engine (evidence: `README.md`)
- Application developer → MXNet Linux: selects engine (evidence: `README.md`)
- Application developer → MXNet macOS: selects engine (evidence: `README.md`)
- Application developer → PyTorch auto: selects engine (evidence: `README.md`)
- Application developer → TensorFlow auto: selects engine (evidence: `README.md`)
- Spring application → DJL properties: sets properties (evidence: `README.md`)
- Model autoconfig → DJL properties: binds properties (evidence: `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`)
- Model autoconfig → Application types: reads application type (evidence: `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`)
- Model autoconfig → DJL criteria: builds criteria (evidence: `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`)
- Model autoconfig → Loaded model: loads model (evidence: `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`)
- DJL criteria → Model Zoo: selects model
- Model autoconfig → Model Zoo: lists models (evidence: `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`)
- Predictor provider → Loaded model: creates predictor (evidence: `djl-spring-boot-starter-autoconfigure/src/main/java/ai/djl/spring/configuration/DjlAutoConfiguration.java`)
- Spring application → Predictor provider: requests inference
- Predictor provider → Inference result: returns prediction
