# evildevill/instahack architecture

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

- Interactive diagram: https://gitdiagram.com/evildevill/instahack
- Repository: https://github.com/evildevill/instahack

## Overview

Instahack is a Bash/Python command-line tool for information gathering and password-guessing attacks against Instagram and Twitter. Its documented user flow starts at the menu, where users choose information gathering, automatic or custom-wordlist attacks, updating, or exit. The tree suggests separate attack, update, and Tor-related components, but their invocation and data flow are not shown in the sampled source; those links are therefore dashed and unverified. The README also claims resume and multithreading capabilities, represented without assuming how they are implemented.

Main entry points: [`instahack.sh`](https://github.com/evildevill/instahack/blob/main/instahack.sh) (Instahack menu), [`main/.multithreading.sh`](https://github.com/evildevill/instahack/blob/main/main/.multithreading.sh) (Auto attack), [`torrc`](https://github.com/evildevill/instahack/blob/main/torrc) (Tor routing), [`main/.tweetbrute.sh`](https://github.com/evildevill/instahack/blob/main/main/.tweetbrute.sh) (Twitter attacks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry"]
  node_cli["Instahack menu<br/>[instahack.sh]"]
  node_osint["Information gathering"]
end

subgraph group_attacks["Attack capabilities"]
  node_auto["Auto attack<br/>[.multithreading.sh]"]
  node_manual["Manual attack<br/>[.multithreading.sh]"]
  node_twitter["Twitter attacks<br/>[.tweetbrute.sh]"]
  node_wordlist["Default passwords<br/>[passwords.lst]"]
  node_resume[("Attack resume")]
end

subgraph group_support["Runtime support"]
  node_tor["Tor routing"]
  node_updater["Update support<br/>[update.sh]"]
  node_patcher["Patch support<br/>[patch.sh]"]
  node_about["About information<br/>[about.sh]"]
end

subgraph group_integrations["External services"]
  node_instagram["Instagram"]
  node_twitter_service["Twitter"]
  node_tor_service["Tor network"]
end

node_user(("User"))

node_user -->|"runs"| node_cli
node_cli -.->|"offers"| node_osint
node_cli -.->|"offers"| node_auto
node_cli -.->|"offers"| node_manual
node_cli -.->|"offers"| node_updater
node_auto -.->|"uses"| node_wordlist
node_manual -.->|"accepts custom list"| node_wordlist
node_auto -.->|"supports resume"| node_resume
node_auto -.->|"targets"| node_instagram
node_manual -.->|"targets"| node_instagram
node_twitter -.->|"targets"| node_twitter_service
node_auto -.->|"uses routing"| node_tor
node_manual -.->|"uses routing"| node_tor
node_tor -.->|"routes through"| node_tor_service
node_cli -.->|"offers"| node_twitter

click node_cli "https://github.com/evildevill/instahack/blob/main/instahack.sh"
click node_osint "https://github.com/evildevill/instahack/tree/main/main"
click node_auto "https://github.com/evildevill/instahack/blob/main/main/.multithreading.sh"
click node_manual "https://github.com/evildevill/instahack/blob/main/main/.multithreading.sh"
click node_twitter "https://github.com/evildevill/instahack/blob/main/main/.tweetbrute.sh"
click node_wordlist "https://github.com/evildevill/instahack/blob/main/main/passwords.lst"
click node_resume "https://github.com/evildevill/instahack/tree/main/main"
click node_tor "https://github.com/evildevill/instahack/blob/main/torrc"
click node_updater "https://github.com/evildevill/instahack/blob/main/core/update.sh"
click node_patcher "https://github.com/evildevill/instahack/blob/main/core/patch.sh"
click node_about "https://github.com/evildevill/instahack/blob/main/core/about.sh"

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_cli,node_osint,node_user toneBlue
class node_auto,node_manual,node_twitter,node_wordlist,node_resume toneAmber
class node_tor,node_updater,node_patcher,node_about toneMint
class node_instagram,node_twitter_service,node_tor_service toneRose
```

## Components

### CLI entry

- [Instahack menu](https://github.com/evildevill/instahack/blob/main/instahack.sh): `instahack.sh`
- [Information gathering](https://github.com/evildevill/instahack/tree/main/main): `main`

### Attack capabilities

- [Auto attack](https://github.com/evildevill/instahack/blob/main/main/.multithreading.sh): `main/.multithreading.sh`
- [Manual attack](https://github.com/evildevill/instahack/blob/main/main/.multithreading.sh): `main/.multithreading.sh`
- [Twitter attacks](https://github.com/evildevill/instahack/blob/main/main/.tweetbrute.sh): `main/.tweetbrute.sh`
- [Default passwords](https://github.com/evildevill/instahack/blob/main/main/passwords.lst): `main/passwords.lst`
- [Attack resume](https://github.com/evildevill/instahack/tree/main/main): `main`

### Runtime support

- [Tor routing](https://github.com/evildevill/instahack/blob/main/torrc): `torrc`
- [Update support](https://github.com/evildevill/instahack/blob/main/core/update.sh): `core/update.sh`
- [Patch support](https://github.com/evildevill/instahack/blob/main/core/patch.sh): `core/patch.sh`
- [About information](https://github.com/evildevill/instahack/blob/main/core/about.sh): `core/about.sh`

### External services

- **Instagram**
- **Twitter**
- **Tor network**

### Other components

- **User**

## Connections

- User → Instahack menu: runs (evidence: `README.md`)
- Instahack menu → Information gathering: offers
- Instahack menu → Auto attack: offers
- Instahack menu → Manual attack: offers
- Instahack menu → Update support: offers
- Auto attack → Default passwords: uses
- Manual attack → Default passwords: accepts custom list
- Auto attack → Attack resume: supports resume
- Auto attack → Instagram: targets
- Manual attack → Instagram: targets
- Twitter attacks → Twitter: targets
- Auto attack → Tor routing: uses routing
- Manual attack → Tor routing: uses routing
- Tor routing → Tor network: routes through
- Instahack menu → Twitter attacks: offers
