# nvxstrikes/smart_render_guard architecture

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

## Overview

Smart Render Guard Lite is a Blender add-on that diagnoses scene and hardware risks, validates assets before rendering, and offers memory cleanup and safe fixes. The main workflow is a user-triggered sidebar scan, followed by validation and optional fixes or purging, then a guarded render. The graph preserves the README’s major Lite capabilities and the separately documented Pro relinking feature. Some links use README workflow statements or SOURCE INDEX references because the relevant implementation excerpts are incomplete.

Main entry points: [`smart_render_guard/core/scanner.py`](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/scanner.py) (Scan Orchestrator), [`smart_render_guard/ui/panel.py`](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/ui/panel.py) (Sidebar Panel), [`smart_render_guard/operators/render_operator.py`](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/render_operator.py) (Safe Render), [`smart_render_guard/core/auto_fixer.py`](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/auto_fixer.py) (Safe Fix Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Blender Interface"]
  node_panel["Sidebar Panel<br/>[panel.py]"]
  node_popup["Risk Popup<br/>[popup.py]"]
  node_scanop["Scan Action<br/>[scan_operator.py]"]
  node_validateop["Validate Action"]
  node_fixop["Fix Action<br/>[fix_operator.py]"]
  node_renderop["Safe Render<br/>[render_operator.py]"]
end

subgraph group_diagnostics["Scene Diagnostics"]
  node_scanner["Scan Orchestrator<br/>[scanner.py]"]
  node_report["Risk Report<br/>[report.py]"]
  node_mesh["Mesh Analysis<br/>[mesh_analyzer.py]"]
  node_texture["Texture Analysis"]
  node_particle["Particle Analysis"]
  node_vram["VRAM Diagnostics<br/>[vram.py]"]
  node_ram["RAM Diagnostics<br/>[ram.py]"]
  node_validator["Scene Validator<br/>[validator.py]"]
end

subgraph group_safety["Safety Actions"]
  node_autofix["Safe Fix Engine<br/>[auto_fixer.py]"]
  node_optimizer["Memory Optimizer<br/>[optimizer.py]"]
  node_relink["Asset Relinker<br/>[relink_helper.py]"]
end

subgraph group_support["Configuration"]
  node_tier["Feature Tiers<br/>[tier.py]"]
  node_preferences["Addon Preferences<br/>[preferences.py]"]
  node_properties["Scene Properties<br/>[properties.py]"]
  node_helpers["Shared Helpers<br/>[helpers.py]"]
end

node_artist(("Blender User"))

node_artist -->|"opens"| node_panel
node_panel -->|"starts scan"| node_scanop
node_scanop -->|"runs scan"| node_scanner
node_scanner -->|"analyzes meshes"| node_mesh
node_scanner -->|"analyzes textures"| node_texture
node_scanner -->|"analyzes particles"| node_particle
node_scanner -->|"checks VRAM"| node_vram
node_scanner -->|"checks RAM"| node_ram
node_scanner -->|"builds report"| node_report
node_panel -->|"displays scan"| node_scanner
node_artist -->|"requests validation"| node_validateop
node_validateop -->|"validates scene"| node_validator
node_artist -->|"requests fixes"| node_fixop
node_fixop -->|"applies fixes"| node_autofix
node_autofix -->|"delegates optimization"| node_optimizer
node_autofix -->|"checks tier"| node_tier
node_artist -->|"starts safe render"| node_renderop
node_renderop -->|"preflight scan"| node_scanner
node_renderop -->|"shows warning"| node_popup
node_scanner -.->|"alerts on risk"| node_popup
node_relink -->|"uses validation"| node_validator
node_panel -.->|"reads settings"| node_preferences
node_panel -->|"checks features"| node_tier
node_properties -->|"stores scan state"| node_scanner

click node_panel "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/ui/panel.py"
click node_popup "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/ui/popup.py"
click node_scanop "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/scan_operator.py"
click node_validateop "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/validate_operator.py"
click node_fixop "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/fix_operator.py"
click node_renderop "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/render_operator.py"
click node_scanner "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/scanner.py"
click node_report "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/report.py"
click node_mesh "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/mesh_analyzer.py"
click node_texture "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/texture_analyzer.py"
click node_particle "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/particle_analyzer.py"
click node_vram "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/vram.py"
click node_ram "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/ram.py"
click node_validator "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/validator.py"
click node_autofix "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/auto_fixer.py"
click node_optimizer "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/optimizer.py"
click node_relink "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/relink_helper.py"
click node_tier "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/tier.py"
click node_preferences "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/preferences.py"
click node_properties "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/properties.py"
click node_helpers "https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/utils/helpers.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_panel,node_popup,node_scanop,node_validateop,node_fixop,node_renderop,node_artist toneBlue
class node_scanner,node_report,node_mesh,node_texture,node_particle,node_vram,node_ram,node_validator toneAmber
class node_autofix,node_optimizer,node_relink toneMint
class node_tier,node_preferences,node_properties,node_helpers toneRose
```

## Components

### Blender Interface

- [Sidebar Panel](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/ui/panel.py): `smart_render_guard/ui/panel.py`
- [Risk Popup](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/ui/popup.py): `smart_render_guard/ui/popup.py`
- [Scan Action](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/scan_operator.py): `smart_render_guard/operators/scan_operator.py`
- [Validate Action](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/validate_operator.py): `smart_render_guard/operators/validate_operator.py`
- [Fix Action](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/fix_operator.py): `smart_render_guard/operators/fix_operator.py`
- [Safe Render](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/operators/render_operator.py): `smart_render_guard/operators/render_operator.py`

### Scene Diagnostics

- [Scan Orchestrator](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/scanner.py): `smart_render_guard/core/scanner.py`
- [Risk Report](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/report.py): `smart_render_guard/core/report.py`
- [Mesh Analysis](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/mesh_analyzer.py): `smart_render_guard/core/mesh_analyzer.py`
- [Texture Analysis](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/texture_analyzer.py): `smart_render_guard/core/texture_analyzer.py`
- [Particle Analysis](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/particle_analyzer.py): `smart_render_guard/core/particle_analyzer.py`
- [VRAM Diagnostics](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/vram.py): `smart_render_guard/core/vram.py`
- [RAM Diagnostics](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/ram.py): `smart_render_guard/core/ram.py`
- [Scene Validator](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/validator.py): `smart_render_guard/core/validator.py`

### Safety Actions

- [Safe Fix Engine](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/auto_fixer.py): `smart_render_guard/core/auto_fixer.py`
- [Memory Optimizer](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/optimizer.py): `smart_render_guard/core/optimizer.py`
- [Asset Relinker](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/relink_helper.py): `smart_render_guard/core/relink_helper.py`

### Configuration

- [Feature Tiers](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/core/tier.py): `smart_render_guard/core/tier.py`
- [Addon Preferences](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/preferences.py): `smart_render_guard/preferences.py`
- [Scene Properties](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/properties.py): `smart_render_guard/properties.py`
- [Shared Helpers](https://github.com/nvxstrikes/smart_render_guard/blob/main/smart_render_guard/utils/helpers.py): `smart_render_guard/utils/helpers.py`

### Other components

- **Blender User**

## Connections

- Blender User → Sidebar Panel: opens (evidence: `README.md`)
- Sidebar Panel → Scan Action: starts scan (evidence: `README.md`)
- Scan Action → Scan Orchestrator: runs scan (evidence: `smart_render_guard/operators/scan_operator.py`)
- Scan Orchestrator → Mesh Analysis: analyzes meshes (evidence: `smart_render_guard/core/scanner.py`)
- Scan Orchestrator → Texture Analysis: analyzes textures (evidence: `smart_render_guard/core/scanner.py`)
- Scan Orchestrator → Particle Analysis: analyzes particles (evidence: `smart_render_guard/core/scanner.py`)
- Scan Orchestrator → VRAM Diagnostics: checks VRAM (evidence: `smart_render_guard/core/scanner.py`)
- Scan Orchestrator → RAM Diagnostics: checks RAM (evidence: `smart_render_guard/core/scanner.py`)
- Scan Orchestrator → Risk Report: builds report (evidence: `smart_render_guard/core/scanner.py`)
- Sidebar Panel → Scan Orchestrator: displays scan (evidence: `smart_render_guard/ui/panel.py`)
- Blender User → Validate Action: requests validation (evidence: `README.md`)
- Validate Action → Scene Validator: validates scene (evidence: `smart_render_guard/operators/validate_operator.py`)
- Blender User → Fix Action: requests fixes (evidence: `README.md`)
- Fix Action → Safe Fix Engine: applies fixes (evidence: `smart_render_guard/operators/fix_operator.py`)
- Safe Fix Engine → Memory Optimizer: delegates optimization (evidence: `smart_render_guard/core/auto_fixer.py`)
- Safe Fix Engine → Feature Tiers: checks tier (evidence: `smart_render_guard/core/auto_fixer.py`)
- Blender User → Safe Render: starts safe render (evidence: `README.md`)
- Safe Render → Scan Orchestrator: preflight scan (evidence: `smart_render_guard/operators/render_operator.py`)
- Safe Render → Risk Popup: shows warning (evidence: `smart_render_guard/operators/render_operator.py`)
- Scan Orchestrator → Risk Popup: alerts on risk (evidence: `smart_render_guard/ui/popup.py`)
- Asset Relinker → Scene Validator: uses validation (evidence: `smart_render_guard/core/relink_helper.py`)
- Sidebar Panel → Addon Preferences: reads settings
- Sidebar Panel → Feature Tiers: checks features (evidence: `smart_render_guard/ui/panel.py`)
- Scene Properties → Scan Orchestrator: stores scan state (evidence: `smart_render_guard/properties.py`)
