# trodskovich/nvdrin architecture

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

- Interactive diagram: https://gitdiagram.com/trodskovich/nvdrin
- Repository: https://github.com/trodskovich/nvdrin

## Overview

NvDrIn is a command-line workflow for checking dependencies, preparing an openSUSE host, checking for and optionally downloading the latest NVIDIA driver, running an install stage, and completing post-install steps. The main entry point calls these stages in sequence. The installer currently creates a pre-install snapshot, while the driver invocation and post-install system changes are commented out. The graph reflects the sampled source; the separate post-install checker is included, but no call to it is shown.

Main entry points: [`nvdrin.py`](https://github.com/trodskovich/nvdrin/blob/master/nvdrin.py) (Installer entry), [`chkltdr.py`](https://github.com/trodskovich/nvdrin/blob/master/chkltdr.py) (Latest driver check), [`nvinstall.py`](https://github.com/trodskovich/nvdrin/blob/master/nvinstall.py) (Driver install stage), [`dpndchk.py`](https://github.com/trodskovich/nvdrin/blob/master/dpndchk.py) (Dependency check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Installer workflow"]
  node_entry["Installer entry<br/>[nvdrin.py]"]
  node_install["Driver install stage<br/>[nvinstall.py]"]
  node_post["Post-install stage<br/>[postinstall.py]"]
end

subgraph group_driver["Driver selection"]
  node_check["Latest driver check<br/>[chkltdr.py]"]
end

subgraph group_system["Host checks and setup"]
  node_deps["Dependency check<br/>[dpndchk.py]"]
  node_prepare["Pre-install setup<br/>[preinstall.py]"]
  node_verify["Post-install checks<br/>[postinchk.py]"]
end

node_user(("Operator"))
node_nvidia["NVIDIA download site"]
node_host["openSUSE host"]

node_user -->|"runs"| node_entry
node_entry -->|"checks dependencies"| node_deps
node_entry -->|"prepares host"| node_prepare
node_entry -->|"checks driver"| node_check
node_entry -->|"runs install stage"| node_install
node_entry -->|"runs post stage"| node_post
node_check -->|"fetches latest info"| node_nvidia
node_check -->|"downloads driver"| node_nvidia
node_deps -->|"checks and installs packages"| node_host
node_prepare -->|"enables DKMS"| node_host
node_install -->|"creates snapshot"| node_host
node_verify -->|"inspects graphics modules"| node_host

click node_entry "https://github.com/trodskovich/nvdrin/blob/master/nvdrin.py"
click node_deps "https://github.com/trodskovich/nvdrin/blob/master/dpndchk.py"
click node_prepare "https://github.com/trodskovich/nvdrin/blob/master/preinstall.py"
click node_check "https://github.com/trodskovich/nvdrin/blob/master/chkltdr.py"
click node_install "https://github.com/trodskovich/nvdrin/blob/master/nvinstall.py"
click node_post "https://github.com/trodskovich/nvdrin/blob/master/postinstall.py"
click node_verify "https://github.com/trodskovich/nvdrin/blob/master/postinchk.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_install,node_post toneBlue
class node_check toneAmber
class node_deps,node_prepare,node_verify toneMint
class node_user,node_nvidia,node_host toneIndigo
```

## Components

### Installer workflow

- [Installer entry](https://github.com/trodskovich/nvdrin/blob/master/nvdrin.py): `nvdrin.py`
- [Driver install stage](https://github.com/trodskovich/nvdrin/blob/master/nvinstall.py): `nvinstall.py`
- [Post-install stage](https://github.com/trodskovich/nvdrin/blob/master/postinstall.py): `postinstall.py`

### Driver selection

- [Latest driver check](https://github.com/trodskovich/nvdrin/blob/master/chkltdr.py): `chkltdr.py`

### Host checks and setup

- [Dependency check](https://github.com/trodskovich/nvdrin/blob/master/dpndchk.py): `dpndchk.py`
- [Pre-install setup](https://github.com/trodskovich/nvdrin/blob/master/preinstall.py): `preinstall.py`
- [Post-install checks](https://github.com/trodskovich/nvdrin/blob/master/postinchk.py): `postinchk.py`

### Other components

- **Operator**
- **NVIDIA download site**
- **openSUSE host**

## Connections

- Operator → Installer entry: runs (evidence: `README.md`)
- Installer entry → Dependency check: checks dependencies (evidence: `nvdrin.py`)
- Installer entry → Pre-install setup: prepares host (evidence: `nvdrin.py`)
- Installer entry → Latest driver check: checks driver (evidence: `nvdrin.py`)
- Installer entry → Driver install stage: runs install stage (evidence: `nvdrin.py`)
- Installer entry → Post-install stage: runs post stage (evidence: `nvdrin.py`)
- Latest driver check → NVIDIA download site: fetches latest info (evidence: `chkltdr.py`)
- Latest driver check → NVIDIA download site: downloads driver (evidence: `chkltdr.py`)
- Dependency check → openSUSE host: checks and installs packages (evidence: `dpndchk.py`)
- Pre-install setup → openSUSE host: enables DKMS (evidence: `preinstall.py`)
- Driver install stage → openSUSE host: creates snapshot (evidence: `nvinstall.py`)
- Post-install checks → openSUSE host: inspects graphics modules (evidence: `postinchk.py`)
