# mu-editor/mu-tate architecture

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

## Overview

Mu-tate is an experimental Electron-based Python code editor. The documented application workflow is launching the Electron window and loading the editor interface; however, the sampled editor code only creates Ace editors and the sampled Mu module is a stub. The README also documents separate developer utilities for obtaining Ace and standalone Python runtimes. The UI markup and runtime wiring were not sampled, so relationships beyond those explicitly shown are omitted.

Main entry points: [`utils/get_ace.py`](https://github.com/mu-editor/mu-tate/blob/master/utils/get_ace.py) (Ace updater), [`utils/get_python.py`](https://github.com/mu-editor/mu-tate/blob/master/utils/get_python.py) (Python updater), [`mu/main.js`](https://github.com/mu-editor/mu-tate/blob/master/mu/main.js) (Application window), [`mu/js`](https://github.com/mu-editor/mu-tate/tree/master/mu/js) (Ace assets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Editor application"]
  node_window["Application window<br/>[main.js]"]
  node_interface["Editor interface<br/>[index.html]"]
  node_ace_editors["Ace editor instances<br/>[editor.js]"]
  node_mu_api["Mu editor API<br/>[mu.js]"]
end

subgraph group_assets["Runtime assets"]
  node_ace_assets["Ace assets"]
  node_python_runtime["Embedded Python"]
  node_versions["Asset versions<br/>[versions.json]"]
end

subgraph group_tools["Asset utilities"]
  node_ace_tool["Ace updater<br/>[get_ace.py]"]
  node_python_tool["Python updater<br/>[get_python.py]"]
end

node_user(("User"))
node_electron["Electron runtime"]
node_ace_service["Ace release service"]
node_python_service["Python release service"]

node_user -->|"launches"| node_electron
node_electron -->|"initializes"| node_window
node_window -->|"loads"| node_interface
node_ace_editors -.->|"uses"| node_ace_assets
node_ace_tool -->|"fetches releases"| node_ace_service
node_ace_tool -->|"installs assets"| node_ace_assets
node_ace_tool -->|"updates"| node_versions
node_python_tool -->|"fetches releases"| node_python_service
node_python_tool -->|"installs runtimes"| node_python_runtime
node_python_tool -->|"updates"| node_versions

click node_window "https://github.com/mu-editor/mu-tate/blob/master/mu/main.js"
click node_interface "https://github.com/mu-editor/mu-tate/blob/master/mu/index.html"
click node_ace_editors "https://github.com/mu-editor/mu-tate/blob/master/mu/editor.js"
click node_mu_api "https://github.com/mu-editor/mu-tate/blob/master/mu/js/mu.js"
click node_ace_assets "https://github.com/mu-editor/mu-tate/tree/master/mu/js"
click node_versions "https://github.com/mu-editor/mu-tate/blob/master/versions.json"
click node_ace_tool "https://github.com/mu-editor/mu-tate/blob/master/utils/get_ace.py"
click node_python_tool "https://github.com/mu-editor/mu-tate/blob/master/utils/get_python.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_window,node_interface,node_ace_editors,node_mu_api,node_user toneBlue
class node_ace_assets,node_python_runtime,node_versions toneAmber
class node_ace_tool,node_python_tool toneMint
class node_electron,node_ace_service,node_python_service toneIndigo
```

## Components

### Editor application

- [Application window](https://github.com/mu-editor/mu-tate/blob/master/mu/main.js): `mu/main.js`
- [Editor interface](https://github.com/mu-editor/mu-tate/blob/master/mu/index.html): `mu/index.html`
- [Ace editor instances](https://github.com/mu-editor/mu-tate/blob/master/mu/editor.js): `mu/editor.js`
- [Mu editor API](https://github.com/mu-editor/mu-tate/blob/master/mu/js/mu.js): `mu/js/mu.js`

### Runtime assets

- [Ace assets](https://github.com/mu-editor/mu-tate/tree/master/mu/js): `mu/js`
- **Embedded Python**
- [Asset versions](https://github.com/mu-editor/mu-tate/blob/master/versions.json): `versions.json`

### Asset utilities

- [Ace updater](https://github.com/mu-editor/mu-tate/blob/master/utils/get_ace.py): `utils/get_ace.py`
- [Python updater](https://github.com/mu-editor/mu-tate/blob/master/utils/get_python.py): `utils/get_python.py`

### Other components

- **User**
- **Electron runtime**
- **Ace release service**
- **Python release service**

## Connections

- User → Electron runtime: launches (evidence: `README.md`)
- Electron runtime → Application window: initializes (evidence: `mu/main.js`)
- Application window → Editor interface: loads (evidence: `mu/main.js`)
- Ace editor instances → Ace assets: uses
- Ace updater → Ace release service: fetches releases (evidence: `utils/get_ace.py`)
- Ace updater → Ace assets: installs assets (evidence: `utils/get_ace.py`)
- Ace updater → Asset versions: updates (evidence: `utils/get_ace.py`)
- Python updater → Python release service: fetches releases (evidence: `utils/get_python.py`)
- Python updater → Embedded Python: installs runtimes (evidence: `utils/get_python.py`)
- Python updater → Asset versions: updates (evidence: `utils/get_python.py`)
