# microsoft/generative-ai-for-beginners-java architecture

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

- Interactive diagram: https://gitdiagram.com/microsoft/generative-ai-for-beginners-java
- Repository: https://github.com/microsoft/generative-ai-for-beginners-java

## Overview

This repository is a Java-focused generative-AI learning course, not one integrated runtime application. A learner follows five chapters from foundational concepts and environment setup through techniques, practical samples, and responsible-AI guidance. Chapter 2 includes Azure provisioning and a Spring AI chat example; later chapters cover SDK-based techniques, RAG, function calling, and sample applications. The graph preserves those documented capability areas; unsampled chapter internals are represented by their existing directories rather than inferred implementations.

Main entry points: [`03-CoreGenerativeAITechniques/README.md`](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/README.md) (Core Techniques), [`04-PracticalSamples/README.md`](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/04-PracticalSamples/README.md) (Project Samples), [`02-SetupDevEnvironment/README.md`](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/02-SetupDevEnvironment/README.md) (Environment Setup), [`04-PracticalSamples/foundrylocal`](https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/04-PracticalSamples/foundrylocal) (Foundry Local)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Course Path"]
  node_intro["GenAI Foundations<br/>[README.md]"]
end

subgraph group_setup["Environment Setup"]
  node_environment["Environment Setup<br/>[README.md]"]
  node_provision["Azure Provisioning"]
  node_chat["Spring AI Chat"]
end

subgraph group_techniques["GenAI Techniques"]
  node_core["Core Techniques<br/>[README.md]"]
  node_prompting["Prompting &amp; Completions"]
  node_embeddings["Embeddings &amp; Search"]
  node_rag["RAG"]
  node_functions["Function Calling<br/>[FunctionsApp.java]"]
end

subgraph group_projects["Practical Samples"]
  node_projects["Project Samples<br/>[README.md]"]
  node_petstory["Pet Story Generator"]
  node_foundry["Foundry Local"]
  node_localruntime["Local Model Runtime<br/>[start-foundry.mjs]"]
  node_calculator["MCP Calculator"]
end

subgraph group_safety["Responsible AI"]
  node_responsible["Responsible AI<br/>[README.md]"]
  node_safetydemo["Safety Demo"]
end

node_learner(("Learner"))

node_learner -->|"starts course"| node_intro
node_learner -->|"continues to"| node_environment
node_learner -->|"continues to"| node_core
node_learner -->|"explores"| node_projects
node_learner -->|"finishes with"| node_responsible
node_environment -->|"covers"| node_provision
node_environment -->|"includes"| node_chat
node_core -->|"demonstrates"| node_prompting
node_core -->|"covers"| node_embeddings
node_core -->|"demonstrates"| node_rag
node_core -->|"demonstrates"| node_functions
node_projects -->|"includes"| node_petstory
node_projects -->|"includes"| node_foundry
node_projects -->|"includes"| node_calculator
node_foundry -.->|"starts runtime"| node_localruntime
node_responsible -->|"features demo"| node_safetydemo

