# ghostoraner/exprin architecture

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

- Interactive diagram: https://gitdiagram.com/ghostoraner/exprin
- Repository: https://github.com/ghostoraner/exprin

## Overview

Exprin is a command-line HTTP load-generation tool. Its workflow gathers machine-based recommendations, accepts a target and run parameters, starts concurrent request workers, and displays live status and request counts. The README also advertises randomized request headers and configurable request volume. Source excerpts show the main orchestration and worker behavior; the graph summarizes these components without detailing attack techniques.

Main entry points: [`main.py`](https://github.com/ghostoraner/exprin/blob/main/main.py) (CLI orchestrator), [`attack_engine.py`](https://github.com/ghostoraner/exprin/blob/main/attack_engine.py) (Request workers), [`system_profiler.py`](https://github.com/ghostoraner/exprin/blob/main/system_profiler.py) (System recommendations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_main["CLI orchestrator<br/>[main.py]"]
  node_configuration["Run configuration<br/>[main.py]"]
  node_live_view["Live status view<br/>[main.py]"]
end

subgraph group_runtime["Request runtime"]
  node_workers["Request workers<br/>[attack_engine.py]"]
end

subgraph group_profile["System profiling"]
  node_profiler["System recommendations<br/>[system_profiler.py]"]
end

node_operator(("Operator"))
node_target[("HTTP target")]

node_operator -->|"starts program"| node_main
node_main -->|"gets recommendations"| node_profiler
node_main -->|"collects parameters"| node_configuration
node_configuration -->|"prompts"| node_operator
node_main -->|"starts workers"| node_workers
node_workers -->|"sends HTTP requests"| node_target
node_workers -->|"updates shared counts"| node_main
node_main -->|"renders run status"| node_live_view
node_main -->|"checks status"| node_target

click node_main "https://github.com/ghostoraner/exprin/blob/main/main.py"
click node_configuration "https://github.com/ghostoraner/exprin/blob/main/main.py"
click node_live_view "https://github.com/ghostoraner/exprin/blob/main/main.py"
click node_profiler "https://github.com/ghostoraner/exprin/blob/main/system_profiler.py"
click node_workers "https://github.com/ghostoraner/exprin/blob/main/attack_engine.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_main,node_configuration,node_live_view toneBlue
class node_workers,node_target toneAmber
class node_profiler toneMint
class node_operator toneIndigo
```

## Components

### CLI workflow

- [CLI orchestrator](https://github.com/ghostoraner/exprin/blob/main/main.py): `main.py`
- [Run configuration](https://github.com/ghostoraner/exprin/blob/main/main.py): `main.py`
- [Live status view](https://github.com/ghostoraner/exprin/blob/main/main.py): `main.py`

### Request runtime

- [Request workers](https://github.com/ghostoraner/exprin/blob/main/attack_engine.py): `attack_engine.py`

### System profiling

- [System recommendations](https://github.com/ghostoraner/exprin/blob/main/system_profiler.py): `system_profiler.py`

### Other components

- **Operator**
- **HTTP target**

## Connections

- Operator → CLI orchestrator: starts program (evidence: `README.md`)
- CLI orchestrator → System recommendations: gets recommendations (evidence: `main.py`)
- CLI orchestrator → Run configuration: collects parameters (evidence: `main.py`)
- Run configuration → Operator: prompts (evidence: `main.py`)
- CLI orchestrator → Request workers: starts workers (evidence: `main.py`)
- Request workers → HTTP target: sends HTTP requests (evidence: `attack_engine.py`)
- Request workers → CLI orchestrator: updates shared counts (evidence: `attack_engine.py`)
- CLI orchestrator → Live status view: renders run status (evidence: `main.py`)
- CLI orchestrator → HTTP target: checks status (evidence: `main.py`)
