# spyder-ide/spyder architecture

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

## Overview

Spyder is a desktop scientific Python development environment. Its principal workflow is a user working in the editor, requesting language assistance, and running or debugging code in an interactive console. The architecture also includes project/file browsing, variable inspection, help, and a plugin-based Qt application. The tree and source index establish these product areas, but many plugin implementations were not excerpted; their connections are therefore omitted or marked unverified rather than presented as inspected call paths.

Main entry points: [`spyder/app/mainwindow.py`](https://github.com/spyder-ide/spyder/blob/master/spyder/app/mainwindow.py) (Main window), [`spyder/api/plugins/new_api.py`](https://github.com/spyder-ide/spyder/blob/master/spyder/api/plugins/new_api.py) (Plugin API), [`spyder/plugins/ipythonconsole/widgets/client.py`](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/ipythonconsole/widgets/client.py) (IPython console), [`spyder/utils/icon_manager.py`](https://github.com/spyder-ide/spyder/blob/master/spyder/utils/icon_manager.py) (Icon manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application framework"]
  node_mainwindow["Main window<br/>[mainwindow.py]"]
  node_pluginapi["Plugin API<br/>[new_api.py]"]
  node_registry["Plugin registry<br/>[registry.py]"]
end

subgraph group_work["Code workflow"]
  node_editor["Code editor<br/>[codeeditor.py]"]
  node_editorplugin["Editor plugin<br/>[plugin.py]"]
  node_completion["Code completion"]
  node_languageserver["Language servers<br/>[provider.py]"]
  node_explorer["File explorer<br/>[plugin.py]"]
  node_help["Help browser<br/>[plugin.py]"]
end

subgraph group_runtime["Execution and inspection"]
  node_console["IPython console<br/>[client.py]"]
  node_consolemanager["Kernel manager<br/>[manager.py]"]
  node_qtclient["Qt console client<br/>[client.py]"]
  node_kernel["Spyder kernel<br/>[kernel.py]"]
  node_debugger["Debugger<br/>[plugin.py]"]
  node_variables["Variable explorer"]
end

subgraph group_foundation["Shared foundation"]
  node_config[("Configuration")]
  node_configmixins["Config observers<br/>[mixins.py]"]
  node_uiwidgets["Widget framework<br/>[mixins.py]"]
  node_sharedutils["UI and system utilities"]
  node_icons["Icon manager<br/>[icon_manager.py]"]
  node_images["Image paths"]
  node_themes["Themes and styles<br/>[theme_manager.py]"]
end

node_user(("Developer"))

node_user -.->|"uses"| node_mainwindow
node_mainwindow -->|"loads plugins"| node_registry
node_mainwindow -->|"reads settings"| node_config
node_mainwindow -.->|"uses API"| node_pluginapi
node_pluginapi -->|"uses"| node_configmixins
node_pluginapi -->|"uses"| node_uiwidgets
node_pluginapi -->|"uses"| node_icons
node_pluginapi -->|"uses"| node_themes
node_uiwidgets -->|"uses"| node_icons
node_uiwidgets -->|"resolves images"| node_images
node_configmixins -->|"reads settings"| node_config
node_icons -->|"reads settings"| node_config
node_icons -->|"resolves images"| node_images
node_themes -.->|"reads settings"| node_config
node_editor -.->|"requests assistance"| node_completion
node_completion -.->|"uses provider"| node_languageserver
node_console -.->|"uses manager"| node_consolemanager
node_consolemanager -->|"creates client"| node_qtclient
node_qtclient -.->|"connects to"| node_kernel
node_console -.->|"inspects values"| node_variables
node_console -.->|"debugs execution"| node_debugger
node_mainwindow -.->|"hosts plugin"| node_editorplugin
node_mainwindow -.->|"hosts plugin"| node_console
node_mainwindow -.->|"hosts plugin"| node_explorer
node_mainwindow -.->|"hosts plugin"| node_help

click node_mainwindow "https://github.com/spyder-ide/spyder/blob/master/spyder/app/mainwindow.py"
click node_pluginapi "https://github.com/spyder-ide/spyder/blob/master/spyder/api/plugins/new_api.py"
click node_registry "https://github.com/spyder-ide/spyder/blob/master/spyder/api/plugin_registration/registry.py"
click node_config "https://github.com/spyder-ide/spyder/tree/master/spyder/config"
click node_configmixins "https://github.com/spyder-ide/spyder/blob/master/spyder/api/config/mixins.py"
click node_uiwidgets "https://github.com/spyder-ide/spyder/blob/master/spyder/api/widgets/mixins.py"
click node_sharedutils "https://github.com/spyder-ide/spyder/tree/master/spyder/utils"
click node_icons "https://github.com/spyder-ide/spyder/blob/master/spyder/utils/icon_manager.py"
click node_images "https://github.com/spyder-ide/spyder/blob/master/spyder/utils/image_path_manager.py"
click node_themes "https://github.com/spyder-ide/spyder/blob/master/spyder/utils/theme_manager.py"
click node_editor "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/editor/widgets/codeeditor/codeeditor.py"
click node_editorplugin "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/editor/plugin.py"
click node_completion "https://github.com/spyder-ide/spyder/tree/master/spyder/plugins/completion/providers"
click node_languageserver "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/completion/providers/languageserver/provider.py"
click node_console "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/ipythonconsole/widgets/client.py"
click node_consolemanager "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/ipythonconsole/utils/manager.py"
click node_qtclient "https://github.com/spyder-ide/spyder/blob/master/external-deps/qtconsole/qtconsole/client.py"
click node_kernel "https://github.com/spyder-ide/spyder/blob/master/external-deps/spyder-kernels/spyder_kernels/console/kernel.py"
click node_debugger "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/debugger/plugin.py"
click node_variables "https://github.com/spyder-ide/spyder/blob/master/spyder/widgets/collectionseditor.py"
click node_explorer "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/explorer/plugin.py"
click node_help "https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/help/plugin.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_mainwindow,node_pluginapi,node_registry toneBlue
class node_editor,node_editorplugin,node_completion,node_languageserver,node_explorer,node_help toneAmber
class node_console,node_consolemanager,node_qtclient,node_kernel,node_debugger,node_variables toneMint
class node_config,node_configmixins,node_uiwidgets,node_sharedutils,node_icons,node_images,node_themes toneRose
class node_user toneIndigo
```

## Components

### Application framework

- [Main window](https://github.com/spyder-ide/spyder/blob/master/spyder/app/mainwindow.py): `spyder/app/mainwindow.py`
- [Plugin API](https://github.com/spyder-ide/spyder/blob/master/spyder/api/plugins/new_api.py): `spyder/api/plugins/new_api.py`
- [Plugin registry](https://github.com/spyder-ide/spyder/blob/master/spyder/api/plugin_registration/registry.py): `spyder/api/plugin_registration/registry.py`

### Code workflow

- [Code editor](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/editor/widgets/codeeditor/codeeditor.py): `spyder/plugins/editor/widgets/codeeditor/codeeditor.py`
- [Editor plugin](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/editor/plugin.py): `spyder/plugins/editor/plugin.py`
- [Code completion](https://github.com/spyder-ide/spyder/tree/master/spyder/plugins/completion/providers): `spyder/plugins/completion/providers`
- [Language servers](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/completion/providers/languageserver/provider.py): `spyder/plugins/completion/providers/languageserver/provider.py`
- [File explorer](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/explorer/plugin.py): `spyder/plugins/explorer/plugin.py`
- [Help browser](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/help/plugin.py): `spyder/plugins/help/plugin.py`

### Execution and inspection

- [IPython console](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/ipythonconsole/widgets/client.py): `spyder/plugins/ipythonconsole/widgets/client.py`
- [Kernel manager](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/ipythonconsole/utils/manager.py): `spyder/plugins/ipythonconsole/utils/manager.py`
- [Qt console client](https://github.com/spyder-ide/spyder/blob/master/external-deps/qtconsole/qtconsole/client.py): `external-deps/qtconsole/qtconsole/client.py`
- [Spyder kernel](https://github.com/spyder-ide/spyder/blob/master/external-deps/spyder-kernels/spyder_kernels/console/kernel.py): `external-deps/spyder-kernels/spyder_kernels/console/kernel.py`
- [Debugger](https://github.com/spyder-ide/spyder/blob/master/spyder/plugins/debugger/plugin.py): `spyder/plugins/debugger/plugin.py`
- [Variable explorer](https://github.com/spyder-ide/spyder/blob/master/spyder/widgets/collectionseditor.py): `spyder/widgets/collectionseditor.py`

### Shared foundation

- [Configuration](https://github.com/spyder-ide/spyder/tree/master/spyder/config): `spyder/config`
- [Config observers](https://github.com/spyder-ide/spyder/blob/master/spyder/api/config/mixins.py): `spyder/api/config/mixins.py`
- [Widget framework](https://github.com/spyder-ide/spyder/blob/master/spyder/api/widgets/mixins.py): `spyder/api/widgets/mixins.py`
- [UI and system utilities](https://github.com/spyder-ide/spyder/tree/master/spyder/utils): `spyder/utils`
- [Icon manager](https://github.com/spyder-ide/spyder/blob/master/spyder/utils/icon_manager.py): `spyder/utils/icon_manager.py`
- [Image paths](https://github.com/spyder-ide/spyder/blob/master/spyder/utils/image_path_manager.py): `spyder/utils/image_path_manager.py`
- [Themes and styles](https://github.com/spyder-ide/spyder/blob/master/spyder/utils/theme_manager.py): `spyder/utils/theme_manager.py`

### Other components

- **Developer**

## Connections

- Developer → Main window: uses
- Main window → Plugin registry: loads plugins (evidence: `spyder/app/mainwindow.py`)
- Main window → Configuration: reads settings (evidence: `spyder/app/mainwindow.py`)
- Main window → Plugin API: uses API (evidence: `spyder/api/plugins/new_api.py`)
- Plugin API → Config observers: uses (evidence: `spyder/api/plugins/new_api.py`)
- Plugin API → Widget framework: uses (evidence: `spyder/api/plugins/new_api.py`)
- Plugin API → Icon manager: uses (evidence: `spyder/api/plugins/new_api.py`)
- Plugin API → Themes and styles: uses (evidence: `spyder/api/plugins/new_api.py`)
- Widget framework → Icon manager: uses (evidence: `spyder/api/widgets/mixins.py`)
- Widget framework → Image paths: resolves images (evidence: `spyder/api/widgets/mixins.py`)
- Config observers → Configuration: reads settings (evidence: `spyder/api/config/mixins.py`)
- Icon manager → Configuration: reads settings (evidence: `spyder/utils/icon_manager.py`)
- Icon manager → Image paths: resolves images (evidence: `spyder/utils/icon_manager.py`)
- Themes and styles → Configuration: reads settings
- Code editor → Code completion: requests assistance
- Code completion → Language servers: uses provider
- IPython console → Kernel manager: uses manager
- Kernel manager → Qt console client: creates client (evidence: `spyder/plugins/ipythonconsole/utils/manager.py`)
- Qt console client → Spyder kernel: connects to
- IPython console → Variable explorer: inspects values
- IPython console → Debugger: debugs execution
- Main window → Editor plugin: hosts plugin
- Main window → IPython console: hosts plugin
- Main window → File explorer: hosts plugin
- Main window → Help browser: hosts plugin
