# pankajtales/gen-ai-beginner-projects architecture

> Architecture diagram of the GitHub repository pankajtales/gen-ai-beginner-projects, 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/pankajtales/gen-ai-beginner-projects
- Repository: https://github.com/pankajtales/gen-ai-beginner-projects

## Overview

This repository is a collection of independent beginner GenAI command-line experiments, not one integrated application. Their common user-to-result pattern is to provide text or parameters, send a prompt to Gemini, and display generated content; the similarity checker adds embedding-based retrieval through ChromaDB. The README also advertises broader learning topics, but those are not all implemented in the sampled runtime code. Edges for the sampled projects follow visible calls; unsampled project internals are represented without guessed connections.

Main entry points: [`ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py`](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py) (Text similarity), [`ai-email-writer-gemini-python/ai-email-writer.py`](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-email-writer-gemini-python/ai-email-writer.py) (Email writer), [`ai-story-generator-gemini-python/ai-story-generator.py`](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-story-generator-gemini-python/ai-story-generator.py) (Story generator), [`ai-text-summarizer-gemini-python/ai-text-summarizer.py`](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-text-summarizer-gemini-python/ai-text-summarizer.py) (Text summarizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_writing["Writing tools"]
  node_email["Email writer<br/>[ai-email-writer.py]"]
  node_story["Story generator"]
end

subgraph group_analysis["Text analysis"]
  node_summarizer["Text summarizer"]
  node_meeting["Meeting notes"]
  node_resume["Resume analyzer"]
  node_code["Code explainer"]
  node_similarity["Text similarity"]
end

subgraph group_learning["Learning tools"]
  node_study["Study buddy<br/>[ai-study-buddy.py]"]
end

subgraph group_experiments["Prompt experiments"]
  node_playground["Prompt playground"]
end

node_user(("CLI user"))
node_gemini{{"Google Gemini"}}
node_chroma[("ChromaDB collection")]

node_user -->|"provides details"| node_email
node_user -->|"provides details"| node_story
node_user -->|"runs project"| node_summarizer
node_user -->|"runs project"| node_meeting
node_user -->|"runs project"| node_resume
node_user -->|"runs project"| node_code
node_user -->|"enters query"| node_similarity
node_user -->|"provides topic"| node_study
node_user -->|"chooses mode"| node_playground
node_meeting -->|"requests notes"| node_gemini
node_summarizer -->|"requests summaries"| node_gemini
node_email -->|"generates email"| node_gemini
node_resume -->|"requests analysis"| node_gemini
node_code -->|"requests explanation"| node_gemini
node_study -->|"requests teaching"| node_gemini
node_playground -->|"generates output"| node_gemini
node_story -->|"generates story"| node_gemini
node_similarity -->|"gets embeddings"| node_gemini
node_similarity -->|"stores and queries"| node_chroma

click node_email "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-email-writer-gemini-python/ai-email-writer.py"
click node_story "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-story-generator-gemini-python/ai-story-generator.py"
click node_summarizer "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-text-summarizer-gemini-python/ai-text-summarizer.py"
click node_meeting "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-meeting-notes-generator-gemini-python/ai-meeting-notes-generator.py"
click node_resume "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-resume-analyzer-gemini-python/ai-resume-analyzer.py"
click node_code "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-code-explainer-gemini-python/ai-code-explainer.py"
click node_similarity "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py"
click node_study "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-study-buddy-gemini-python/ai-study-buddy.py"
click node_playground "https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-prompt-playground-gemini-python/ai-prompt-playground.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_email,node_story,node_user toneBlue
class node_summarizer,node_meeting,node_resume,node_code,node_similarity,node_chroma toneAmber
class node_study toneMint
class node_playground toneRose
class node_gemini toneIndigo
```

## Components

### Writing tools

- [Email writer](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-email-writer-gemini-python/ai-email-writer.py): `ai-email-writer-gemini-python/ai-email-writer.py`
- [Story generator](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-story-generator-gemini-python/ai-story-generator.py): `ai-story-generator-gemini-python/ai-story-generator.py`

### Text analysis

- [Text summarizer](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-text-summarizer-gemini-python/ai-text-summarizer.py): `ai-text-summarizer-gemini-python/ai-text-summarizer.py`
- [Meeting notes](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-meeting-notes-generator-gemini-python/ai-meeting-notes-generator.py): `ai-meeting-notes-generator-gemini-python/ai-meeting-notes-generator.py`
- [Resume analyzer](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-resume-analyzer-gemini-python/ai-resume-analyzer.py): `ai-resume-analyzer-gemini-python/ai-resume-analyzer.py`
- [Code explainer](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-code-explainer-gemini-python/ai-code-explainer.py): `ai-code-explainer-gemini-python/ai-code-explainer.py`
- [Text similarity](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py): `ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py`

### Learning tools

- [Study buddy](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-study-buddy-gemini-python/ai-study-buddy.py): `ai-study-buddy-gemini-python/ai-study-buddy.py`

### Prompt experiments

- [Prompt playground](https://github.com/pankajtales/gen-ai-beginner-projects/blob/main/ai-prompt-playground-gemini-python/ai-prompt-playground.py): `ai-prompt-playground-gemini-python/ai-prompt-playground.py`

### Other components

- **CLI user**
- **Google Gemini**
- **ChromaDB collection**

## Connections

- CLI user → Email writer: provides details (evidence: `README.md`)
- CLI user → Story generator: provides details (evidence: `README.md`)
- CLI user → Text summarizer: runs project (evidence: `README.md`)
- CLI user → Meeting notes: runs project (evidence: `README.md`)
- CLI user → Resume analyzer: runs project (evidence: `README.md`)
- CLI user → Code explainer: runs project (evidence: `README.md`)
- CLI user → Text similarity: enters query (evidence: `ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py`)
- CLI user → Study buddy: provides topic (evidence: `README.md`)
- CLI user → Prompt playground: chooses mode (evidence: `README.md`)
- Meeting notes → Google Gemini: requests notes (evidence: `ai-meeting-notes-generator-gemini-python/ai-meeting-notes-generator.py`)
- Text summarizer → Google Gemini: requests summaries (evidence: `ai-text-summarizer-gemini-python/ai-text-summarizer.py`)
- Email writer → Google Gemini: generates email (evidence: `ai-email-writer-gemini-python/ai-email-writer.py`)
- Resume analyzer → Google Gemini: requests analysis (evidence: `ai-resume-analyzer-gemini-python/ai-resume-analyzer.py`)
- Code explainer → Google Gemini: requests explanation (evidence: `ai-code-explainer-gemini-python/ai-code-explainer.py`)
- Study buddy → Google Gemini: requests teaching (evidence: `ai-study-buddy-gemini-python/ai-study-buddy.py`)
- Prompt playground → Google Gemini: generates output (evidence: `ai-prompt-playground-gemini-python/ai-prompt-playground.py`)
- Story generator → Google Gemini: generates story (evidence: `ai-story-generator-gemini-python/ai-story-generator.py`)
- Text similarity → Google Gemini: gets embeddings (evidence: `ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py`)
- Text similarity → ChromaDB collection: stores and queries (evidence: `ai-text-similarity-checker-gemini-python/ai-text-similarity-checker.py`)
