# incrediblehacker/insta-hack architecture

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

- Interactive diagram: https://gitdiagram.com/incrediblehacker/insta-hack
- Repository: https://github.com/incrediblehacker/insta-hack

## Overview

##### Project type and purpose
- This is an open-source, CLI-based Instagram “hacking” toolkit packaged as a collection of Python modules and Bash scripts.
- It provides three main functions: information gathering, brute-force password attacks, and automatic account reporting.

##### File structure
- Top-level orchestrator scripts:
- insta-hack.sh, setup.sh, update.sh, remove.sh
These serve as the single-command entry points.
- Submodule directories:
- Ig_information_gathering/
– Core_files/Ig_information_gathering.py (main info-gathering engine)
– Core_files/PersonalLib/ (helper library modules: Fast.py, More.py, Shadow.py)
– Core_files/Users/ (local storage for output)
– start.sh, update.sh, remove.sh (module-specific scripts)
- ig_brute_force/
– core/patch.sh, core/update.sh (maintenance scripts)
– main/auto.sh, main/manual.sh (two brute-force modes)
– pass/ (wordlist files)
– ighack.sh (entrypoint for brute force)
- Configuration and dependency files:
- requirements.txt (Python dependencies)
- LICENSE, README.md

##### README for additional insights
- Describes the three features and supported environments (Termux, Kali).
- Shows that orchestration is via Bash wrappers around Python cores.
- No built-in web service or database—data is fetched directly over HTTP and stored in flat files.

a. Main components
- CLI Entrypoint Layer
– insta-hack.sh (top-level dispatcher)
– setup.sh / update.sh / remove.sh (lifecycle scripts)
- Functional Modules
– Info-Gathering Module
· Ig_information_gathering.py
· PersonalLib (Fast, More, Shadow)
· Users folder (local result store)
– Brute-Force Module
· ighack.sh → auto.sh & manual.sh
· Wordlists in pass/
– Auto-Reporter Module (could be in same or separate shell script)
- External Services
– Instagram HTTP endpoints (API or web scraping)
- Local Resources
– Filesystem (Users/, pass/wordlists)
– Python virtual environment & installed packages

b. Relationships and interactions
- Top-level CLI calls the appropriate sub-script (info, brute, report).
- Sub-script loads or calls Python core functions.
- Python core uses PersonalLib helpers to process data.
- All modules send HTTP requests to Instagram and parse responses.
- Results are persisted to local folders.
- update.sh scripts pull new code from GitHub; remove.sh cleans up files.

c. Architectural patterns
- Modular CLI orchestration: Bash scripts wrap Python modules.
- Separation of concerns:
– Shell layer (deployment, invocation, updates)
– Python layer (business logic for attacks)
- File-based storage: no database, simple result caching.

