# arch3rpro/pentest-windows architecture

> Architecture diagram of the GitHub repository arch3rpro/pentest-windows, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arch3rpro/pentest-windows
- Repository: https://github.com/arch3rpro/pentest-windows

## Overview

##### Project Type and Purpose
- Type: Pre-configured VM image & tooling distribution for Windows penetration testing.
- Purpose: Provide a ready-to-use Windows 11 environment (x64 & ARM) with 400+ pentest tools, managed via Scoop and a custom launcher (Maye).

##### File Structure
- Top‐level:
- README.md / README-ZH.md – documentation
- img/ – screenshots for docs
- No code directories; this project is a VM image distribution with configuration and docs only.

##### README for Insights
- VM targets: VMware, Fusion, Parallels, Hyper-V, KVM.
- Inside VM: Windows 11 OS, Scoop package manager, Maye Lite launcher, Windows Terminal, Oh-My-Posh, bundled tools (script/GUI).
- External integrations: Internet (to download/update tools), optional VPN/proxy, WSL Kali (optional).

##### Main Components & Their Relationships
A. Host Layer
- Physical Machine (Mac M1/M2 or Intel)
- Host OS (macOS or Windows)
- Virtualization Software:
– VMware / Fusion / Parallels / KVM / Hyper-V / Ventoy
- VM Image Artifact (7z / qcow2 / OVF)
B. Guest Layer (Windows 11 VM)
- Base OS (Windows 11)
- Configuration Tools & Package Manager:
– Scoop (D:/Base/apps/scoop)
– Windows Terminal / Oh-My-Posh
– QEMU/VMware/Parallels drivers (QGA, VirtualIO)
- Tool Categories (400+):
– Info Gathering, Scanning, Exploitation, Proxy, Persistence, C2, etc.
– Each tool installed via Scoop or portable binaries
- Offline Knowledge Base (PDF/Markdown)
- Networking:
– Internet access for online tools/updates
– VPN / Proxy connectivity (OpenVPN, WireGuard, Tailscale)
– WSL Kali integration (optional, removed in v3.x)
- Remote Access:
– RDP recommended
– SSH/SFTP clients (OpenSSH, WinSCP, MobaXterm)
C. External Services
- GitHub / Scoop Buckets (tool repos & updates)
- Online pentest services (Shodan, Censys, Pentest-Tools.com)
- Cloud storage for VM downloads (Mega)

##### Architectural Patterns & Design Principles
- Layered architecture:
1. Host & Hypervisor
2. VM OS Platform
3. Package management & launcher
4. Tool categories
5. External services
- Separation of concerns:
- Hypervisor abstraction keeps VM portable
- Scoop isolates tool installs in D:/Base/apps
- Maye launcher decouples UI from tool execution
- Extensibility:
- New tools added via Scoop buckets
- VM versions for multiple architectures (x64, ARM)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Host Layer
    subgraph "Host Layer"
        HostMachine["Physical Machine"]:::host
        HostOS["Host OS (macOS/Windows)"]:::host
        Virtualization["Virtualization Software\n(VMware/Fusion/Parallels/KVM/Hyper-V/Ventoy)"]:::host
        VMImage["VM Image Artifact\n(.7z / qcow2 / OVF)"]:::host
    end

    %% Guest VM Layer
    subgraph "Guest VM (Windows 11)"
        subgraph "OS & Platform"
            WinOS["Windows 11"]:::vm
            Drivers["VM Drivers\n(QGA, VirtIO)"]:::vm
        end
        subgraph "Package Management & Launcher"
            Scoop["Scoop Package Manager\n(D:/Base/apps/scoop)"]:::vm
            Maye["Maye Lite Launcher"]:::vm
        end
        subgraph "Tool Categories"
            Info["Info Gathering"]:::tool
            Scan["Scanning"]:::tool
            Explo["Exploitation"]:::tool
            Proxy["Proxy"]:::tool
            Persist["Persistence"]:::tool
            C2["C2"]:::tool
        end
        Knowledge["Offline KB (PDF/Markdown)"]:::vm
        subgraph "Networking & Remote"
            Internet["Internet\n(HTTP/HTTPS)"]:::external
            VPN["VPN/Proxy\n(OpenVPN, WireGuard, Tailscale)"]:::external
            WSL["WSL Kali (optional)"]:::vm
            RDP["RDP/SSH/SFTP Clients"]:::vm
        end
    end

    %% External Services
    subgraph "External Services"
        GitHub["GitHub / Scoop Buckets"]:::external
        OnlineTools["Online Pentest Services\n(Shodan, Censys, Pentest-Tools.com)"]:::external
        Cloud["Cloud Storage (Mega)"]:::external
    end

    %% Documentation
    subgraph "Documentation"
        DocEN["README.md"]:::docs
        DocZH["README-ZH.md"]:::docs
        Img["img/"]:::docs
    end

    %% Connections
    HostMachine --> HostOS
    HostOS --> Virtualization
    Virtualization -->|"deploy VM image"| WinOS
    VMImage --> Virtualization
    WinOS -->|"scoop install"| Scoop
    Scoop -->|"downloads from"| GitHub
    Maye -->|"launch tool"| Info
    Maye -->|"launch tool"| Scan
    Maye -->|"launch tool"| Explo
    Maye -->|"launch tool"| Proxy
    Maye -->|"launch tool"| Persist
    Maye -->|"launch tool"| C2
    WinOS -->|"access"| Internet
    Internet -->|"update tools"| Scoop
    WinOS -->|"VPN/Proxy"| VPN
    WinOS -->|"optional integrate"| WSL
    WinOS -->|"remote access"| RDP
    WinOS -->|"read"| Knowledge
    WinOS -->|"access"| OnlineTools
    Cloud -->|"download VM"| HostOS

    %% Click Events
    click DocEN "https://github.com/arch3rpro/pentest-windows/blob/main/README.md"
    click DocZH "https://github.com/arch3rpro/pentest-windows/blob/main/README-ZH.md"
    click Img "https://github.com/arch3rpro/pentest-windows/tree/main/img/"

    %% Styles
    classDef host fill:#ADD8E6,stroke:#000
    classDef vm fill:#90EE90,stroke:#000
    classDef tool fill:#FFA500,stroke:#000
    classDef external fill:#D3D3D3,stroke:#000
    classDef docs fill:#E6E6FA,stroke:#000
```
