# eternityradiance/graphutils architecture

> Architecture diagram of the GitHub repository eternityradiance/graphutils, 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/eternityradiance/graphutils
- Repository: https://github.com/eternityradiance/graphutils

## Overview

This repository provides graph search/download and graph visualization as Tkinter desktop applications, including a combined tabbed app and standalone search/viewer variants. The principal workflow is to enter graph criteria, search remote metadata, inspect matching graphs, and download selections; the viewer separately loads graph files for exploration and rendering. Source excerpts support the main application wiring and service responsibilities, but several visualization and search internals are unsampled, so uncertain links are omitted.

Main entry points: [`GraphSearch/app/GraphFrontend.py`](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/GraphFrontend.py) (Search interface), [`GraphSearch/app/GraphService.py`](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/GraphService.py) (Search and download service), [`GraphCombined/app/CombinedFrontend.py`](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/CombinedFrontend.py) (Tabbed application), [`GraphSearch/main.py`](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/main.py) (Search entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Search and downloads"]
  node_search_main["Search entry point<br/>[main.py]"]
  node_search_ui["Search interface<br/>[GraphFrontend.py]"]
  node_search_console["Search console<br/>[ConsoleWidget.py]"]
  node_search_service["Search and download service<br/>[GraphService.py]"]
end

subgraph group_combined["Combined application"]
  node_combined_main["Combined entry point<br/>[main.py]"]
  node_combined_app["Tabbed application"]
  node_combined_console["Combined console<br/>[ConsoleWidget.py]"]
end

subgraph group_visualization["Graph visualization"]
  node_combined_viewer["Combined graph viewer"]
  node_combined_explorer["Combined file explorer<br/>[explorer.py]"]
  node_combined_renderer["Combined graph renderer<br/>[graph_drawer.py]"]
  node_viewer_main["Viewer entry point<br/>[main.py]"]
  node_viewer_app["Standalone graph viewer"]
  node_viewer_explorer["Standalone file explorer<br/>[explorer.py]"]
end

subgraph group_models["Types and configuration"]
  node_graph_request["Search request types<br/>[DataTypes.py]"]
  node_search_config["Search configuration<br/>[config.py]"]
  node_search_ui_config["UI configuration<br/>[ui.py]"]
  node_combined_graph_model["Combined graph model<br/>[graph_models.py]"]
  node_combined_types["Combined service types<br/>[DataTypes.py]"]
  node_combined_config["Combined configuration<br/>[config.py]"]
  node_viewer_model["Standalone graph model<br/>[graph_models.py]"]
end

node_user(("Desktop user"))
node_remote_metadata[("Graph metadata service")]
node_remote_graphs[("Graph file repository")]

node_user -->|"uses"| node_combined_app
node_combined_main -->|"starts"| node_combined_app
node_combined_app -->|"embeds"| node_search_ui
node_combined_app -->|"embeds"| node_combined_viewer
node_combined_app -->|"initializes"| node_combined_console
node_user -->|"starts"| node_search_main
node_search_main -->|"starts"| node_search_ui
node_search_main -->|"imports"| node_search_console
node_search_ui -->|"queries"| node_search_service
node_search_ui -->|"uses"| node_search_console
node_search_ui -->|"builds requests"| node_graph_request
node_search_ui -->|"reads settings"| node_search_config
node_search_service -->|"matches types"| node_graph_request
node_search_service -->|"reads endpoints"| node_search_config
node_search_service -->|"fetches metadata"| node_remote_metadata
node_search_service -->|"downloads graphs"| node_remote_graphs
node_search_config -->|"loads UI settings"| node_search_ui_config
node_combined_viewer -->|"loads graph files"| node_combined_explorer
node_combined_explorer -->|"uses model"| node_combined_graph_model
node_combined_renderer -->|"uses model"| node_combined_graph_model
node_combined_config -.->|"configures service"| node_combined_types
node_user -->|"starts"| node_viewer_main
node_viewer_main -->|"starts"| node_viewer_app
node_viewer_app -->|"loads graph files"| node_viewer_explorer
node_viewer_explorer -->|"uses model"| node_viewer_model

click node_combined_main "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/main.py"
click node_combined_app "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/CombinedFrontend.py"
click node_combined_console "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/ConsoleWidget.py"
click node_search_main "https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/main.py"
click node_search_ui "https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/GraphFrontend.py"
click node_search_console "https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/ConsoleWidget.py"
click node_search_service "https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/GraphService.py"
click node_graph_request "https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/DataTypes.py"
click node_search_config "https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/config.py"
click node_search_ui_config "https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/ui.py"
click node_combined_viewer "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/GraphVisualizerApp.py"
click node_combined_explorer "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/explorer.py"
click node_combined_renderer "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/graph_drawer.py"
click node_combined_graph_model "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/graph_models.py"
click node_combined_types "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/DataTypes.py"
click node_combined_config "https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/config.py"
click node_viewer_main "https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/main.py"
click node_viewer_app "https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/GraphVisualizerApp.py"
click node_viewer_explorer "https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/explorer.py"
click node_viewer_model "https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/graph_models.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_search_main,node_search_ui,node_search_console,node_search_service,node_user toneBlue
class node_combined_main,node_combined_app,node_combined_console,node_remote_metadata,node_remote_graphs toneAmber
class node_combined_viewer,node_combined_explorer,node_combined_renderer,node_viewer_main,node_viewer_app,node_viewer_explorer toneMint
class node_graph_request,node_search_config,node_search_ui_config,node_combined_graph_model,node_combined_types,node_combined_config,node_viewer_model toneRose
```

## Components

### Search and downloads

- [Search entry point](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/main.py): `GraphSearch/main.py`
- [Search interface](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/GraphFrontend.py): `GraphSearch/app/GraphFrontend.py`
- [Search console](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/ConsoleWidget.py): `GraphSearch/app/ConsoleWidget.py`
- [Search and download service](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/GraphService.py): `GraphSearch/app/GraphService.py`

### Combined application

- [Combined entry point](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/main.py): `GraphCombined/main.py`
- [Tabbed application](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/CombinedFrontend.py): `GraphCombined/app/CombinedFrontend.py`
- [Combined console](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/ConsoleWidget.py): `GraphCombined/app/ConsoleWidget.py`

### Graph visualization

- [Combined graph viewer](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/GraphVisualizerApp.py): `GraphCombined/app/GraphVisualizerApp.py`
- [Combined file explorer](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/explorer.py): `GraphCombined/app/explorer.py`
- [Combined graph renderer](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/graph_drawer.py): `GraphCombined/app/graph_drawer.py`
- [Viewer entry point](https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/main.py): `GraphViewer/main.py`
- [Standalone graph viewer](https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/GraphVisualizerApp.py): `GraphViewer/GraphVisualizerApp.py`
- [Standalone file explorer](https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/explorer.py): `GraphViewer/explorer.py`

### Types and configuration

- [Search request types](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/DataTypes.py): `GraphSearch/app/DataTypes.py`
- [Search configuration](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/config.py): `GraphSearch/app/config.py`
- [UI configuration](https://github.com/eternityradiance/graphutils/blob/main/GraphSearch/app/ui.py): `GraphSearch/app/ui.py`
- [Combined graph model](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/graph_models.py): `GraphCombined/app/graph_models.py`
- [Combined service types](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/DataTypes.py): `GraphCombined/app/DataTypes.py`
- [Combined configuration](https://github.com/eternityradiance/graphutils/blob/main/GraphCombined/app/config.py): `GraphCombined/app/config.py`
- [Standalone graph model](https://github.com/eternityradiance/graphutils/blob/main/GraphViewer/graph_models.py): `GraphViewer/graph_models.py`

### Other components

- **Desktop user**
- **Graph metadata service**
- **Graph file repository**

## Connections

- Desktop user → Tabbed application: uses (evidence: `GraphCombined/app/CombinedFrontend.py`)
- Combined entry point → Tabbed application: starts (evidence: `GraphCombined/main.py`)
- Tabbed application → Search interface: embeds (evidence: `GraphCombined/app/CombinedFrontend.py`)
- Tabbed application → Combined graph viewer: embeds (evidence: `GraphCombined/app/CombinedFrontend.py`)
- Tabbed application → Combined console: initializes (evidence: `GraphCombined/app/CombinedFrontend.py`)
- Desktop user → Search entry point: starts (evidence: `GraphSearch/main.py`)
- Search entry point → Search interface: starts (evidence: `GraphSearch/main.py`)
- Search entry point → Search console: imports (evidence: `GraphSearch/main.py`)
- Search interface → Search and download service: queries (evidence: `GraphSearch/app/GraphFrontend.py`)
- Search interface → Search console: uses (evidence: `GraphSearch/app/GraphFrontend.py`)
- Search interface → Search request types: builds requests (evidence: `GraphSearch/app/GraphFrontend.py`)
- Search interface → Search configuration: reads settings (evidence: `GraphSearch/app/GraphFrontend.py`)
- Search and download service → Search request types: matches types (evidence: `GraphSearch/app/GraphService.py`)
- Search and download service → Search configuration: reads endpoints (evidence: `GraphSearch/app/GraphService.py`)
- Search and download service → Graph metadata service: fetches metadata (evidence: `GraphSearch/app/GraphService.py`)
- Search and download service → Graph file repository: downloads graphs (evidence: `GraphSearch/app/GraphService.py`)
- Search configuration → UI configuration: loads UI settings (evidence: `GraphSearch/app/config.py`)
- Combined graph viewer → Combined file explorer: loads graph files (evidence: `GraphCombined/app/GraphVisualizerApp.py`)
- Combined file explorer → Combined graph model: uses model (evidence: `GraphCombined/app/explorer.py`)
- Combined graph renderer → Combined graph model: uses model (evidence: `GraphCombined/app/graph_drawer.py`)
- Combined configuration → Combined service types: configures service
- Desktop user → Viewer entry point: starts (evidence: `GraphViewer/main.py`)
- Viewer entry point → Standalone graph viewer: starts (evidence: `GraphViewer/main.py`)
- Standalone graph viewer → Standalone file explorer: loads graph files (evidence: `GraphViewer/GraphVisualizerApp.py`)
- Standalone file explorer → Standalone graph model: uses model (evidence: `GraphViewer/explorer.py`)
