# codesparadox/instareport architecture

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

- Interactive diagram: https://gitdiagram.com/codesparadox/instareport
- Repository: https://github.com/codesparadox/instareport

## Overview

##### Project type and purpose
- This is a stand-alone, open-source Python CLI tool (“InstaReport”) for bulk-reporting Instagram accounts or videos by sending HTTP requests through proxy servers.
- Key indicators: single entry script (ReportBot.py), a small `libs/` folder with attack, proxy harvesting, user-agent management, animation, and utility modules, and no frontend/backend split—this is a command-line automation tool.

##### File structure
- Top-level files:
- `ReportBot.py` – main CLI driver
- `requirements.txt` – Python dependencies
- `setup.sh` – setup installer
- `libs/` folder: modularized functionality
- attack.py – core reporting logic (HTTP calls to Instagram endpoints)
- proxy_harvester.py – gathers/validates proxy lists
- user_agents.py – rotates user-agent headers
- utils.py – common request building, logging, rate limiting
- animation.py & logo.py – CLI UX (progress bars, banners)
- check_modules.py – verifies Python environment prerequisites

##### README for additional insights
- Describes features: mass report, proxy + username, multi-platform support
- External dependencies: Python3, git, internet connectivity

## Diagram (Mermaid)

```mermaid
flowchart TD
    User["User (CLI)"]:::cli
    User -->|"run"| ReportBot["ReportBot.py"]:::cli

    subgraph "InstaReport Modules"
        direction TB
        CheckModules["Environment Checker (check_modules.py)"]:::module
        ProxyHarvester["Proxy Harvester (proxy_harvester.py)"]:::module
        UserAgent["User-Agent Manager (user_agents.py)"]:::module
        Utils["Utilities (utils.py)"]:::module
        AttackEngine["Attack Engine (attack.py)"]:::module
        Animation["UX Helper ‑ Animation (animation.py)"]:::module
        Logo["UX Helper ‑ Logo Display (logo.py)"]:::module
    end

    ReportBot --> CheckModules
    ReportBot --> Logo
    ReportBot --> Animation
    ReportBot --> ProxyHarvester
    ReportBot --> UserAgent
    ReportBot --> AttackEngine
    ReportBot --> Utils

    AttackEngine -->|"uses proxy"| ProxyHarvester
    AttackEngine -->|"uses UA"| UserAgent
    AttackEngine -->|"builds request"| Utils
    AttackEngine -->|"update progress"| Animation
    AttackEngine -->|"display banner"| Logo

    AttackEngine -->|"HTTP POST report"| Instagram["Instagram API"]:::external
    AttackEngine -->|"proxy connection"| ProxyServer["Proxy Servers"]:::external

    subgraph Environment["Environment/Dependencies"]
        direction TB
        Python["Python3 Interpreter"]:::env
        Req["requirements.txt"]:::env
        SetupInstaller["Setup Installer Script (setup.sh)"]:::env
    end

    ReportBot --> Environment
    Environment --> Python
    Environment --> Req
    Environment --> SetupInstaller

    click ReportBot "https://github.com/codesparadox/instareport/blob/main/ReportBot.py"
    click AttackEngine "https://github.com/codesparadox/instareport/blob/main/libs/attack.py"
    click ProxyHarvester "https://github.com/codesparadox/instareport/blob/main/libs/proxy_harvester.py"
    click UserAgent "https://github.com/codesparadox/instareport/blob/main/libs/user_agents.py"
    click Utils "https://github.com/codesparadox/instareport/blob/main/libs/utils.py"
    click Animation "https://github.com/codesparadox/instareport/blob/main/libs/animation.py"
    click Logo "https://github.com/codesparadox/instareport/blob/main/libs/logo.py"
    click CheckModules "https://github.com/codesparadox/instareport/blob/main/libs/check_modules.py"
    click Req "https://github.com/codesparadox/instareport/blob/main/requirements.txt"
    click SetupInstaller "https://github.com/codesparadox/instareport/blob/main/setup.sh"

    classDef cli fill:#FFA500,stroke:#333,stroke-width:1px;
    classDef module fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef external fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef env fill:#F0E68C,stroke:#333,stroke-width:1px;
```
