# jaishaktiphilips/generative-ai-for-beginners architecture

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

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

## Overview

This repository is an educational course, not one integrated application. Its user workflow is to choose a lesson, learn a generative-AI concept, then explore or run a Python/TypeScript sample against a model provider. The graph preserves the main build topics visible in the tree and samples. Edges between lesson content and providers are documented at course level; transcript-processing scripts are shown as capabilities, not an assumed pipeline. Shared Python utilities are included, but sampled lesson files do not demonstrate using them.

Main entry points: [`11-integrating-with-function-calling/typescript/function-app/src/main.ts`](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/11-integrating-with-function-calling/typescript/function-app/src/main.ts) (Weather lookup), [`05-advanced-prompts`](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/05-advanced-prompts) (Prompt techniques), [`07-building-chat-applications`](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/07-building-chat-applications) (Chat apps), [`09-building-image-applications`](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/09-building-image-applications) (Image generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course lessons"]
  node_advanced["Prompt techniques"]
end

subgraph group_generation["Generation apps"]
  node_textgen["Text generation"]
  node_recipe["Recipe app<br/>[main.ts]"]
  node_chat["Chat apps"]
  node_images["Image generation"]
end

subgraph group_search["Search apps"]
  node_search["Search applications"]
  node_embeddings["Embedding comparison<br/>[main.ts]"]
  node_transcripts["Transcript enrichment"]
end

subgraph group_integrations["Model integrations"]
  node_functions["Function calling"]
  node_flighttools["Flight and hotel tools<br/>[app.js]"]
  node_weathertool["Weather lookup<br/>[main.ts]"]
end

subgraph group_shared["Shared Python utilities"]
  node_validation["Input validation"]
  node_environment["Environment config<br/>[env_utils.py]"]
  node_apiutils["API helpers<br/>[api_utils.py]"]
end

node_learner(("Learner"))
node_modelprovider{{"Model provider"}}
node_bingmaps{{"Bing Maps API"}}

node_learner -->|"chooses lesson"| node_advanced
node_learner -->|"chooses lesson"| node_textgen
node_learner -->|"chooses lesson"| node_chat
node_learner -->|"chooses lesson"| node_search
node_learner -->|"chooses lesson"| node_images
node_learner -->|"chooses lesson"| node_functions
node_recipe -->|"requests completions"| node_modelprovider
node_embeddings -->|"requests embeddings"| node_modelprovider
node_flighttools -->|"requests tool calls"| node_modelprovider
node_weathertool -->|"requests function call"| node_modelprovider
node_weathertool -->|"fetches weather data"| node_bingmaps
node_advanced -.->|"samples provider use"| node_modelprovider
node_chat -.->|"samples provider use"| node_modelprovider
node_images -.->|"samples provider use"| node_modelprovider

click node_advanced "https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/05-advanced-prompts"
click node_textgen "https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/06-text-generation-apps"
click node_recipe "https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/06-text-generation-apps/typescript/recipe-app/src/main.ts"
click node_chat "https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/07-building-chat-applications"
click node_search "https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/08-building-search-applications"
click node_embeddings "https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/08-building-search-applications/typescript/search-app/src/main.ts"
click node_transcripts "https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/08-building-search-applications/scripts"
click node_images "https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/09-building-image-applications"
click node_functions "https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/11-integrating-with-function-calling"
click node_flighttools "https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/11-integrating-with-function-calling/js-githubmodels/app.js"
click node_weathertool "https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/11-integrating-with-function-calling/typescript/function-app/src/main.ts"
click node_validation "https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/shared/python/input_validation.py"
click node_environment "https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/shared/python/env_utils.py"
click node_apiutils "https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/shared/python/api_utils.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_advanced toneBlue
class node_textgen,node_recipe,node_chat,node_images toneAmber
class node_search,node_embeddings,node_transcripts,node_bingmaps toneMint
class node_functions,node_flighttools,node_weathertool toneRose
class node_validation,node_environment,node_apiutils,node_learner,node_modelprovider toneIndigo
```

## Components

### Course lessons

- [Prompt techniques](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/05-advanced-prompts): `05-advanced-prompts`

### Generation apps

- [Text generation](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/06-text-generation-apps): `06-text-generation-apps`
- [Recipe app](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/06-text-generation-apps/typescript/recipe-app/src/main.ts): `06-text-generation-apps/typescript/recipe-app/src/main.ts`
- [Chat apps](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/07-building-chat-applications): `07-building-chat-applications`
- [Image generation](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/09-building-image-applications): `09-building-image-applications`

### Search apps

- [Search applications](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/08-building-search-applications): `08-building-search-applications`
- [Embedding comparison](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/08-building-search-applications/typescript/search-app/src/main.ts): `08-building-search-applications/typescript/search-app/src/main.ts`
- [Transcript enrichment](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/08-building-search-applications/scripts): `08-building-search-applications/scripts`

### Model integrations

- [Function calling](https://github.com/jaishaktiphilips/generative-ai-for-beginners/tree/main/11-integrating-with-function-calling): `11-integrating-with-function-calling`
- [Flight and hotel tools](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/11-integrating-with-function-calling/js-githubmodels/app.js): `11-integrating-with-function-calling/js-githubmodels/app.js`
- [Weather lookup](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/11-integrating-with-function-calling/typescript/function-app/src/main.ts): `11-integrating-with-function-calling/typescript/function-app/src/main.ts`

### Shared Python utilities

- [Input validation](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/shared/python/input_validation.py): `shared/python/input_validation.py`
- [Environment config](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/shared/python/env_utils.py): `shared/python/env_utils.py`
- [API helpers](https://github.com/jaishaktiphilips/generative-ai-for-beginners/blob/main/shared/python/api_utils.py): `shared/python/api_utils.py`

### Other components

- **Learner**
- **Model provider**
- **Bing Maps API**

## Connections

- Learner → Prompt techniques: chooses lesson (evidence: `README.md`)
- Learner → Text generation: chooses lesson (evidence: `README.md`)
- Learner → Chat apps: chooses lesson (evidence: `README.md`)
- Learner → Search applications: chooses lesson (evidence: `README.md`)
- Learner → Image generation: chooses lesson (evidence: `README.md`)
- Learner → Function calling: chooses lesson (evidence: `README.md`)
- Recipe app → Model provider: requests completions (evidence: `06-text-generation-apps/typescript/recipe-app/src/main.ts`)
- Embedding comparison → Model provider: requests embeddings (evidence: `08-building-search-applications/typescript/search-app/src/main.ts`)
- Flight and hotel tools → Model provider: requests tool calls (evidence: `11-integrating-with-function-calling/js-githubmodels/app.js`)
- Weather lookup → Model provider: requests function call (evidence: `11-integrating-with-function-calling/typescript/function-app/src/main.ts`)
- Weather lookup → Bing Maps API: fetches weather data (evidence: `11-integrating-with-function-calling/typescript/function-app/src/main.ts`)
- Prompt techniques → Model provider: samples provider use (evidence: `README.md`)
- Chat apps → Model provider: samples provider use (evidence: `README.md`)
- Image generation → Model provider: samples provider use (evidence: `README.md`)
