# viozenium/imgtoolkit architecture

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

- Interactive diagram: https://gitdiagram.com/viozenium/imgtoolkit
- Repository: https://github.com/viozenium/imgtoolkit

## Overview

ImgToolkit is a cross-platform Tkinter desktop suite for finding similar images, reviewing matches, converting images to JPG, and consulting an integrated manual. The main workflow is to launch Finder, scan a folder with CLIP embeddings and FAISS, save matching pairs, then review those pairs and move selected files. Conversion and help are separate capabilities. Source excerpts show the Finder and Reviewer interfaces and core operations; some launcher wiring and workflow links are documented only in the README.

Main entry points: [`launcher.py`](https://github.com/viozenium/imgtoolkit/blob/main/launcher.py) (Launcher), [`theme.py`](https://github.com/viozenium/imgtoolkit/blob/main/theme.py) (Shared theme), [`reviewer_core.py`](https://github.com/viozenium/imgtoolkit/blob/main/reviewer_core.py) (Review and file operations), [`finder.py`](https://github.com/viozenium/imgtoolkit/blob/main/finder.py) (Finder UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch and shared UI"]
  node_launcher["Launcher<br/>[launcher.py]"]
  node_theme["Shared theme<br/>[theme.py]"]
  node_about["About window<br/>[info.py]"]
  node_manual["User manual<br/>[manual.py]"]
end

subgraph group_search["Similarity search"]
  node_finder_ui["Finder UI<br/>[finder.py]"]
  node_finder_core["CLIP and FAISS search<br/>[finder_core.py]"]
  node_pair_results["Pair results file"]
end

subgraph group_review["Pair review"]
  node_reviewer_ui["Reviewer UI<br/>[reviewer.py]"]
  node_reviewer_core["Review and file operations<br/>[reviewer_core.py]"]
  node_review_state["Review state file"]
  node_duplicate_folder["Duplicate folder"]
end

subgraph group_convert["Image conversion"]
  node_converter_ui["Converter UI<br/>[converter.py]"]
  node_converter_core["JPG conversion<br/>[converter_core.py]"]
end

node_user(("User"))

node_user -->|"opens"| node_launcher
node_launcher -->|"launches"| node_finder_ui
node_launcher -->|"launches"| node_reviewer_ui
node_launcher -->|"launches"| node_converter_ui
node_launcher -->|"opens"| node_manual
node_launcher -->|"opens"| node_about
node_finder_ui -->|"calls"| node_finder_core
node_finder_core -->|"writes pairs"| node_pair_results
node_pair_results -->|"provides pairs"| node_reviewer_core
node_reviewer_ui -->|"calls"| node_reviewer_core
node_reviewer_core -->|"saves decisions"| node_review_state
node_reviewer_core -->|"moves images"| node_duplicate_folder
node_converter_ui -->|"calls"| node_converter_core
node_finder_ui -->|"uses styles"| node_theme
node_reviewer_ui -->|"uses styles"| node_theme
node_converter_ui -->|"uses styles"| node_theme
node_launcher -->|"uses styles"| node_theme
node_about -->|"uses styles"| node_theme
node_manual -->|"uses styles"| node_theme

click node_launcher "https://github.com/viozenium/imgtoolkit/blob/main/launcher.py"
click node_theme "https://github.com/viozenium/imgtoolkit/blob/main/theme.py"
click node_about "https://github.com/viozenium/imgtoolkit/blob/main/info.py"
click node_manual "https://github.com/viozenium/imgtoolkit/blob/main/manual.py"
click node_finder_ui "https://github.com/viozenium/imgtoolkit/blob/main/finder.py"
click node_finder_core "https://github.com/viozenium/imgtoolkit/blob/main/finder_core.py"
click node_reviewer_ui "https://github.com/viozenium/imgtoolkit/blob/main/reviewer.py"
click node_reviewer_core "https://github.com/viozenium/imgtoolkit/blob/main/reviewer_core.py"
click node_converter_ui "https://github.com/viozenium/imgtoolkit/blob/main/converter.py"
click node_converter_core "https://github.com/viozenium/imgtoolkit/blob/main/converter_core.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_launcher,node_theme,node_about,node_manual,node_user toneBlue
class node_finder_ui,node_finder_core,node_pair_results toneAmber
class node_reviewer_ui,node_reviewer_core,node_review_state,node_duplicate_folder toneMint
class node_converter_ui,node_converter_core toneRose
```

## Components

### Launch and shared UI

- [Launcher](https://github.com/viozenium/imgtoolkit/blob/main/launcher.py): `launcher.py`
- [Shared theme](https://github.com/viozenium/imgtoolkit/blob/main/theme.py): `theme.py`
- [About window](https://github.com/viozenium/imgtoolkit/blob/main/info.py): `info.py`
- [User manual](https://github.com/viozenium/imgtoolkit/blob/main/manual.py): `manual.py`

### Similarity search

- [Finder UI](https://github.com/viozenium/imgtoolkit/blob/main/finder.py): `finder.py`
- [CLIP and FAISS search](https://github.com/viozenium/imgtoolkit/blob/main/finder_core.py): `finder_core.py`
- **Pair results file**

### Pair review

- [Reviewer UI](https://github.com/viozenium/imgtoolkit/blob/main/reviewer.py): `reviewer.py`
- [Review and file operations](https://github.com/viozenium/imgtoolkit/blob/main/reviewer_core.py): `reviewer_core.py`
- **Review state file**
- **Duplicate folder**

### Image conversion

- [Converter UI](https://github.com/viozenium/imgtoolkit/blob/main/converter.py): `converter.py`
- [JPG conversion](https://github.com/viozenium/imgtoolkit/blob/main/converter_core.py): `converter_core.py`

### Other components

- **User**

## Connections

- User → Launcher: opens (evidence: `README.md`)
- Launcher → Finder UI: launches (evidence: `README.md`)
- Launcher → Reviewer UI: launches (evidence: `README.md`)
- Launcher → Converter UI: launches (evidence: `README.md`)
- Launcher → User manual: opens (evidence: `README.md`)
- Launcher → About window: opens (evidence: `launcher.py`)
- Finder UI → CLIP and FAISS search: calls (evidence: `finder.py`)
- CLIP and FAISS search → Pair results file: writes pairs (evidence: `README.md`)
- Pair results file → Review and file operations: provides pairs (evidence: `README.md`)
- Reviewer UI → Review and file operations: calls (evidence: `reviewer.py`)
- Review and file operations → Review state file: saves decisions (evidence: `reviewer_core.py`)
- Review and file operations → Duplicate folder: moves images (evidence: `reviewer_core.py`)
- Converter UI → JPG conversion: calls (evidence: `converter.py`)
- Finder UI → Shared theme: uses styles (evidence: `finder.py`)
- Reviewer UI → Shared theme: uses styles (evidence: `reviewer.py`)
- Converter UI → Shared theme: uses styles (evidence: `converter.py`)
- Launcher → Shared theme: uses styles (evidence: `launcher.py`)
- About window → Shared theme: uses styles (evidence: `info.py`)
- User manual → Shared theme: uses styles (evidence: `README.md`)
