# invoke-ai/invokeai architecture

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

- Interactive diagram: https://gitdiagram.com/invoke-ai/invokeai
- Repository: https://github.com/invoke-ai/invokeai

## Overview

InvokeAI is a locally hosted creative engine for generating and refining visual media. Users work in the web UI, create node workflows or edit on the unified canvas, and receive generated media that can be organized and revisited in boards and the gallery. The README documents these capabilities; the source tree identifies the API, invocation, model-management, and persistence subsystems. Several runtime connections are therefore shown only where documented, or left unlinked where sampled evidence does not establish their caller.

Main entry points: [`invokeai/app/invocations`](https://github.com/invoke-ai/invokeai/tree/main/invokeai/app/invocations) (Invocation nodes), [`invokeai/frontend/webv2/src`](https://github.com/invoke-ai/invokeai/tree/main/invokeai/frontend/webv2/src) (Web UI), [`invokeai/app/api/routers/boards.py`](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/boards.py) (Boards and gallery), [`invokeai/app/run_app.py`](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/run_app.py) (Web server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Creative interface"]
  node_webui["Web UI"]
  node_canvas["Unified canvas<br/>[engine.ts]"]
end

subgraph group_api["Application API"]
  node_server["Web server<br/>[run_app.py]"]
  node_api_routes["API routes"]
end

subgraph group_generation["Workflow generation"]
  node_workflows["Workflow management<br/>[workflows.py]"]
  node_invocations["Invocation nodes"]
  node_diffusion["Diffusion pipeline"]
  node_text_llm["Text LLM pipeline"]
end

subgraph group_models["Models and integrations"]
  node_model_api["Model API<br/>[model_manager.py]"]
  node_model_manager["Model manager"]
  node_model_configs["Model configuration<br/>[factory.py]"]
  node_external_gen["External generation"]
end

subgraph group_workspace["Media workspace"]
  node_boards["Boards and gallery<br/>[boards.py]"]
  node_images["Image records<br/>[images.py]"]
  node_videos["Video features<br/>[videos.py]"]
  node_database[("Application database<br/>[engines.py]")]
end

node_artist(("Artist"))

node_artist -->|"uses"| node_webui
node_webui -->|"uses"| node_server
node_artist -->|"edits media"| node_canvas
node_webui -->|"manages workflows"| node_workflows
node_server -.->|"serves"| node_api_routes
node_workflows -->|"runs nodes"| node_invocations
node_invocations -.->|"generates media"| node_diffusion
node_invocations -.->|"runs text models"| node_text_llm
node_model_api -->|"manages models"| node_model_manager
node_model_manager -->|"uses configurations"| node_model_configs
node_invocations -->|"supports providers"| node_external_gen
node_artist -->|"organizes media"| node_boards
node_boards -.->|"manages images"| node_images
node_artist -->|"uses video models"| node_videos
node_boards -.->|"persists records"| node_database
node_images -.->|"persists records"| node_database

click node_webui "https://github.com/invoke-ai/invokeai/tree/main/invokeai/frontend/webv2/src"
click node_canvas "https://github.com/invoke-ai/invokeai/blob/main/invokeai/frontend/webv2/src/workbench/canvas-engine/engine.ts"
click node_server "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/run_app.py"
click node_api_routes "https://github.com/invoke-ai/invokeai/tree/main/invokeai/app/api/routers"
click node_workflows "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/workflows.py"
click node_invocations "https://github.com/invoke-ai/invokeai/tree/main/invokeai/app/invocations"
click node_diffusion "https://github.com/invoke-ai/invokeai/blob/main/invokeai/backend/stable_diffusion/diffusers_pipeline.py"
click node_text_llm "https://github.com/invoke-ai/invokeai/blob/main/invokeai/backend/text_llm_pipeline.py"
click node_model_api "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/model_manager.py"
click node_model_manager "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/services/model_manager/model_manager_default.py"
click node_model_configs "https://github.com/invoke-ai/invokeai/blob/main/invokeai/backend/model_manager/configs/factory.py"
click node_external_gen "https://github.com/invoke-ai/invokeai/tree/main/invokeai/app/services/external_generation/providers"
click node_boards "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/boards.py"
click node_images "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/images.py"
click node_videos "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/videos.py"
click node_database "https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/services/shared/database/engines.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_webui,node_canvas toneBlue
class node_server,node_api_routes toneAmber
class node_workflows,node_invocations,node_diffusion,node_text_llm toneMint
class node_model_api,node_model_manager,node_model_configs,node_external_gen toneRose
class node_boards,node_images,node_videos,node_database,node_artist toneIndigo
```

## Components

### Creative interface

- [Web UI](https://github.com/invoke-ai/invokeai/tree/main/invokeai/frontend/webv2/src): `invokeai/frontend/webv2/src`
- [Unified canvas](https://github.com/invoke-ai/invokeai/blob/main/invokeai/frontend/webv2/src/workbench/canvas-engine/engine.ts): `invokeai/frontend/webv2/src/workbench/canvas-engine/engine.ts`

### Application API

- [Web server](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/run_app.py): `invokeai/app/run_app.py`
- [API routes](https://github.com/invoke-ai/invokeai/tree/main/invokeai/app/api/routers): `invokeai/app/api/routers`

### Workflow generation

- [Workflow management](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/workflows.py): `invokeai/app/api/routers/workflows.py`
- [Invocation nodes](https://github.com/invoke-ai/invokeai/tree/main/invokeai/app/invocations): `invokeai/app/invocations`
- [Diffusion pipeline](https://github.com/invoke-ai/invokeai/blob/main/invokeai/backend/stable_diffusion/diffusers_pipeline.py): `invokeai/backend/stable_diffusion/diffusers_pipeline.py`
- [Text LLM pipeline](https://github.com/invoke-ai/invokeai/blob/main/invokeai/backend/text_llm_pipeline.py): `invokeai/backend/text_llm_pipeline.py`

### Models and integrations

- [Model API](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/model_manager.py): `invokeai/app/api/routers/model_manager.py`
- [Model manager](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/services/model_manager/model_manager_default.py): `invokeai/app/services/model_manager/model_manager_default.py`
- [Model configuration](https://github.com/invoke-ai/invokeai/blob/main/invokeai/backend/model_manager/configs/factory.py): `invokeai/backend/model_manager/configs/factory.py`
- [External generation](https://github.com/invoke-ai/invokeai/tree/main/invokeai/app/services/external_generation/providers): `invokeai/app/services/external_generation/providers`

### Media workspace

- [Boards and gallery](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/boards.py): `invokeai/app/api/routers/boards.py`
- [Image records](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/images.py): `invokeai/app/api/routers/images.py`
- [Video features](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/api/routers/videos.py): `invokeai/app/api/routers/videos.py`
- [Application database](https://github.com/invoke-ai/invokeai/blob/main/invokeai/app/services/shared/database/engines.py): `invokeai/app/services/shared/database/engines.py`

### Other components

- **Artist**

## Connections

- Artist → Web UI: uses
- Web UI → Web server: uses
- Artist → Unified canvas: edits media
- Web UI → Workflow management: manages workflows
- Web server → API routes: serves
- Workflow management → Invocation nodes: runs nodes
- Invocation nodes → Diffusion pipeline: generates media
- Invocation nodes → Text LLM pipeline: runs text models
- Model API → Model manager: manages models (evidence: `invokeai/app/api/routers/model_manager.py`)
- Model manager → Model configuration: uses configurations (evidence: `invokeai/app/services/model_manager/model_manager_default.py`)
- Invocation nodes → External generation: supports providers
- Artist → Boards and gallery: organizes media
- Boards and gallery → Image records: manages images
- Artist → Video features: uses video models
- Boards and gallery → Application database: persists records
- Image records → Application database: persists records
