# aquacash5/magic-wormhole-exe architecture

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

## Overview

This repository creates a Windows executable for magic-wormhole. The visible runtime entry point invokes magic-wormhole’s CLI; PyInstaller hooks collect dependencies needed when packaging it. The tree also names executable, Chocolatey, and WinGet workflows, but their contents were not sampled, so their relationships are left unverified. The README identifies the product but does not describe its release flow.

Main entry points: [`.github/workflows/create-executable.yml`](https://github.com/aquacash5/magic-wormhole-exe/blob/main/.github/workflows/create-executable.yml) (Create executable), [`launcher.py`](https://github.com/aquacash5/magic-wormhole-exe/blob/main/launcher.py) (CLI launcher), [`hooks/hook-autobahn.py`](https://github.com/aquacash5/magic-wormhole-exe/blob/main/hooks/hook-autobahn.py) (Autobahn hook), [`hooks/hook-humanize.py`](https://github.com/aquacash5/magic-wormhole-exe/blob/main/hooks/hook-humanize.py) (Humanize hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Executable runtime"]
  node_launcher["CLI launcher<br/>[launcher.py]"]
  node_wormhole_cli["Wormhole CLI"]
end

subgraph group_packaging["Packaging support"]
  node_autobahn_hook["Autobahn hook<br/>[hook-autobahn.py]"]
  node_humanize_hook["Humanize hook<br/>[hook-humanize.py]"]
end

subgraph group_release["Build and release"]
  node_exe_workflow["Create executable"]
  node_chocolatey_release["Chocolatey release"]
  node_winget_release["WinGet release<br/>[release-winget.yml]"]
end

node_user(("User"))
node_autobahn["Autobahn package"]
node_humanize["Humanize package"]

node_launcher -->|"invokes"| node_wormhole_cli
node_autobahn_hook -->|"collects files"| node_autobahn
node_humanize_hook -->|"collects files"| node_humanize
node_user -.->|"requests build"| node_exe_workflow
node_exe_workflow -.->|"packages"| node_launcher
node_chocolatey_release -.->|"releases build"| node_exe_workflow
node_winget_release -.->|"releases build"| node_exe_workflow

click node_exe_workflow "https://github.com/aquacash5/magic-wormhole-exe/blob/main/.github/workflows/create-executable.yml"
click node_launcher "https://github.com/aquacash5/magic-wormhole-exe/blob/main/launcher.py"
click node_autobahn_hook "https://github.com/aquacash5/magic-wormhole-exe/blob/main/hooks/hook-autobahn.py"
click node_humanize_hook "https://github.com/aquacash5/magic-wormhole-exe/blob/main/hooks/hook-humanize.py"
click node_chocolatey_release "https://github.com/aquacash5/magic-wormhole-exe/blob/main/.github/workflows/release-chocolatey.yml"
click node_winget_release "https://github.com/aquacash5/magic-wormhole-exe/blob/main/.github/workflows/release-winget.yml"

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_launcher,node_wormhole_cli,node_user toneBlue
class node_autobahn_hook,node_humanize_hook toneAmber
class node_exe_workflow,node_chocolatey_release,node_winget_release toneMint
class node_autobahn,node_humanize toneIndigo
```

## Components

### Executable runtime

- [CLI launcher](https://github.com/aquacash5/magic-wormhole-exe/blob/main/launcher.py): `launcher.py`
- **Wormhole CLI**

### Packaging support

- [Autobahn hook](https://github.com/aquacash5/magic-wormhole-exe/blob/main/hooks/hook-autobahn.py): `hooks/hook-autobahn.py`
- [Humanize hook](https://github.com/aquacash5/magic-wormhole-exe/blob/main/hooks/hook-humanize.py): `hooks/hook-humanize.py`

### Build and release

- [Create executable](https://github.com/aquacash5/magic-wormhole-exe/blob/main/.github/workflows/create-executable.yml): `.github/workflows/create-executable.yml`
- [Chocolatey release](https://github.com/aquacash5/magic-wormhole-exe/blob/main/.github/workflows/release-chocolatey.yml): `.github/workflows/release-chocolatey.yml`
- [WinGet release](https://github.com/aquacash5/magic-wormhole-exe/blob/main/.github/workflows/release-winget.yml): `.github/workflows/release-winget.yml`

### Other components

- **User**
- **Autobahn package**
- **Humanize package**

## Connections

- CLI launcher → Wormhole CLI: invokes (evidence: `launcher.py`)
- Autobahn hook → Autobahn package: collects files (evidence: `hooks/hook-autobahn.py`)
- Humanize hook → Humanize package: collects files (evidence: `hooks/hook-humanize.py`)
- User → Create executable: requests build
- Create executable → CLI launcher: packages
- Chocolatey release → Create executable: releases build
- WinGet release → Create executable: releases build
