# dreamsartificial648-sketch/adam-architecture-v2 architecture

> Architecture diagram of the GitHub repository dreamsartificial648-sketch/adam-architecture-v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dreamsartificial648-sketch/adam-architecture-v2
- Repository: https://github.com/dreamsartificial648-sketch/adam-architecture-v2
- Video tour (about a minute): https://gitdiagram.com/dreamsartificial648-sketch/adam-architecture-v2/video

## Overview

ADAM is a desktop AI creation and training studio: users describe or configure work, the planner turns requests into plans, and jobs execute registered tools whose outputs become models, generated media, or datasets. The tree also indicates dedicated dataset/Oasis workflows, model and generation features, experiment tracking, and authenticated remote control. Wiring is clearest for application construction and job execution; several feature modules were not sampled, so their internal call paths are intentionally not inferred.

Main entry points: [`main_window.py`](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/main_window.py) (Studio UI), [`app.py`](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/app.py) (Application setup), [`remote_access.py`](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/remote_access.py) (Remote API), [`executor.py`](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/executor.py) (Tool executor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["Studio UI<br/>[main_window.py]"]
  node_bootstrap["Application setup<br/>[app.py]"]
end

subgraph group_jobs["Planning and Jobs"]
  node_planner["Request planner<br/>[planner.py]"]
  node_manager["Job manager<br/>[job_manager.py]"]
  node_executor["Tool executor<br/>[executor.py]"]
  node_registry["Tool registry<br/>[registry.py]"]
end

subgraph group_ai["AI Workflows"]
  node_training["Training workflows<br/>[studio.py]"]
  node_generation["Image generation<br/>[generations.py]"]
  node_preview["Live previews"]
  node_oasis["Oasis gameplay<br/>[oasis_player.py]"]
  node_reviewer["Frame reviewer<br/>[cnn_reviewer.py]"]
  node_search["Web search<br/>[web_search.py]"]
end

subgraph group_data["Assets and Remote"]
  node_datasets["Dataset workflows<br/>[dataset_lab.py]"]
  node_collectors["Dataset collection"]
  node_assets[("Asset registry<br/>[assets.py]")]
  node_experiments[("Experiment tracking")]
  node_remote["Remote API<br/>[remote_access.py]"]
  node_dispatch["Remote commands"]
  node_dashboard["Remote dashboard"]
end

node_user(("Studio user"))
node_browser(("Remote client"))
node_externaltools["Registered tools"]

node_user -->|"uses"| node_main
node_bootstrap -->|"constructs"| node_main
node_bootstrap -->|"constructs"| node_planner
node_bootstrap -->|"constructs"| node_registry
node_bootstrap -->|"constructs"| node_executor
node_bootstrap -->|"constructs"| node_manager
node_main -->|"plans requests"| node_planner
node_main -->|"controls jobs"| node_manager
node_planner -->|"looks up tools"| node_registry
node_manager -->|"runs steps"| node_executor
node_executor -->|"resolves tools"| node_registry
node_executor -->|"dispatches work"| node_externaltools
node_main -->|"opens workflow"| node_generation
node_main -->|"opens workflow"| node_datasets
node_main -->|"configures access"| node_remote
node_browser -->|"uses"| node_dashboard
node_dashboard -->|"requests API"| node_remote
node_remote -->|"dispatches commands"| node_dispatch
node_remote -->|"reads job state"| node_manager
node_remote -->|"plans requests"| node_planner
node_reviewer -->|"stores checkpoint"| node_assets

click node_main "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/main_window.py"
click node_bootstrap "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/app.py"
click node_planner "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/planner.py"
click node_manager "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/job_manager.py"
click node_executor "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/executor.py"
click node_registry "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/registry.py"
click node_training "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/studio.py"
click node_generation "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/generations.py"
click node_preview "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/generation_previews.py"
click node_oasis "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/oasis_player.py"
click node_reviewer "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/cnn_reviewer.py"
click node_datasets "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/dataset_lab.py"
click node_collectors "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/real_dataset_collector.py"
click node_assets "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/assets.py"
click node_experiments "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/experiment_tracker.py"
click node_remote "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/remote_access.py"
click node_dispatch "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/remote_dispatcher.py"
click node_dashboard "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/remote_dashboard.py"
click node_search "https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/web_search.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_main,node_bootstrap,node_user,node_browser toneBlue
class node_planner,node_manager,node_executor,node_registry toneAmber
class node_training,node_generation,node_preview,node_oasis,node_reviewer,node_search toneMint
class node_datasets,node_collectors,node_assets,node_experiments,node_remote,node_dispatch,node_dashboard toneRose
class node_externaltools toneIndigo
```

## Components

### Application

- [Studio UI](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/main_window.py): `main_window.py`
- [Application setup](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/app.py): `app.py`

### Planning and Jobs

- [Request planner](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/planner.py): `planner.py`
- [Job manager](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/job_manager.py): `job_manager.py`
- [Tool executor](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/executor.py): `executor.py`
- [Tool registry](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/registry.py): `registry.py`

### AI Workflows

- [Training workflows](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/studio.py): `studio.py`
- [Image generation](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/generations.py): `generations.py`
- [Live previews](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/generation_previews.py): `generation_previews.py`
- [Oasis gameplay](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/oasis_player.py): `oasis_player.py`
- [Frame reviewer](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/cnn_reviewer.py): `cnn_reviewer.py`
- [Web search](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/web_search.py): `web_search.py`

### Assets and Remote

- [Dataset workflows](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/dataset_lab.py): `dataset_lab.py`
- [Dataset collection](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/real_dataset_collector.py): `real_dataset_collector.py`
- [Asset registry](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/assets.py): `assets.py`
- [Experiment tracking](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/experiment_tracker.py): `experiment_tracker.py`
- [Remote API](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/remote_access.py): `remote_access.py`
- [Remote commands](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/remote_dispatcher.py): `remote_dispatcher.py`
- [Remote dashboard](https://github.com/dreamsartificial648-sketch/adam-architecture-v2/blob/main/remote_dashboard.py): `remote_dashboard.py`

### Other components

- **Studio user**
- **Remote client**
- **Registered tools**

## Connections

- Studio user → Studio UI: uses
- Application setup → Studio UI: constructs
- Application setup → Request planner: constructs
- Application setup → Tool registry: constructs
- Application setup → Tool executor: constructs
- Application setup → Job manager: constructs
- Studio UI → Request planner: plans requests
- Studio UI → Job manager: controls jobs
- Request planner → Tool registry: looks up tools
- Job manager → Tool executor: runs steps
- Tool executor → Tool registry: resolves tools
- Tool executor → Registered tools: dispatches work
- Studio UI → Image generation: opens workflow
- Studio UI → Dataset workflows: opens workflow
- Studio UI → Remote API: configures access
- Remote client → Remote dashboard: uses
- Remote dashboard → Remote API: requests API
- Remote API → Remote commands: dispatches commands
- Remote API → Job manager: reads job state
- Remote API → Request planner: plans requests
- Frame reviewer → Asset registry: stores checkpoint