# almogschwartzberg/genai-shelter-validator architecture

> Architecture diagram of the GitHub repository almogschwartzberg/genai-shelter-validator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/almogschwartzberg/genai-shelter-validator
- Repository: https://github.com/almogschwartzberg/genai-shelter-validator

## Overview

GenAI Shelter Validator is a notebook-based experiment for testing whether Stable Diffusion-generated shelter images improve fine-tuning of object-detection models. Its documented workflow generates images, checks their realism, fine-tunes detectors, then reports results measured on real images. Configuration and the object/lookalike table describe the experiment inputs; Google Drive stores images, checkpoints, models, and results. The repository provides no source excerpts, so the graph follows README-level relationships only and omits unverified implementation details.

Main entry points: [`Code/01_generate.ipynb`](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/01_generate.ipynb) (Synthetic image generation), [`Code/03_finetune.ipynb`](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/03_finetune.ipynb) (Detector fine-tuning), [`config.yaml`](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/config.yaml) (Experiment config), [`Code/00_environment_check.ipynb`](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/00_environment_check.ipynb) (Environment check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experiment_inputs["Experiment inputs"]
  node_config["Experiment config<br/>[config.yaml]"]
  node_object_table["Objects and lookalikes<br/>[objects_table.csv]"]
  node_environment_check["Environment check"]
end

subgraph group_image_workflow["Image workflow"]
  node_image_generation["Synthetic image generation<br/>[01_generate.ipynb]"]
  node_realism_validation["Realism checks<br/>[02_validate.ipynb]"]
end

subgraph group_model_evaluation["Model evaluation"]
  node_fine_tuning["Detector fine-tuning<br/>[03_finetune.ipynb]"]
  node_results["Results and plots<br/>[04_results.ipynb]"]
end

subgraph group_stored_artifacts["Stored artifacts"]
  node_google_drive[("Google Drive")]
end

node_researcher(("Researcher"))
node_stable_diffusion["Stable Diffusion"]
node_detectors["Detection models"]

node_researcher -->|"runs first"| node_environment_check
node_researcher -->|"runs workflow"| node_image_generation
node_image_generation -->|"generates with"| node_stable_diffusion
node_image_generation -->|"images checked by"| node_realism_validation
node_realism_validation -->|"workflow continues"| node_fine_tuning
node_fine_tuning -->|"fine-tunes"| node_detectors
node_fine_tuning -->|"evaluated in"| node_results
node_config -->|"sets parameters"| node_image_generation
node_config -->|"sets parameters"| node_fine_tuning
node_object_table -->|"describes targets"| node_image_generation
node_environment_check -->|"checks access"| node_google_drive
node_image_generation -->|"stores images"| node_google_drive
node_fine_tuning -->|"stores checkpoints"| node_google_drive
node_results -->|"stores results"| node_google_drive

click node_config "https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/config.yaml"
click node_object_table "https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Data/objects_table.csv"
click node_environment_check "https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/00_environment_check.ipynb"
click node_image_generation "https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/01_generate.ipynb"
click node_realism_validation "https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/02_validate.ipynb"
click node_fine_tuning "https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/03_finetune.ipynb"
click node_results "https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/04_results.ipynb"

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_config,node_object_table,node_environment_check toneBlue
class node_image_generation,node_realism_validation toneAmber
class node_fine_tuning,node_results toneMint
class node_google_drive toneRose
class node_researcher,node_stable_diffusion,node_detectors toneIndigo
```

## Components

### Experiment inputs

- [Experiment config](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/config.yaml): `config.yaml`
- [Objects and lookalikes](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Data/objects_table.csv): `Data/objects_table.csv`
- [Environment check](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/00_environment_check.ipynb): `Code/00_environment_check.ipynb`

### Image workflow

- [Synthetic image generation](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/01_generate.ipynb): `Code/01_generate.ipynb`
- [Realism checks](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/02_validate.ipynb): `Code/02_validate.ipynb`

### Model evaluation

- [Detector fine-tuning](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/03_finetune.ipynb): `Code/03_finetune.ipynb`
- [Results and plots](https://github.com/almogschwartzberg/genai-shelter-validator/blob/dev/Code/04_results.ipynb): `Code/04_results.ipynb`

### Stored artifacts

- **Google Drive**

### Other components

- **Researcher**
- **Stable Diffusion**
- **Detection models**

## Connections

- Researcher → Environment check: runs first (evidence: `README.md`)
- Researcher → Synthetic image generation: runs workflow (evidence: `README.md`)
- Synthetic image generation → Stable Diffusion: generates with (evidence: `README.md`)
- Synthetic image generation → Realism checks: images checked by (evidence: `README.md`)
- Realism checks → Detector fine-tuning: workflow continues (evidence: `README.md`)
- Detector fine-tuning → Detection models: fine-tunes (evidence: `README.md`)
- Detector fine-tuning → Results and plots: evaluated in (evidence: `README.md`)
- Experiment config → Synthetic image generation: sets parameters (evidence: `README.md`)
- Experiment config → Detector fine-tuning: sets parameters (evidence: `README.md`)
- Objects and lookalikes → Synthetic image generation: describes targets (evidence: `README.md`)
- Environment check → Google Drive: checks access (evidence: `README.md`)
- Synthetic image generation → Google Drive: stores images (evidence: `README.md`)
- Detector fine-tuning → Google Drive: stores checkpoints (evidence: `README.md`)
- Results and plots → Google Drive: stores results (evidence: `README.md`)
