# shrutijagadale0725-rgb/boopya-ai-reminder-app architecture

> Architecture diagram of the GitHub repository shrutijagadale0725-rgb/boopya-ai-reminder-app, 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/shrutijagadale0725-rgb/boopya-ai-reminder-app
- Repository: https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app

## Overview

BoopYA! is a local desktop task-and-reminder app. Users add deadline-based tasks manually or describe them in AI Chat; tasks are saved locally, shown in dashboard and completed views, and checked for reminders. The single 52 KB `main.py` contains the runtime, so the components below share its path. The README documents the main capabilities and integrations; sampled source confirms notification checks and summary logic, but omitted sections prevent tracing every UI-to-storage call.

Main entry points: [`main.py`](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py) (Task storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Tkinter app<br/>[main.py]"]
  node_dashboard["Task dashboard<br/>[main.py]"]
  node_completed["Completed view<br/>[main.py]"]
  node_add_task["Manual entry<br/>[main.py]"]
  node_ai_chat["AI Chat<br/>[main.py]"]
  node_ask["Ask terminal<br/>[main.py]"]
  node_settings["Settings<br/>[main.py]"]
end

subgraph group_tasks["Task workflow"]
  node_task_logic["Task scheduling<br/>[main.py]"]
  node_task_store[("Task storage<br/>[main.py]")]
  node_summary["Task summaries<br/>[main.py]"]
end

subgraph group_reminders["Reminder system"]
  node_reminder_check["Reminder checks<br/>[main.py]"]
  node_notify_state[("Notification state<br/>[main.py]")]
  node_os_notify["OS notifications<br/>[main.py]"]
end

subgraph group_integrations["External services"]
  node_groq["Groq API"]
  node_speech["Google speech API"]
end

node_user(("User"))
node_mic(("Microphone"))

node_user -->|"uses"| node_app
node_app -->|"shows"| node_dashboard
node_app -->|"shows"| node_completed
node_user -->|"enters task"| node_add_task
node_user -->|"describes plans"| node_ai_chat
node_user -->|"queries"| node_ask
node_user -->|"configures"| node_settings
node_add_task -->|"submits task"| node_task_logic
node_ai_chat -->|"schedules tasks"| node_task_logic
node_task_logic -->|"stores tasks"| node_task_store
node_dashboard -->|"shows tasks"| node_task_store
node_completed -->|"shows completed"| node_task_store
node_ask -->|"summarizes tasks"| node_summary
node_summary -.->|"reads tasks"| node_task_store
node_settings -->|"saves preferences"| node_task_store
node_ai_chat -->|"requests extraction"| node_groq
node_mic -->|"sends recording"| node_speech
node_speech -->|"returns transcript"| node_ai_chat
node_app -->|"checks on launch"| node_reminder_check
node_reminder_check -->|"checks tasks"| node_task_store
node_reminder_check -->|"enforces daily cap"| node_notify_state
node_reminder_check -->|"fires alert"| node_os_notify
node_os_notify -->|"notifies"| node_user
node_app -->|"rechecks periodically"| node_reminder_check

click node_app "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_dashboard "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_completed "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_add_task "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_ai_chat "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_ask "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_settings "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_task_logic "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_task_store "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_summary "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_reminder_check "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_notify_state "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py"
click node_os_notify "https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.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_app,node_dashboard,node_completed,node_add_task,node_ai_chat,node_ask,node_settings,node_user toneBlue
class node_task_logic,node_task_store,node_summary toneAmber
class node_reminder_check,node_notify_state,node_os_notify toneMint
class node_groq,node_speech toneRose
class node_mic toneIndigo
```

## Components

### Desktop interface

- [Tkinter app](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Task dashboard](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Completed view](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Manual entry](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [AI Chat](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Ask terminal](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Settings](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`

### Task workflow

- [Task scheduling](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Task storage](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Task summaries](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`

### Reminder system

- [Reminder checks](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [Notification state](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`
- [OS notifications](https://github.com/shrutijagadale0725-rgb/boopya-ai-reminder-app/blob/main/main.py): `main.py`

### External services

- **Groq API**
- **Google speech API**

### Other components

- **User**
- **Microphone**

## Connections

- User → Tkinter app: uses (evidence: `README.md`)
- Tkinter app → Task dashboard: shows (evidence: `README.md`)
- Tkinter app → Completed view: shows (evidence: `README.md`)
- User → Manual entry: enters task (evidence: `README.md`)
- User → AI Chat: describes plans (evidence: `README.md`)
- User → Ask terminal: queries (evidence: `README.md`)
- User → Settings: configures (evidence: `README.md`)
- Manual entry → Task scheduling: submits task (evidence: `README.md`)
- AI Chat → Task scheduling: schedules tasks (evidence: `README.md`)
- Task scheduling → Task storage: stores tasks (evidence: `README.md`)
- Task dashboard → Task storage: shows tasks (evidence: `README.md`)
- Completed view → Task storage: shows completed (evidence: `README.md`)
- Ask terminal → Task summaries: summarizes tasks (evidence: `README.md`)
- Task summaries → Task storage: reads tasks (evidence: `main.py`)
- Settings → Task storage: saves preferences (evidence: `README.md`)
- AI Chat → Groq API: requests extraction (evidence: `README.md`)
- Microphone → Google speech API: sends recording (evidence: `README.md`)
- Google speech API → AI Chat: returns transcript (evidence: `README.md`)
- Tkinter app → Reminder checks: checks on launch (evidence: `main.py`)
- Reminder checks → Task storage: checks tasks (evidence: `README.md`)
- Reminder checks → Notification state: enforces daily cap (evidence: `main.py`)
- Reminder checks → OS notifications: fires alert (evidence: `main.py`)
- OS notifications → User: notifies (evidence: `README.md`)
- Tkinter app → Reminder checks: rechecks periodically (evidence: `README.md`)
