# hunxbyts/insta-osint architecture

> Architecture diagram of the GitHub repository hunxbyts/insta-osint, 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/hunxbyts/insta-osint
- Repository: https://github.com/hunxbyts/insta-osint

## Overview

INSTA-OSINT is a command-line Instagram profile OSINT tool. The user supplies an Instagram login and target username; the script authenticates through Instaloader, looks up the profile, prints account details, downloads profile-related posts and highlights, and lists followers and followings. The single source file owns these actions, so the graph distinguishes workflow stages without implying separate implementation modules. The README lists additional capabilities, but source evidence is limited to the sampled script and does not show every listed feature being retrieved or downloaded.

Main entry points: [`instaOSINT.py`](https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py) (Target lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["CLI workflow"]
  node_cli["CLI entry<br/>[instaOSINT.py]"]
  node_auth["Login session<br/>[instaOSINT.py]"]
end

subgraph group_profile["Profile intelligence"]
  node_lookup["Target lookup<br/>[instaOSINT.py]"]
  node_details["Account details<br/>[instaOSINT.py]"]
end

subgraph group_collection["Media and connections"]
  node_media["Media collection<br/>[instaOSINT.py]"]
  node_connections["Follower lists<br/>[instaOSINT.py]"]
end

node_user(("Operator"))
node_instaloader["Instaloader API"]
node_instagram["Instagram"]

node_user -->|"provides credentials"| node_cli
node_user -->|"provides target"| node_lookup
node_cli -->|"starts"| node_auth
node_auth -->|"logs in"| node_instaloader
node_instaloader -.->|"authenticates with"| node_instagram
node_cli -->|"runs"| node_lookup
node_lookup -->|"fetches profile"| node_instaloader
node_lookup -->|"reads fields"| node_details
node_lookup -->|"requests content"| node_media
node_media -->|"downloads posts"| node_instaloader
node_lookup -->|"requests lists"| node_connections
node_connections -->|"fetches accounts"| node_instaloader

click node_cli "https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py"
click node_auth "https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py"
click node_lookup "https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py"
click node_details "https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py"
click node_media "https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py"
click node_connections "https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.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_cli,node_auth toneBlue
class node_lookup,node_details toneAmber
class node_media,node_connections,node_instaloader toneMint
class node_user,node_instagram toneIndigo
```

## Components

### CLI workflow

- [CLI entry](https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py): `instaOSINT.py`
- [Login session](https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py): `instaOSINT.py`

### Profile intelligence

- [Target lookup](https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py): `instaOSINT.py`
- [Account details](https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py): `instaOSINT.py`

### Media and connections

- [Media collection](https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py): `instaOSINT.py`
- [Follower lists](https://github.com/hunxbyts/insta-osint/blob/main/instaOSINT.py): `instaOSINT.py`

### Other components

- **Operator**
- **Instaloader API**
- **Instagram**

## Connections

- Operator → CLI entry: provides credentials (evidence: `instaOSINT.py`)
- Operator → Target lookup: provides target (evidence: `instaOSINT.py`)
- CLI entry → Login session: starts (evidence: `instaOSINT.py`)
- Login session → Instaloader API: logs in (evidence: `instaOSINT.py`)
- Instaloader API → Instagram: authenticates with
- CLI entry → Target lookup: runs (evidence: `instaOSINT.py`)
- Target lookup → Instaloader API: fetches profile (evidence: `instaOSINT.py`)
- Target lookup → Account details: reads fields (evidence: `instaOSINT.py`)
- Target lookup → Media collection: requests content (evidence: `instaOSINT.py`)
- Media collection → Instaloader API: downloads posts (evidence: `instaOSINT.py`)
- Target lookup → Follower lists: requests lists (evidence: `instaOSINT.py`)
- Follower lists → Instaloader API: fetches accounts (evidence: `instaOSINT.py`)
