# khanejo/instagram-mass-reporter architecture

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

- Interactive diagram: https://gitdiagram.com/khanejo/instagram-mass-reporter
- Repository: https://github.com/khanejo/instagram-mass-reporter

## Overview

##### Project type and purpose
- This is a small open-source Python automation tool (a command-line bot) whose sole purpose is to mass-report specified Instagram accounts by driving a web browser.

##### File structure
- Top-level files:
- Instagram Report Bot2.py – the main script.
- acc.txt (implied) – input list of account credentials.
- README.md – instructions/user flow description.
- LICENSE – project license.
- No separate frontend/backend or database directories. All logic lives in one script.

##### README for additional insights
- Dependencies: pyautogui, webbot
- Flow:
1) User provides target username(s) in acc.txt
2) Bot logs into Instagram using those credentials
3) Bot navigates to target’s page and submits report(s)

##### Elements
- Clear labels: “User”, “Script: Instagram Reporter”, “pyautogui”, “webbot”, “Web Browser”, “Instagram Service”, “acc.txt”
- from User to Script (CLI invocation)
- from Script to File System (read acc.txt)
- from Script to Libraries to Browser
- a third for external services (Instagram),
- a fourth for file-system artifacts.

##### Putting it all together
- Input Parser
- Credential Manager
- Automation Controller
- Report Executor

Tips:

## Diagram (Mermaid)

```mermaid
flowchart TD
    classDef user fill:#f9f,stroke:#333,stroke-width:2px;
    classDef internal fill:#bbf,stroke:#333,stroke-width:2px;
    classDef lib fill:#bfb,stroke:#333,stroke-width:2px;
    classDef external fill:#ffb,stroke:#333,stroke-width:2px;
    classDef service fill:#fbb,stroke:#333,stroke-width:2px;
    classDef file fill:#ffd,stroke:#333,stroke-width:2px;

    User("User (CLI)"):::user
    subgraph "Instagram-Reporter Bot"
        Parser("Input Parser"):::internal
        CredMgr("Credential Manager"):::internal
        AutoCtrl("Automation Controller"):::internal
        Executor("Report Executor"):::internal
    end
    accTxt("acc.txt"):::file
    logFile("log.txt"):::file
    subgraph "External Libraries"
        PyAuto("pyautogui"):::lib
        Webbot("webbot"):::lib
    end
    Browser("Web Browser"):::external
    Instagram("Instagram Web Service"):::service
    README("README.md"):::file
    License("LICENSE"):::file

    User -->|"runs script"| Parser
    Parser -->|"reads accounts"| accTxt
    Parser -->|"provides credentials"| CredMgr
    CredMgr -->|"hands off creds"| AutoCtrl
    AutoCtrl -->|"uses automation"| PyAuto
    AutoCtrl -->|"uses automation"| Webbot
    PyAuto -->|"controls"| Browser
    Webbot -->|"controls"| Browser
    Browser <-->|"HTTP requests"| Instagram
    Parser -->|"logs results"| logFile

    click User "https://github.com/khanejo/instagram-mass-reporter/blob/master/Instagram Report Bot2.py"
    click Parser "https://github.com/khanejo/instagram-mass-reporter/blob/master/Instagram Report Bot2.py"
    click CredMgr "https://github.com/khanejo/instagram-mass-reporter/blob/master/Instagram Report Bot2.py"
    click AutoCtrl "https://github.com/khanejo/instagram-mass-reporter/blob/master/Instagram Report Bot2.py"
    click Executor "https://github.com/khanejo/instagram-mass-reporter/blob/master/Instagram Report Bot2.py"
    click accTxt "https://github.com/khanejo/instagram-mass-reporter/blob/master/acc.txt"
    click README "https://github.com/khanejo/instagram-mass-reporter/blob/master/README.md"
    click License "https://github.com/khanejo/instagram-mass-reporter/tree/master/LICENSE"
```