d. Key technologies
- Bash scripting (orchestration, installation, updates)
- Python 3 modules for HTTP requests, parsing
- Flat-file wordlists for brute-force
- GitHub for distribution/updating

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% CLI Entrypoint Layer
    subgraph "CLI Entrypoint Layer"
        direction TB
        CLI["insta-hack.sh"]:::shell
        Setup["setup.sh"]:::shell
    end

    %% Information Gathering Module
    subgraph "Info-Gathering Module"
        direction TB
        IGStart["start.sh"]:::shell
        IGUpdate["update.sh"]:::shell
        IGRemove["remove.sh"]:::shell
        subgraph "Core Files"
            direction TB
            IGEngine["Ig_information_gathering.py"]:::python
            subgraph "PersonalLib"
                direction TB
                Fast["Fast.py"]:::python
                More["More.py"]:::python
                Shadow["Shadow.py"]:::python
                InfoTxt["Info.txt"]:::fs
            end
            UsersDir["Users/"]:::fs
        end
    end

    %% Brute-Force Module
    subgraph "Brute-Force Module"
        direction TB
        BFSrunner["ighack.sh"]:::shell
        subgraph "Maintenance Scripts"
            direction TB
            BFpatch["core/patch.sh"]:::shell
            BFupdate["core/update.sh"]:::shell
        end
        subgraph "Brute Modes"
            direction TB
            BFauto["main/auto.sh"]:::shell
            BFmanual["main/manual.sh"]:::shell
        end
        subgraph "Wordlists"
            direction TB
            pass1["pass1.txt"]:::fs
            pass2["pass2.txt"]:::fs
            pass3["pass3.txt"]:::fs
        end
    end

    %% Configuration & Docs
    subgraph "Configuration & Documentation"
        direction TB
        Req["requirements.txt"]:::fs
        License["LICENSE"]:::fs
        Readme["README.md"]:::fs
    end

    %% External Services & Repo
    Instagram["Instagram HTTP Endpoints"]:::external
    GitHub["GitHub Repo"]:::external

    %% Connections
    CLI -->|"info-gather"| IGStart
    CLI -->|"brute-force"| BFSrunner
    Setup -->|"install/update"| GitHub
    IGStart -->|"invoke"| IGEngine
    IGUpdate -->|"pull updates"| GitHub
    IGRemove -->|"cleanup"| UsersDir
    IGEngine -->|"uses"| Fast
    IGEngine -->|"uses"| More
    IGEngine -->|"uses"| Shadow
    IGEngine -->|"stores results"| UsersDir
    IGEngine -->|"HTTP requests"| Instagram
    BFSrunner -->|"launch auto"| BFauto
    BFSrunner -->|"launch manual"| BFmanual
    BFpatch -->|"patch scripts"| BFSrunner
    BFupdate -->|"pull updates"| GitHub
    BFauto -->|"read wordlists"| pass1
    BFauto -->|"read wordlists"| pass2
    BFauto -->|"read wordlists"| pass3
    BFmanual -->|"read wordlists"| pass1
    BFmanual -->|"read wordlists"| pass2
    BFmanual -->|"read wordlists"| pass3
    BFauto -->|"HTTP requests"| Instagram
    BFmanual -->|"HTTP requests"| Instagram

    %% Click Events
    click CLI "https://github.com/incrediblehacker/insta-hack/blob/main/insta-hack.sh"
    click Setup "https://github.com/incrediblehacker/insta-hack/blob/main/setup.sh"
    click IGStart "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/start.sh"
    click IGUpdate "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/update.sh"
    click IGRemove "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/remove.sh"
    click IGEngine "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/Core_files/Ig_information_gathering.py"
    click Fast "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/Core_files/PersonalLib/Fast.py"
    click More "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/Core_files/PersonalLib/More.py"
    click Shadow "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/Core_files/PersonalLib/Shadow.py"
    click InfoTxt "https://github.com/incrediblehacker/insta-hack/blob/main/Ig_information_gathering/Core_files/PersonalLib/Info.txt"
    click UsersDir "https://github.com/incrediblehacker/insta-hack/tree/main/Ig_information_gathering/Core_files/Users/"
    click BFSrunner "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/ighack.sh"
    click BFpatch "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/core/patch.sh"
    click BFupdate "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/core/update.sh"
    click BFauto "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/main/auto.sh"
    click BFmanual "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/main/manual.sh"
    click pass1 "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/pass/pass1.txt"
    click pass2 "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/pass/pass2.txt"
    click pass3 "https://github.com/incrediblehacker/insta-hack/blob/main/ig_brute_force/pass/pass3.txt"
    click Req "https://github.com/incrediblehacker/insta-hack/blob/main/requirements.txt"
    click License "https://github.com/incrediblehacker/insta-hack/tree/main/LICENSE"
    click Readme "https://github.com/incrediblehacker/insta-hack/blob/main/README.md"

    %% Styles
    classDef shell fill:#f9e79f,stroke:#b7950b,stroke-width:1px;
    classDef python fill:#aed6f1,stroke:#2874a6,stroke-width:1px;
    classDef fs fill:#d5dbdb,stroke:#6e2c00,stroke-width:1px;
    classDef external fill:#abebc6,stroke:#1e8449,stroke-width:1px;
```
