# kalyanasundaramr/assignments architecture

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

- Interactive diagram: https://gitdiagram.com/kalyanasundaramr/assignments
- Repository: https://github.com/kalyanasundaramr/assignments

## Overview

This repository is a learning portfolio of independent AI-program assignments, not one integrated application. Its workflows range from interactive calculators and grade tools to browser/desktop automation and a local language-model chat. The clearest end-to-end flows are the WhatsApp contact/report bot and the desktop weather report. The README describes broader program topics, but does not document additional implemented subsystems; several small exercises are included as standalone components. Edges are limited to actions visible in excerpts; unsampled exercises are shown without inferred connections.

Main entry points: [`Week1/Day3/playwright/playwright_whatsapp_bot.py`](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_whatsapp_bot.py) (WhatsApp Contact Bot), [`Week1/Day3/pyautogui/daily_report_bot.py`](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/daily_report_bot.py) (Daily Weather Report), [`Week1/Day5/HuggingFace/opensource_huggingface.py`](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day5/HuggingFace/opensource_huggingface.py) (Local Model Chat), [`Week1/Day2/calculator.py`](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day2/calculator.py) (CLI Calculator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_basics["CLI Exercises"]
  node_cli_calc["CLI Calculator<br/>[calculator.py]"]
  node_cli_grade["CLI Grade System<br/>[grade_system.py]"]
end

subgraph group_automation["Automation Exercises"]
  node_playwright_basic["Playwright Basics"]
  node_playwright_demo["Weather Browser Demo"]
  node_whatsapp_bot["WhatsApp Contact Bot"]
  node_contacts["Contact Workbook<br/>[contacts.xlsx]"]
  node_wa_reports["WhatsApp Reports"]
  node_pyautogui_basics["PyAutoGUI Basics<br/>[basic_pyautogui.py]"]
  node_keyboard_ops["Keyboard Operations"]
  node_mouse_ops["Mouse Operations"]
  node_weather_demo["Desktop Weather Demo<br/>[final_demo.py]"]
  node_daily_bot["Daily Weather Report"]
  node_daily_output["Daily Report Output"]
end

subgraph group_apps["Web Apps"]
  node_api_greeting["Greeting API<br/>[main.py]"]
  node_api_calculator["Calculator API<br/>[calculator.py]"]
  node_streamlit_intro["User Info App<br/>[firstapp.py]"]
  node_streamlit_grades["Grade Calculator App<br/>[grade_system.py]"]
end

subgraph group_ai["Generative AI"]
  node_huggingface_chat["Local Model Chat"]
end

node_learner(("Learner"))
node_whatsapp_web["WhatsApp Web"]
node_weather_service["Weather Site"]
node_local_model["Local Model Files"]

node_learner -->|"enters operands"| node_cli_calc
node_learner -->|"enters mark"| node_cli_grade
node_learner -->|"starts bot"| node_whatsapp_bot
node_whatsapp_bot -->|"reads contacts"| node_contacts
node_whatsapp_bot -->|"drives browser"| node_whatsapp_web
node_whatsapp_bot -->|"writes reports"| node_wa_reports
node_learner -->|"starts report"| node_daily_bot
node_daily_bot -->|"opens weather"| node_weather_service
node_daily_bot -->|"saves report"| node_daily_output
node_learner -->|"requests greeting"| node_api_greeting
node_learner -->|"requests calculation"| node_api_calculator
node_learner -->|"provides details"| node_streamlit_intro
node_learner -->|"submits mark"| node_streamlit_grades
node_learner -->|"enters prompt"| node_huggingface_chat
node_huggingface_chat -->|"loads model"| node_local_model

click node_cli_calc "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day2/calculator.py"
click node_cli_grade "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day2/grade-system/grade_system.py"
click node_playwright_basic "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_basic.py"
click node_playwright_demo "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_final_demo.py"
click node_whatsapp_bot "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_whatsapp_bot.py"
click node_contacts "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/contacts.xlsx"
click node_wa_reports "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_whatsapp_bot.py"
click node_pyautogui_basics "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/basic_pyautogui.py"
click node_keyboard_ops "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/pyautogui_keyboard_operation.py"
click node_mouse_ops "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/pyautogui_mouse_operation.py"
click node_weather_demo "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/final_demo.py"
click node_daily_bot "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/daily_report_bot.py"
click node_daily_output "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/daily_report_bot.py"
click node_api_greeting "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/fastapi/main.py"
click node_api_calculator "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/fastapi/calculator.py"
click node_streamlit_intro "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/streamlit/firstapp.py"
click node_streamlit_grades "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/streamlit/grade_system.py"
click node_huggingface_chat "https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day5/HuggingFace/opensource_huggingface.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_cli_calc,node_cli_grade toneBlue
class node_playwright_basic,node_playwright_demo,node_whatsapp_bot,node_contacts,node_wa_reports,node_pyautogui_basics,node_keyboard_ops,node_mouse_ops,node_weather_demo,node_daily_bot,node_daily_output toneAmber
class node_api_greeting,node_api_calculator,node_streamlit_intro,node_streamlit_grades toneMint
class node_huggingface_chat toneRose
class node_learner,node_whatsapp_web,node_weather_service,node_local_model toneIndigo
```

## Components

### CLI Exercises

- [CLI Calculator](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day2/calculator.py): `Week1/Day2/calculator.py`
- [CLI Grade System](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day2/grade-system/grade_system.py): `Week1/Day2/grade-system/grade_system.py`

### Automation Exercises

- [Playwright Basics](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_basic.py): `Week1/Day3/playwright/playwright_basic.py`
- [Weather Browser Demo](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_final_demo.py): `Week1/Day3/playwright/playwright_final_demo.py`
- [WhatsApp Contact Bot](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_whatsapp_bot.py): `Week1/Day3/playwright/playwright_whatsapp_bot.py`
- [Contact Workbook](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/contacts.xlsx): `Week1/Day3/playwright/contacts.xlsx`
- [WhatsApp Reports](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/playwright/playwright_whatsapp_bot.py): `Week1/Day3/playwright/playwright_whatsapp_bot.py`
- [PyAutoGUI Basics](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/basic_pyautogui.py): `Week1/Day3/pyautogui/basic_pyautogui.py`
- [Keyboard Operations](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/pyautogui_keyboard_operation.py): `Week1/Day3/pyautogui/pyautogui_keyboard_operation.py`
- [Mouse Operations](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/pyautogui_mouse_operation.py): `Week1/Day3/pyautogui/pyautogui_mouse_operation.py`
- [Desktop Weather Demo](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/final_demo.py): `Week1/Day3/pyautogui/final_demo.py`
- [Daily Weather Report](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/daily_report_bot.py): `Week1/Day3/pyautogui/daily_report_bot.py`
- [Daily Report Output](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day3/pyautogui/daily_report_bot.py): `Week1/Day3/pyautogui/daily_report_bot.py`

### Web Apps

- [Greeting API](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/fastapi/main.py): `Week1/Day4/fastapi/main.py`
- [Calculator API](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/fastapi/calculator.py): `Week1/Day4/fastapi/calculator.py`
- [User Info App](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/streamlit/firstapp.py): `Week1/Day4/streamlit/firstapp.py`
- [Grade Calculator App](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day4/streamlit/grade_system.py): `Week1/Day4/streamlit/grade_system.py`

### Generative AI

- [Local Model Chat](https://github.com/kalyanasundaramr/assignments/blob/main/Week1/Day5/HuggingFace/opensource_huggingface.py): `Week1/Day5/HuggingFace/opensource_huggingface.py`

### Other components

- **Learner**
- **WhatsApp Web**
- **Weather Site**
- **Local Model Files**

## Connections

- Learner → CLI Calculator: enters operands (evidence: `Week1/Day2/calculator.py`)
- Learner → CLI Grade System: enters mark (evidence: `Week1/Day2/grade-system/grade_system.py`)
- Learner → WhatsApp Contact Bot: starts bot (evidence: `Week1/Day3/playwright/playwright_whatsapp_bot.py`)
- WhatsApp Contact Bot → Contact Workbook: reads contacts (evidence: `Week1/Day3/playwright/playwright_whatsapp_bot.py`)
- WhatsApp Contact Bot → WhatsApp Web: drives browser (evidence: `Week1/Day3/playwright/playwright_whatsapp_bot.py`)
- WhatsApp Contact Bot → WhatsApp Reports: writes reports (evidence: `Week1/Day3/playwright/playwright_whatsapp_bot.py`)
- Learner → Daily Weather Report: starts report (evidence: `Week1/Day3/pyautogui/daily_report_bot.py`)
- Daily Weather Report → Weather Site: opens weather (evidence: `Week1/Day3/pyautogui/daily_report_bot.py`)
- Daily Weather Report → Daily Report Output: saves report (evidence: `Week1/Day3/pyautogui/daily_report_bot.py`)
- Learner → Greeting API: requests greeting (evidence: `Week1/Day4/fastapi/main.py`)
- Learner → Calculator API: requests calculation (evidence: `Week1/Day4/fastapi/calculator.py`)
- Learner → User Info App: provides details (evidence: `Week1/Day4/streamlit/firstapp.py`)
- Learner → Grade Calculator App: submits mark (evidence: `Week1/Day4/streamlit/grade_system.py`)
- Learner → Local Model Chat: enters prompt (evidence: `Week1/Day5/HuggingFace/opensource_huggingface.py`)
- Local Model Chat → Local Model Files: loads model (evidence: `Week1/Day5/HuggingFace/opensource_huggingface.py`)
