# jeremibartkowiak/jeremios architecture

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

- Interactive diagram: https://gitdiagram.com/jeremibartkowiak/jeremios
- Repository: https://github.com/jeremibartkowiak/jeremios

## Overview

JeremiOS is a Python/Tkinter desktop environment. Users customize the desktop, add icons for programs, and launch them; the environment also provides file management and editing, settings, and a terminal. Its apps directory supplies standalone utilities and games, while the installer packages a copy of the AI assistant. The README describes terminal, reminder, persistence, and launcher capabilities not visible in the sampled excerpts; those are shown as documented features, not as inspected implementations.

Main entry points: [`W10JeremiOS.py`](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py) (Icon Launcher), [`apps/Browser.py`](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Browser.py) (Web Browser), [`apps/bluezip.py`](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/bluezip.py) (BlueZIP Tool), [`apps/AIassistant.py`](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/AIassistant.py) (AI Assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Environment"]
  node_desktop_runtime["Desktop Runtime<br/>[W10JeremiOS.py]"]
  node_desktop_customization["Desktop Customization<br/>[W10JeremiOS.py]"]
  node_icon_launcher["Icon Launcher<br/>[W10JeremiOS.py]"]
  node_settings["Display Settings<br/>[W10JeremiOS.py]"]
  node_persistent_preferences["Persistent Preferences<br/>[W10JeremiOS.py]"]
end

subgraph group_workspace["Workspace Tools"]
  node_file_explorer["File Explorer<br/>[W10JeremiOS.py]"]
  node_text_editor["Text Editor<br/>[W10JeremiOS.py]"]
  node_terminal["Python Terminal<br/>[W10JeremiOS.py]"]
  node_reminders["Reminder System<br/>[W10JeremiOS.py]"]
end

subgraph group_apps["Bundled Applications"]
  node_assistant["AI Assistant<br/>[AIassistant.py]"]
  node_assistant_payload["Packaged Assistant<br/>[AIassistant.py]"]
  node_browser["Web Browser<br/>[Browser.py]"]
  node_calculator["Calculator<br/>[Calculator.py]"]
  node_clock["Clock<br/>[Clock.py]"]
  node_game2048["2048 Game<br/>[2048.py]"]
  node_zip_tool["BlueZIP Tool<br/>[bluezip.py]"]
  node_file_manager["Killexplorer<br/>[Killexplorer.py]"]
end

subgraph group_services["External Services"]
  node_openai{{"OpenAI API"}}
  node_web{{"Web"}}
  node_filesystem[("Local Filesystem")]
end

node_user(("Desktop User"))

node_user -->|"uses"| node_desktop_runtime
node_desktop_runtime -->|"provides"| node_desktop_customization
node_user -->|"customizes"| node_desktop_customization
node_user -->|"launches apps"| node_icon_launcher
node_icon_launcher -->|"launches"| node_assistant
node_icon_launcher -->|"launches"| node_browser
node_icon_launcher -->|"launches"| node_calculator
node_icon_launcher -->|"launches"| node_clock
node_icon_launcher -->|"launches"| node_game2048
node_icon_launcher -->|"launches"| node_zip_tool
node_icon_launcher -->|"launches"| node_file_manager
node_user -->|"configures"| node_settings
node_settings -->|"saves"| node_persistent_preferences
node_user -->|"browses files"| node_file_explorer
node_file_explorer -->|"lists directories"| node_filesystem
node_user -->|"edits files"| node_text_editor
node_text_editor -->|"saves files"| node_filesystem
node_user -->|"runs Python"| node_terminal
node_desktop_runtime -->|"provides reminders"| node_reminders
node_assistant -->|"requests responses"| node_openai
node_user -->|"browses"| node_browser
node_browser -->|"loads pages"| node_web
node_user -->|"archives files"| node_zip_tool
node_zip_tool -->|"reads and writes"| node_filesystem
node_user -->|"manages files"| node_file_manager
node_assistant_payload -->|"requests responses"| node_openai

click node_desktop_runtime "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_desktop_customization "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_icon_launcher "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_settings "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_persistent_preferences "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_file_explorer "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_text_editor "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_terminal "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_reminders "https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py"
click node_assistant "https://github.com/jeremibartkowiak/jeremios/blob/main/apps/AIassistant.py"
click node_assistant_payload "https://github.com/jeremibartkowiak/jeremios/blob/main/installer/installerdata/apps/AIassistant.py"
click node_browser "https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Browser.py"
click node_calculator "https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Calculator.py"
click node_clock "https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Clock.py"
click node_game2048 "https://github.com/jeremibartkowiak/jeremios/blob/main/apps/2048.py"
click node_zip_tool "https://github.com/jeremibartkowiak/jeremios/blob/main/apps/bluezip.py"
click node_file_manager "https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Killexplorer.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_desktop_runtime,node_desktop_customization,node_icon_launcher,node_settings,node_persistent_preferences,node_user toneBlue
class node_file_explorer,node_text_editor,node_terminal,node_reminders toneAmber
class node_assistant,node_assistant_payload,node_browser,node_calculator,node_clock,node_game2048,node_zip_tool,node_file_manager toneMint
class node_openai,node_web,node_filesystem toneRose
```

## Components

### Desktop Environment

- [Desktop Runtime](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`
- [Desktop Customization](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`
- [Icon Launcher](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`
- [Display Settings](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`
- [Persistent Preferences](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`

### Workspace Tools

- [File Explorer](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`
- [Text Editor](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`
- [Python Terminal](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`
- [Reminder System](https://github.com/jeremibartkowiak/jeremios/blob/main/W10JeremiOS.py): `W10JeremiOS.py`

### Bundled Applications

- [AI Assistant](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/AIassistant.py): `apps/AIassistant.py`
- [Packaged Assistant](https://github.com/jeremibartkowiak/jeremios/blob/main/installer/installerdata/apps/AIassistant.py): `installer/installerdata/apps/AIassistant.py`
- [Web Browser](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Browser.py): `apps/Browser.py`
- [Calculator](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Calculator.py): `apps/Calculator.py`
- [Clock](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Clock.py): `apps/Clock.py`
- [2048 Game](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/2048.py): `apps/2048.py`
- [BlueZIP Tool](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/bluezip.py): `apps/bluezip.py`
- [Killexplorer](https://github.com/jeremibartkowiak/jeremios/blob/main/apps/Killexplorer.py): `apps/Killexplorer.py`

### External Services

- **OpenAI API**
- **Web**
- **Local Filesystem**

### Other components

- **Desktop User**

## Connections

- Desktop User → Desktop Runtime: uses (evidence: `README.md`)
- Desktop Runtime → Desktop Customization: provides (evidence: `README.md`)
- Desktop User → Desktop Customization: customizes (evidence: `README.md`)
- Desktop User → Icon Launcher: launches apps (evidence: `README.md`)
- Icon Launcher → AI Assistant: launches (evidence: `README.md`)
- Icon Launcher → Web Browser: launches (evidence: `README.md`)
- Icon Launcher → Calculator: launches (evidence: `README.md`)
- Icon Launcher → Clock: launches (evidence: `README.md`)
- Icon Launcher → 2048 Game: launches (evidence: `README.md`)
- Icon Launcher → BlueZIP Tool: launches (evidence: `README.md`)
- Icon Launcher → Killexplorer: launches (evidence: `README.md`)
- Desktop User → Display Settings: configures (evidence: `README.md`)
- Display Settings → Persistent Preferences: saves (evidence: `W10JeremiOS.py`)
- Desktop User → File Explorer: browses files (evidence: `README.md`)
- File Explorer → Local Filesystem: lists directories (evidence: `W10JeremiOS.py`)
- Desktop User → Text Editor: edits files (evidence: `README.md`)
- Text Editor → Local Filesystem: saves files (evidence: `W10JeremiOS.py`)
- Desktop User → Python Terminal: runs Python (evidence: `README.md`)
- Desktop Runtime → Reminder System: provides reminders (evidence: `README.md`)
- AI Assistant → OpenAI API: requests responses (evidence: `apps/AIassistant.py`)
- Desktop User → Web Browser: browses (evidence: `apps/Browser.py`)
- Web Browser → Web: loads pages (evidence: `apps/Browser.py`)
- Desktop User → BlueZIP Tool: archives files (evidence: `apps/bluezip.py`)
- BlueZIP Tool → Local Filesystem: reads and writes (evidence: `apps/bluezip.py`)
- Desktop User → Killexplorer: manages files (evidence: `README.md`)
- Packaged Assistant → OpenAI API: requests responses (evidence: `installer/installerdata/apps/AIassistant.py`)
