# whispergate/erebus architecture

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

- Interactive diagram: https://gitdiagram.com/whispergate/erebus
- Repository: https://github.com/whispergate/erebus

## Overview

Erebus is a Mythic initial-access payload and delivery-chain wrapper. An operator configures a build in Mythic; the builder coordinates plugin-backed payload, trigger, and container capabilities to produce delivery artifacts. Other documented branches include obfuscation, signing, persistence, infrastructure generation, and validation-oriented utilities. The graph reflects documented capabilities and indexed source references; many plugin implementations were not sampled, so uncertain internal call paths are omitted.

Main entry points: [`Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py) (Build coordinator), [`Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py`](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py) (Plugin loader), [`Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_payload_maldocs.py`](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_payload_maldocs.py) (Office documents), [`Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_base.py`](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_base.py) (Plugin interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Build orchestration"]
  node_mythic["Mythic runtime"]
  node_builder["Build coordinator<br/>[builder.py]"]
  node_plugin_loader["Plugin loader<br/>[plugin_loader.py]"]
  node_plugin_base["Plugin interface<br/>[plugin_base.py]"]
end

subgraph group_payload["Payload generation"]
  node_loaders["Payload loaders<br/>[plugin_loader.py]"]
  node_maldocs["Office documents"]
  node_vba_compiler["VBA compiler<br/>[compiler.py]"]
  node_matrix["MalDoc matrix<br/>[maldoc_matrix.py]"]
end

subgraph group_delivery["Delivery construction"]
  node_triggers["Trigger plugins"]
  node_containers["Container plugins"]
end

subgraph group_support["Build capabilities"]
  node_obfuscation["Shellcrypt options"]
  node_signing["Code signing"]
  node_persistence["Persistence plugins"]
  node_infra["Infrastructure tools"]
  node_validation["PE and hunt tools"]
end

node_operator(("Operator"))
node_artifact["Delivery artifact"]

node_operator -->|"configures build"| node_mythic
node_mythic -->|"starts service"| node_builder
node_builder -->|"loads plugins"| node_plugin_loader
node_plugin_loader -->|"discovers implementations"| node_plugin_base
node_builder -->|"builds payloads"| node_loaders
node_builder -->|"builds documents"| node_maldocs
node_maldocs -->|"compiles VBA"| node_vba_compiler
node_builder -->|"runs matrix"| node_matrix
node_builder -->|"selects trigger"| node_triggers
node_builder -->|"packages payload"| node_containers
node_builder -->|"configures obfuscation"| node_obfuscation
node_builder -->|"applies signing"| node_signing
node_builder -->|"offers persistence"| node_persistence
node_builder -->|"generates infrastructure"| node_infra
node_builder -->|"offers validation"| node_validation
node_builder -->|"produces build"| node_artifact

click node_builder "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py"
click node_plugin_loader "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py"
click node_plugin_base "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_base.py"
click node_loaders "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py"
click node_maldocs "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_payload_maldocs.py"
click node_vba_compiler "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/agent_code/vba_compiler/compiler.py"
click node_matrix "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/maldoc_matrix.py"
click node_triggers "https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules"
click node_containers "https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules"
click node_obfuscation "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_shellcode_obfuscation.py"
click node_signing "https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_codesigner.py"
click node_persistence "https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules"
click node_infra "https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules"
click node_validation "https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules"

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_mythic,node_builder,node_plugin_loader,node_plugin_base toneBlue
class node_loaders,node_maldocs,node_vba_compiler,node_matrix toneAmber
class node_triggers,node_containers toneMint
class node_obfuscation,node_signing,node_persistence,node_infra,node_validation toneRose
class node_operator,node_artifact toneIndigo
```

## Components

### Build orchestration

- **Mythic runtime**
- [Build coordinator](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`
- [Plugin loader](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py`
- [Plugin interface](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_base.py): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_base.py`

### Payload generation

- [Payload loaders](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_loader.py`
- [Office documents](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_payload_maldocs.py): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_payload_maldocs.py`
- [VBA compiler](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/agent_code/vba_compiler/compiler.py): `Payload_Type/erebus_wrapper/erebus_wrapper/agent_code/vba_compiler/compiler.py`
- [MalDoc matrix](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/maldoc_matrix.py): `Payload_Type/erebus_wrapper/erebus_wrapper/maldoc_matrix.py`

### Delivery construction

- [Trigger plugins](https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules`
- [Container plugins](https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules`

### Build capabilities

- [Shellcrypt options](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_shellcode_obfuscation.py): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_shellcode_obfuscation.py`
- [Code signing](https://github.com/whispergate/erebus/blob/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_codesigner.py): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_codesigner.py`
- [Persistence plugins](https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules`
- [Infrastructure tools](https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules`
- [PE and hunt tools](https://github.com/whispergate/erebus/tree/main/Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules): `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules`

### Other components

- **Operator**
- **Delivery artifact**

## Connections

- Operator → Mythic runtime: configures build
- Mythic runtime → Build coordinator: starts service
- Build coordinator → Plugin loader: loads plugins (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Plugin loader → Plugin interface: discovers implementations (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_base.py`)
- Build coordinator → Payload loaders: builds payloads (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Build coordinator → Office documents: builds documents (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Office documents → VBA compiler: compiles VBA (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/modules/plugin_payload_maldocs.py`)
- Build coordinator → MalDoc matrix: runs matrix (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Build coordinator → Trigger plugins: selects trigger (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Build coordinator → Container plugins: packages payload (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Build coordinator → Shellcrypt options: configures obfuscation
- Build coordinator → Code signing: applies signing
- Build coordinator → Persistence plugins: offers persistence (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Build coordinator → Infrastructure tools: generates infrastructure (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Build coordinator → PE and hunt tools: offers validation (evidence: `Payload_Type/erebus_wrapper/erebus_wrapper/erebus/builder.py`)
- Build coordinator → Delivery artifact: produces build
