# topl1nk/noderc architecture

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

## Overview

NodeRC is a PyQt5 visual workflow editor for composing RealityCapture/RealityScan CLI commands as connected command and parameter nodes, then executing the graph through a node-pack interface. The user adds and configures nodes on the canvas, connects execution and data sockets, and launches the chain; the executor resolves parameters and delegates command segments to the selected pack. The README also documents graph editing, search, configuration, and workflow execution. Edges are limited to relationships supported by the README or SOURCE INDEX; some subsystem internals were not sampled.

Main entry points: [`ui/editor_window.py`](https://github.com/topl1nk/noderc/blob/master/ui/editor_window.py) (Editor Window), [`nodeRC.py`](https://github.com/topl1nk/noderc/blob/master/nodeRC.py) (Application Startup), [`core/graph_executor.py`](https://github.com/topl1nk/noderc/blob/master/core/graph_executor.py) (Chain Executor), [`core/graph_model.py`](https://github.com/topl1nk/noderc/blob/master/core/graph_model.py) (Graph Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Graph Editor"]
  node_entry["Application Startup<br/>[nodeRC.py]"]
  node_window["Editor Window<br/>[editor_window.py]"]
  node_canvas["Canvas Scene<br/>[scene.py]"]
  node_view["Canvas View<br/>[view.py]"]
  node_items["Graph Visuals<br/>[graph_items.py]"]
  node_commands["Command Nodes<br/>[command_nodes.py]"]
  node_parameters["Parameter Nodes<br/>[param_nodes.py]"]
  node_search["Node Search<br/>[search_menu.py]"]
end

subgraph group_runtime["Graph Runtime"]
  node_blueprints["Node Specifications<br/>[node_blueprint.py]"]
  node_model["Graph Model<br/>[graph_model.py]"]
  node_executor["Chain Executor<br/>[graph_executor.py]"]
  node_worker["Execution Worker"]
end

subgraph group_packs["Node Packs"]
  node_protocol["Pack Contract<br/>[pack_protocol.py]"]
  node_registry["Pack Registry<br/>[pack_registry.py]"]
  node_catalog["Pack Catalog<br/>[pack_catalog.py]"]
  node_rsconfig["RealityScan Settings<br/>[config.py]"]
  node_rscommands["RealityScan Catalog"]
  node_rsdocs["Documentation Extractor"]
  node_rspack["RealityScan Pack<br/>[rs_pack.py]"]
end

subgraph group_persistence["Projects and State"]
  node_serialization["Graph Serialization"]
  node_export["Graph Export<br/>[graph_export.py]"]
  node_import["Graph Import<br/>[graph_import.py]"]
  node_session["Session State<br/>[session.py]"]
  node_autosave["Autosave<br/>[autosave.py]"]
  node_prefs["App Preferences<br/>[app_prefs.py]"]
end

subgraph group_shared["Shared Services"]
  node_configuration["UI Configuration<br/>[configuration.py]"]
  node_theme["UI Theme<br/>[theme.py]"]
  node_localization["Localization<br/>[localization.py]"]
  node_diagnostics["Diagnostics<br/>[diagnostics.py]"]
end

node_user(("Editor User"))
node_cli["RealityScan CLI"]

node_user -->|"starts"| node_entry
node_entry -->|"opens"| node_window
node_window -->|"hosts"| node_canvas
node_window -->|"creates"| node_view
node_canvas -->|"displays"| node_items
node_view -->|"renders"| node_items
node_canvas -->|"opens"| node_search
node_search -->|"previews"| node_commands
node_search -->|"previews"| node_parameters
node_commands -->|"builds from"| node_blueprints
node_parameters -->|"builds from"| node_blueprints
node_items -->|"renders"| node_blueprints
node_window -->|"launches"| node_worker
node_worker -->|"runs"| node_executor
node_executor -->|"traverses"| node_model
node_executor -->|"resolves executor"| node_registry
node_executor -->|"dispatches segments"| node_protocol
node_registry -->|"implements contract"| node_protocol
node_catalog -->|"discovers packs"| node_registry
node_rspack -->|"implements contract"| node_protocol
node_rspack -.->|"invokes"| node_cli
node_rscommands -->|"uses paths"| node_rsconfig
node_rsdocs -->|"uses paths"| node_rsconfig
node_window -->|"loads commands"| node_rscommands
node_window -->|"saves and loads"| node_serialization
node_serialization -->|"serializes"| node_model
node_window -->|"exports"| node_export
node_export -->|"reads graph"| node_model
node_window -->|"imports"| node_import
node_import -->|"creates graph"| node_model
node_entry -->|"configures"| node_configuration
node_entry -->|"initializes"| node_theme
node_entry -.->|"initializes"| node_localization
node_window -.->|"restores state"| node_session
node_session -->|"uses"| node_autosave
node_prefs -->|"uses"| node_autosave
node_window -->|"reports errors"| node_diagnostics

click node_entry "https://github.com/topl1nk/noderc/blob/master/nodeRC.py"
click node_window "https://github.com/topl1nk/noderc/blob/master/ui/editor_window.py"
click node_canvas "https://github.com/topl1nk/noderc/blob/master/ui/scene.py"
click node_view "https://github.com/topl1nk/noderc/blob/master/ui/view.py"
click node_items "https://github.com/topl1nk/noderc/blob/master/ui/graph_items.py"
click node_commands "https://github.com/topl1nk/noderc/blob/master/ui/command_nodes.py"
click node_parameters "https://github.com/topl1nk/noderc/blob/master/ui/param_nodes.py"
click node_search "https://github.com/topl1nk/noderc/blob/master/ui/search_menu.py"
click node_blueprints "https://github.com/topl1nk/noderc/blob/master/core/node_blueprint.py"
click node_model "https://github.com/topl1nk/noderc/blob/master/core/graph_model.py"
click node_executor "https://github.com/topl1nk/noderc/blob/master/core/graph_executor.py"
click node_worker "https://github.com/topl1nk/noderc/blob/master/ui/graph_execution_worker.py"
click node_protocol "https://github.com/topl1nk/noderc/blob/master/core/pack_protocol.py"
click node_registry "https://github.com/topl1nk/noderc/blob/master/core/pack_registry.py"
click node_catalog "https://github.com/topl1nk/noderc/blob/master/core/pack_catalog.py"
click node_rsconfig "https://github.com/topl1nk/noderc/blob/master/packs/realityscan/config.py"
click node_rscommands "https://github.com/topl1nk/noderc/blob/master/packs/realityscan/command_database.py"
click node_rsdocs "https://github.com/topl1nk/noderc/blob/master/packs/realityscan/rs_documentation_extractor.py"
click node_rspack "https://github.com/topl1nk/noderc/blob/master/packs/realityscan/rs_pack.py"
click node_serialization "https://github.com/topl1nk/noderc/blob/master/ui/graph_serialization.py"
click node_export "https://github.com/topl1nk/noderc/blob/master/core/graph_export.py"
click node_import "https://github.com/topl1nk/noderc/blob/master/core/graph_import.py"
click node_session "https://github.com/topl1nk/noderc/blob/master/core/session.py"
click node_autosave "https://github.com/topl1nk/noderc/blob/master/core/autosave.py"
click node_prefs "https://github.com/topl1nk/noderc/blob/master/core/app_prefs.py"
click node_configuration "https://github.com/topl1nk/noderc/blob/master/configuration.py"
click node_theme "https://github.com/topl1nk/noderc/blob/master/ui/theme.py"
click node_localization "https://github.com/topl1nk/noderc/blob/master/localization.py"
click node_diagnostics "https://github.com/topl1nk/noderc/blob/master/diagnostics.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_entry,node_window,node_canvas,node_view,node_items,node_commands,node_parameters,node_search,node_user toneBlue
class node_blueprints,node_model,node_executor,node_worker toneAmber
class node_protocol,node_registry,node_catalog,node_rsconfig,node_rscommands,node_rsdocs,node_rspack toneMint
class node_serialization,node_export,node_import,node_session,node_autosave,node_prefs toneRose
class node_configuration,node_theme,node_localization,node_diagnostics,node_cli toneIndigo
```

## Components

### Graph Editor

- [Application Startup](https://github.com/topl1nk/noderc/blob/master/nodeRC.py): `nodeRC.py`
- [Editor Window](https://github.com/topl1nk/noderc/blob/master/ui/editor_window.py): `ui/editor_window.py`
- [Canvas Scene](https://github.com/topl1nk/noderc/blob/master/ui/scene.py): `ui/scene.py`
- [Canvas View](https://github.com/topl1nk/noderc/blob/master/ui/view.py): `ui/view.py`
- [Graph Visuals](https://github.com/topl1nk/noderc/blob/master/ui/graph_items.py): `ui/graph_items.py`
- [Command Nodes](https://github.com/topl1nk/noderc/blob/master/ui/command_nodes.py): `ui/command_nodes.py`
- [Parameter Nodes](https://github.com/topl1nk/noderc/blob/master/ui/param_nodes.py): `ui/param_nodes.py`
- [Node Search](https://github.com/topl1nk/noderc/blob/master/ui/search_menu.py): `ui/search_menu.py`

### Graph Runtime

- [Node Specifications](https://github.com/topl1nk/noderc/blob/master/core/node_blueprint.py): `core/node_blueprint.py`
- [Graph Model](https://github.com/topl1nk/noderc/blob/master/core/graph_model.py): `core/graph_model.py`
- [Chain Executor](https://github.com/topl1nk/noderc/blob/master/core/graph_executor.py): `core/graph_executor.py`
- [Execution Worker](https://github.com/topl1nk/noderc/blob/master/ui/graph_execution_worker.py): `ui/graph_execution_worker.py`

### Node Packs

- [Pack Contract](https://github.com/topl1nk/noderc/blob/master/core/pack_protocol.py): `core/pack_protocol.py`
- [Pack Registry](https://github.com/topl1nk/noderc/blob/master/core/pack_registry.py): `core/pack_registry.py`
- [Pack Catalog](https://github.com/topl1nk/noderc/blob/master/core/pack_catalog.py): `core/pack_catalog.py`
- [RealityScan Settings](https://github.com/topl1nk/noderc/blob/master/packs/realityscan/config.py): `packs/realityscan/config.py`
- [RealityScan Catalog](https://github.com/topl1nk/noderc/blob/master/packs/realityscan/command_database.py): `packs/realityscan/command_database.py`
- [Documentation Extractor](https://github.com/topl1nk/noderc/blob/master/packs/realityscan/rs_documentation_extractor.py): `packs/realityscan/rs_documentation_extractor.py`
- [RealityScan Pack](https://github.com/topl1nk/noderc/blob/master/packs/realityscan/rs_pack.py): `packs/realityscan/rs_pack.py`

### Projects and State

- [Graph Serialization](https://github.com/topl1nk/noderc/blob/master/ui/graph_serialization.py): `ui/graph_serialization.py`
- [Graph Export](https://github.com/topl1nk/noderc/blob/master/core/graph_export.py): `core/graph_export.py`
- [Graph Import](https://github.com/topl1nk/noderc/blob/master/core/graph_import.py): `core/graph_import.py`
- [Session State](https://github.com/topl1nk/noderc/blob/master/core/session.py): `core/session.py`
- [Autosave](https://github.com/topl1nk/noderc/blob/master/core/autosave.py): `core/autosave.py`
- [App Preferences](https://github.com/topl1nk/noderc/blob/master/core/app_prefs.py): `core/app_prefs.py`

### Shared Services

- [UI Configuration](https://github.com/topl1nk/noderc/blob/master/configuration.py): `configuration.py`
- [UI Theme](https://github.com/topl1nk/noderc/blob/master/ui/theme.py): `ui/theme.py`
- [Localization](https://github.com/topl1nk/noderc/blob/master/localization.py): `localization.py`
- [Diagnostics](https://github.com/topl1nk/noderc/blob/master/diagnostics.py): `diagnostics.py`

### Other components

- **Editor User**
- **RealityScan CLI**

## Connections

- Editor User → Application Startup: starts (evidence: `README.md`)
- Application Startup → Editor Window: opens (evidence: `nodeRC.py`)
- Editor Window → Canvas Scene: hosts (evidence: `ui/editor_window.py`)
- Editor Window → Canvas View: creates (evidence: `ui/editor_window.py`)
- Canvas Scene → Graph Visuals: displays (evidence: `ui/scene.py`)
- Canvas View → Graph Visuals: renders (evidence: `ui/view.py`)
- Canvas Scene → Node Search: opens (evidence: `ui/scene.py`)
- Node Search → Command Nodes: previews (evidence: `ui/search_menu.py`)
- Node Search → Parameter Nodes: previews (evidence: `ui/search_menu.py`)
- Command Nodes → Node Specifications: builds from (evidence: `ui/command_nodes.py`)
- Parameter Nodes → Node Specifications: builds from (evidence: `ui/param_nodes.py`)
- Graph Visuals → Node Specifications: renders (evidence: `ui/graph_items.py`)
- Editor Window → Execution Worker: launches (evidence: `ui/editor_window.py`)
- Execution Worker → Chain Executor: runs (evidence: `ui/graph_execution_worker.py`)
- Chain Executor → Graph Model: traverses (evidence: `core/graph_executor.py`)
- Chain Executor → Pack Registry: resolves executor (evidence: `core/graph_executor.py`)
- Chain Executor → Pack Contract: dispatches segments (evidence: `core/graph_executor.py`)
- Pack Registry → Pack Contract: implements contract (evidence: `core/pack_registry.py`)
- Pack Catalog → Pack Registry: discovers packs (evidence: `core/pack_catalog.py`)
- RealityScan Pack → Pack Contract: implements contract (evidence: `core/pack_protocol.py`)
- RealityScan Pack → RealityScan CLI: invokes
- RealityScan Catalog → RealityScan Settings: uses paths (evidence: `packs/realityscan/command_database.py`)
- Documentation Extractor → RealityScan Settings: uses paths (evidence: `packs/realityscan/rs_documentation_extractor.py`)
- Editor Window → RealityScan Catalog: loads commands (evidence: `ui/editor_window.py`)
- Editor Window → Graph Serialization: saves and loads (evidence: `ui/editor_window.py`)
- Graph Serialization → Graph Model: serializes (evidence: `ui/graph_serialization.py`)
- Editor Window → Graph Export: exports (evidence: `ui/editor_window.py`)
- Graph Export → Graph Model: reads graph (evidence: `core/graph_export.py`)
- Editor Window → Graph Import: imports (evidence: `ui/editor_window.py`)
- Graph Import → Graph Model: creates graph (evidence: `core/graph_import.py`)
- Application Startup → UI Configuration: configures (evidence: `nodeRC.py`)
- Application Startup → UI Theme: initializes (evidence: `nodeRC.py`)
- Application Startup → Localization: initializes
- Editor Window → Session State: restores state (evidence: `ui/editor_window.py`)
- Session State → Autosave: uses (evidence: `core/session.py`)
- App Preferences → Autosave: uses (evidence: `core/app_prefs.py`)
- Editor Window → Diagnostics: reports errors (evidence: `ui/editor_window.py`)
