# yasir2000/awesome-python-automation architecture

> Architecture diagram of the GitHub repository yasir2000/awesome-python-automation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yasir2000/awesome-python-automation
- Repository: https://github.com/yasir2000/awesome-python-automation

## Overview

This repository is a collection of independent Python scripts, not one integrated application. Its workflows range from user-entered conversions to camera-driven controls and scheduled reminders; there is no shared runtime or common pipeline. The graph highlights documented scripts and sampled internal layers. Most scripts are independent, so edges show only relationships supported by the excerpts or README; unsampled implementations are not inferred.

Main entry points: [`Hand Volume/main.py`](https://github.com/yasir2000/awesome-python-automation/blob/main/Hand%20Volume/main.py) (Hand volume control), [`Face Reaction/main.py`](https://github.com/yasir2000/awesome-python-automation/blob/main/Face%20Reaction/main.py) (Face reaction app), [`Image Text/image_processor_factory.py`](https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/image_processor_factory.py) (Processor factory), [`Json to CSV Convertor/main.py`](https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/main.py) (JSON-to-CSV entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interactive["Interactive tools"]
  node_currency_cli["Currency CLI<br/>[main.py]"]
  node_currency_converter["Currency converter<br/>[converter.py]"]
  node_currency_rates["Rate provider and adapter<br/>[currency.py]"]
  node_weather_entry["Weather app entry<br/>[main.py]"]
  node_weather_ui["Weather UI<br/>[ui.py]"]
  node_weather_service["Weather service<br/>[weather_service.py]"]
end

subgraph group_media["Media and vision"]
  node_hand_main["Hand volume control<br/>[main.py]"]
  node_hand_detector["Hand detector"]
  node_audio_control["Audio controller<br/>[interface.py]"]
  node_face_main["Face reaction app<br/>[main.py]"]
  node_emotion_detector["Emotion detector"]
  node_emotion_manager["Emotion display<br/>[emotion_manager.py]"]
  node_image_text_main["Image text entry<br/>[main.py]"]
  node_image_factory["Processor factory"]
  node_image_processor["Image processor<br/>[image_processor.py]"]
  node_image_config["Image configuration<br/>[config.py]"]
end

subgraph group_data["Data utilities"]
  node_json_main["JSON-to-CSV entry<br/>[main.py]"]
  node_json_converter["JSON-to-CSV converter"]
  node_json_settings["Conversion settings<br/>[settings.py]"]
  node_json_flattener["JSON flattener<br/>[json_flattener.py]"]
end

subgraph group_automation["Automation"]
  node_umbrella_scheduler["Reminder scheduler<br/>[main.py]"]
  node_umbrella_reminder["Umbrella reminder"]
  node_email_scripts["Email scripts<br/>[main.py]"]
  node_birthday_email["Birthday email script"]
  node_file_arranger["File arranger<br/>[arrangeit.py]"]
  node_duplicate_finder["Duplicate finder"]
end

node_user(("User"))
node_weather_api["Weather API"]

node_user -->|"enters amounts"| node_currency_cli
node_currency_cli -->|"calls convert"| node_currency_converter
node_currency_converter -->|"delegates conversion"| node_currency_rates
node_user -->|"opens app"| node_weather_entry
node_weather_entry -->|"creates UI"| node_weather_ui
node_weather_ui -->|"requests weather"| node_weather_service
node_weather_service -->|"fetches data"| node_weather_api
node_user -->|"uses camera control"| node_hand_main
node_hand_main -->|"tracks hands"| node_hand_detector
node_hand_main -->|"sets volume"| node_audio_control
node_user -->|"runs camera app"| node_face_main
node_face_main -->|"detects emotion"| node_emotion_detector
node_face_main -->|"gets emoji"| node_emotion_manager
node_user -->|"provides image"| node_image_text_main
node_image_text_main -->|"creates processor"| node_image_factory
node_image_factory -->|"reads configuration"| node_image_config
node_image_factory -->|"constructs processor"| node_image_processor
node_user -->|"starts conversion"| node_json_main
node_json_main -->|"runs conversion"| node_json_converter
node_json_main -->|"reads settings"| node_json_settings
node_json_converter -->|"uses flattener"| node_json_flattener
node_umbrella_scheduler -->|"schedules reminder"| node_umbrella_reminder

click node_currency_cli "https://github.com/yasir2000/awesome-python-automation/blob/main/Currency%20Script/main.py"
click node_currency_converter "https://github.com/yasir2000/awesome-python-automation/blob/main/Currency%20Script/converter.py"
click node_currency_rates "https://github.com/yasir2000/awesome-python-automation/blob/main/Currency%20Script/currency.py"
click node_weather_entry "https://github.com/yasir2000/awesome-python-automation/blob/main/Weather%20GUI/main.py"
click node_weather_ui "https://github.com/yasir2000/awesome-python-automation/blob/main/Weather%20GUI/ui.py"
click node_weather_service "https://github.com/yasir2000/awesome-python-automation/blob/main/Weather%20GUI/weather_service.py"
click node_hand_main "https://github.com/yasir2000/awesome-python-automation/blob/main/Hand%20Volume/main.py"
click node_hand_detector "https://github.com/yasir2000/awesome-python-automation/blob/main/Hand%20Volume/handTrackingModule.py"
click node_audio_control "https://github.com/yasir2000/awesome-python-automation/blob/main/Hand%20Volume/interface.py"
click node_face_main "https://github.com/yasir2000/awesome-python-automation/blob/main/Face%20Reaction/main.py"
click node_emotion_detector "https://github.com/yasir2000/awesome-python-automation/blob/main/Face%20Reaction/emotion_detector.py"
click node_emotion_manager "https://github.com/yasir2000/awesome-python-automation/blob/main/Face%20Reaction/emotion_manager.py"
click node_image_text_main "https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/main.py"
click node_image_factory "https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/image_processor_factory.py"
click node_image_processor "https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/image_processor.py"
click node_image_config "https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/config.py"
click node_json_main "https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/main.py"
click node_json_converter "https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/converter/json_to_csv_converter.py"
click node_json_settings "https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/converter/settings.py"
click node_json_flattener "https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/converter/json_flattener.py"
click node_umbrella_scheduler "https://github.com/yasir2000/awesome-python-automation/blob/main/Umbrella%20Reminder/main.py"
click node_umbrella_reminder "https://github.com/yasir2000/awesome-python-automation/blob/main/Umbrella%20Reminder/umbrellaReminder.py"
click node_email_scripts "https://github.com/yasir2000/awesome-python-automation/blob/main/Automate%20Emails%20Daily/main.py"
click node_birthday_email "https://github.com/yasir2000/awesome-python-automation/blob/main/Automating%20Emails/Birthday-Manager.py"
click node_file_arranger "https://github.com/yasir2000/awesome-python-automation/blob/main/Arrange%20It/arrangeit.py"
click node_duplicate_finder "https://github.com/yasir2000/awesome-python-automation/blob/main/Duplicate%20Finder/duplicate-finder.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_currency_cli,node_currency_converter,node_currency_rates,node_weather_entry,node_weather_ui,node_weather_service,node_user toneBlue
class node_hand_main,node_hand_detector,node_audio_control,node_face_main,node_emotion_detector,node_emotion_manager,node_image_text_main,node_image_factory,node_image_processor,node_image_config toneAmber
class node_json_main,node_json_converter,node_json_settings,node_json_flattener,node_weather_api toneMint
class node_umbrella_scheduler,node_umbrella_reminder,node_email_scripts,node_birthday_email,node_file_arranger,node_duplicate_finder toneRose
```

## Components

### Interactive tools

- [Currency CLI](https://github.com/yasir2000/awesome-python-automation/blob/main/Currency%20Script/main.py): `Currency Script/main.py`
- [Currency converter](https://github.com/yasir2000/awesome-python-automation/blob/main/Currency%20Script/converter.py): `Currency Script/converter.py`
- [Rate provider and adapter](https://github.com/yasir2000/awesome-python-automation/blob/main/Currency%20Script/currency.py): `Currency Script/currency.py`
- [Weather app entry](https://github.com/yasir2000/awesome-python-automation/blob/main/Weather%20GUI/main.py): `Weather GUI/main.py`
- [Weather UI](https://github.com/yasir2000/awesome-python-automation/blob/main/Weather%20GUI/ui.py): `Weather GUI/ui.py`
- [Weather service](https://github.com/yasir2000/awesome-python-automation/blob/main/Weather%20GUI/weather_service.py): `Weather GUI/weather_service.py`

### Media and vision

- [Hand volume control](https://github.com/yasir2000/awesome-python-automation/blob/main/Hand%20Volume/main.py): `Hand Volume/main.py`
- [Hand detector](https://github.com/yasir2000/awesome-python-automation/blob/main/Hand%20Volume/handTrackingModule.py): `Hand Volume/handTrackingModule.py`
- [Audio controller](https://github.com/yasir2000/awesome-python-automation/blob/main/Hand%20Volume/interface.py): `Hand Volume/interface.py`
- [Face reaction app](https://github.com/yasir2000/awesome-python-automation/blob/main/Face%20Reaction/main.py): `Face Reaction/main.py`
- [Emotion detector](https://github.com/yasir2000/awesome-python-automation/blob/main/Face%20Reaction/emotion_detector.py): `Face Reaction/emotion_detector.py`
- [Emotion display](https://github.com/yasir2000/awesome-python-automation/blob/main/Face%20Reaction/emotion_manager.py): `Face Reaction/emotion_manager.py`
- [Image text entry](https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/main.py): `Image Text/main.py`
- [Processor factory](https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/image_processor_factory.py): `Image Text/image_processor_factory.py`
- [Image processor](https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/image_processor.py): `Image Text/image_processor.py`
- [Image configuration](https://github.com/yasir2000/awesome-python-automation/blob/main/Image%20Text/config.py): `Image Text/config.py`

### Data utilities

- [JSON-to-CSV entry](https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/main.py): `Json to CSV Convertor/main.py`
- [JSON-to-CSV converter](https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/converter/json_to_csv_converter.py): `Json to CSV Convertor/converter/json_to_csv_converter.py`
- [Conversion settings](https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/converter/settings.py): `Json to CSV Convertor/converter/settings.py`
- [JSON flattener](https://github.com/yasir2000/awesome-python-automation/blob/main/Json%20to%20CSV%20Convertor/converter/json_flattener.py): `Json to CSV Convertor/converter/json_flattener.py`

### Automation

- [Reminder scheduler](https://github.com/yasir2000/awesome-python-automation/blob/main/Umbrella%20Reminder/main.py): `Umbrella Reminder/main.py`
- [Umbrella reminder](https://github.com/yasir2000/awesome-python-automation/blob/main/Umbrella%20Reminder/umbrellaReminder.py): `Umbrella Reminder/umbrellaReminder.py`
- [Email scripts](https://github.com/yasir2000/awesome-python-automation/blob/main/Automate%20Emails%20Daily/main.py): `Automate Emails Daily/main.py`
- [Birthday email script](https://github.com/yasir2000/awesome-python-automation/blob/main/Automating%20Emails/Birthday-Manager.py): `Automating Emails/Birthday-Manager.py`
- [File arranger](https://github.com/yasir2000/awesome-python-automation/blob/main/Arrange%20It/arrangeit.py): `Arrange It/arrangeit.py`
- [Duplicate finder](https://github.com/yasir2000/awesome-python-automation/blob/main/Duplicate%20Finder/duplicate-finder.py): `Duplicate Finder/duplicate-finder.py`

### Other components

- **User**
- **Weather API**

## Connections

- User → Currency CLI: enters amounts (evidence: `Currency Script/main.py`)
- Currency CLI → Currency converter: calls convert (evidence: `Currency Script/main.py`)
- Currency converter → Rate provider and adapter: delegates conversion (evidence: `Currency Script/converter.py`)
- User → Weather app entry: opens app (evidence: `Weather GUI/main.py`)
- Weather app entry → Weather UI: creates UI (evidence: `Weather GUI/main.py`)
- Weather UI → Weather service: requests weather (evidence: `Weather GUI/ui.py`)
- Weather service → Weather API: fetches data (evidence: `Weather GUI/weather_service.py`)
- User → Hand volume control: uses camera control
- Hand volume control → Hand detector: tracks hands (evidence: `Hand Volume/main.py`)
- Hand volume control → Audio controller: sets volume (evidence: `Hand Volume/main.py`)
- User → Face reaction app: runs camera app (evidence: `Face Reaction/main.py`)
- Face reaction app → Emotion detector: detects emotion (evidence: `Face Reaction/main.py`)
- Face reaction app → Emotion display: gets emoji (evidence: `Face Reaction/main.py`)
- User → Image text entry: provides image (evidence: `Image Text/main.py`)
- Image text entry → Processor factory: creates processor (evidence: `Image Text/main.py`)
- Processor factory → Image configuration: reads configuration (evidence: `Image Text/image_processor_factory.py`)
- Processor factory → Image processor: constructs processor (evidence: `Image Text/image_processor_factory.py`)
- User → JSON-to-CSV entry: starts conversion (evidence: `Json to CSV Convertor/main.py`)
- JSON-to-CSV entry → JSON-to-CSV converter: runs conversion (evidence: `Json to CSV Convertor/main.py`)
- JSON-to-CSV entry → Conversion settings: reads settings (evidence: `Json to CSV Convertor/main.py`)
- JSON-to-CSV converter → JSON flattener: uses flattener (evidence: `Json to CSV Convertor/converter/json_to_csv_converter.py`)
- Reminder scheduler → Umbrella reminder: schedules reminder (evidence: `Umbrella Reminder/main.py`)