click node_intro "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/01-IntroToGenAI/README.md"
click node_environment "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/02-SetupDevEnvironment/README.md"
click node_provision "https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/02-SetupDevEnvironment/infra"
click node_chat "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/02-SetupDevEnvironment/examples/basic-chat-azure/src/main/java/com/example/BasicChatApplication.java"
click node_core "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/README.md"
click node_prompting "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/completions/LLMCompletionsApp.java"
click node_embeddings "https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/03-CoreGenerativeAITechniques/examples"
click node_rag "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/rag/SimpleReaderDemo.java"
click node_functions "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/functions/FunctionsApp.java"
click node_projects "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/04-PracticalSamples/README.md"
click node_petstory "https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/04-PracticalSamples/petstory"
click node_foundry "https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/04-PracticalSamples/foundrylocal"
click node_localruntime "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/04-PracticalSamples/foundrylocal/scripts/start-foundry.mjs"
click node_calculator "https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/04-PracticalSamples/calculator"
click node_responsible "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/05-ResponsibleGenAI/README.md"
click node_safetydemo "https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/responsibleai/ResponsibleAIDemo.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_intro toneBlue
class node_environment,node_provision,node_chat toneAmber
class node_core,node_prompting,node_embeddings,node_rag,node_functions toneMint
class node_projects,node_petstory,node_foundry,node_localruntime,node_calculator toneRose
class node_responsible,node_safetydemo,node_learner toneIndigo
```

## Components

### Course Path

- [GenAI Foundations](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/01-IntroToGenAI/README.md): `01-IntroToGenAI/README.md`

### Environment Setup

- [Environment Setup](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/02-SetupDevEnvironment/README.md): `02-SetupDevEnvironment/README.md`
- [Azure Provisioning](https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/02-SetupDevEnvironment/infra): `02-SetupDevEnvironment/infra`
- [Spring AI Chat](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/02-SetupDevEnvironment/examples/basic-chat-azure/src/main/java/com/example/BasicChatApplication.java): `02-SetupDevEnvironment/examples/basic-chat-azure/src/main/java/com/example/BasicChatApplication.java`

### GenAI Techniques

- [Core Techniques](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/README.md): `03-CoreGenerativeAITechniques/README.md`
- [Prompting & Completions](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/completions/LLMCompletionsApp.java): `03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/completions/LLMCompletionsApp.java`
- [Embeddings & Search](https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/03-CoreGenerativeAITechniques/examples): `03-CoreGenerativeAITechniques/examples`
- [RAG](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/rag/SimpleReaderDemo.java): `03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/rag/SimpleReaderDemo.java`
- [Function Calling](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/functions/FunctionsApp.java): `03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/functions/FunctionsApp.java`

### Practical Samples

- [Project Samples](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/04-PracticalSamples/README.md): `04-PracticalSamples/README.md`
- [Pet Story Generator](https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/04-PracticalSamples/petstory): `04-PracticalSamples/petstory`
- [Foundry Local](https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/04-PracticalSamples/foundrylocal): `04-PracticalSamples/foundrylocal`
- [Local Model Runtime](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/04-PracticalSamples/foundrylocal/scripts/start-foundry.mjs): `04-PracticalSamples/foundrylocal/scripts/start-foundry.mjs`
- [MCP Calculator](https://github.com/microsoft/generative-ai-for-beginners-java/tree/main/04-PracticalSamples/calculator): `04-PracticalSamples/calculator`

### Responsible AI

- [Responsible AI](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/05-ResponsibleGenAI/README.md): `05-ResponsibleGenAI/README.md`
- [Safety Demo](https://github.com/microsoft/generative-ai-for-beginners-java/blob/main/03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/responsibleai/ResponsibleAIDemo.java): `03-CoreGenerativeAITechniques/examples/src/main/java/com/example/genai/techniques/responsibleai/ResponsibleAIDemo.java`

### Other components

- **Learner**

## Connections

- Learner → GenAI Foundations: starts course (evidence: `README.md`)
- Learner → Environment Setup: continues to (evidence: `README.md`)
- Learner → Core Techniques: continues to (evidence: `README.md`)
- Learner → Project Samples: explores (evidence: `README.md`)
- Learner → Responsible AI: finishes with (evidence: `README.md`)
- Environment Setup → Azure Provisioning: covers (evidence: `README.md`)
- Environment Setup → Spring AI Chat: includes (evidence: `README.md`)
- Core Techniques → Prompting & Completions: demonstrates (evidence: `README.md`)
- Core Techniques → Embeddings & Search: covers (evidence: `README.md`)
- Core Techniques → RAG: demonstrates (evidence: `README.md`)
- Core Techniques → Function Calling: demonstrates (evidence: `README.md`)
- Project Samples → Pet Story Generator: includes (evidence: `README.md`)
- Project Samples → Foundry Local: includes (evidence: `README.md`)
- Project Samples → MCP Calculator: includes (evidence: `README.md`)
- Foundry Local → Local Model Runtime: starts runtime
- Responsible AI → Safety Demo: features demo (evidence: `README.md`)
