# shadowhackrs/gmail-infinity architecture

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

- Interactive diagram: https://gitdiagram.com/shadowhackrs/gmail-infinity
- Repository: https://github.com/shadowhackrs/gmail-infinity

## Overview

This repository is a terminal-driven Gmail account automation application. Its principal workflow begins in the entry-point UI, runs account-creation attempts through browser or Android runners, handles phone/CAPTCHA challenges, then stores and exports account records. Separate capabilities cover proxy management, browser stealth and behavior simulation, account warming, and voice OTP. The README describes additional systems that are not present in the supplied tree; this map uses only paths that exist. Several implementation excerpts are partial, so uncertain internal wiring is omitted.

Main entry points: [`auto_gmail_creator.py`](https://github.com/shadowhackrs/gmail-infinity/blob/main/auto_gmail_creator.py) (Terminal entry), [`core/stealth_browser.py`](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/stealth_browser.py) (Stealth browser), [`core/selenium_runner.py`](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/selenium_runner.py) (Browser runner), [`core/phone_bypass.py`](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/phone_bypass.py) (Phone bypass)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application flow"]
  node_entry["Terminal entry"]
  node_ui["Interactive UI<br/>[ui.py]"]
  node_batch["Batch runner<br/>[batch_runner.py]"]
  node_runners["Runner selection<br/>[runners.py]"]
  node_config["Runtime configuration<br/>[settings.py]"]
end

subgraph group_creation["Creation and verification"]
  node_browser_runner["Browser runner<br/>[selenium_runner.py]"]
  node_android["Android creator<br/>[android_creator.py]"]
  node_captcha["CAPTCHA solving<br/>[captcha_solver.py]"]
  node_phone["Phone bypass<br/>[phone_bypass.py]"]
  node_sms["SMS provider manager<br/>[sms_manager.py]"]
  node_voice["Voice OTP server<br/>[voice.py]"]
end

subgraph group_stealth["Browser and network"]
  node_proxy["Proxy manager<br/>[proxy_manager.py]"]
  node_browser["Stealth browser<br/>[stealth_browser.py]"]
  node_fingerprint["Fingerprint engine<br/>[fingerprint.py]"]
  node_behavior["Behavior simulation<br/>[behavior.py]"]
  node_ghost["Typing injection<br/>[ghost_typer.js]"]
  node_poltergeist["Fingerprint injection<br/>[poltergeist_fp.js]"]
end

subgraph group_lifecycle["Accounts and warming"]
  node_accounts["Account manager<br/>[account_manager.py]"]
  node_database[("SQLite database<br/>[database.py]")]
  node_warming["Account warming<br/>[account_warmer.py]"]
  node_trust["Reputation builder<br/>[trust_builder.py]"]
end

node_operator(("Operator"))
node_captcha_services(("CAPTCHA providers"))
node_sms_services(("SMS providers"))
node_voice_provider(("Voice call provider"))
node_google(("Google services"))

node_operator -->|"starts"| node_entry
node_entry -->|"presents menu"| node_ui
node_entry -->|"runs creation"| node_batch
node_batch -->|"selects runner"| node_runners
node_runners -->|"dispatches"| node_browser_runner
node_runners -->|"dispatches"| node_android
node_browser_runner -->|"uses browser"| node_browser
node_android -.->|"uses browser"| node_browser
node_browser_runner -.->|"handles challenge"| node_captcha
node_browser_runner -.->|"handles phone check"| node_phone
node_phone -->|"requests verification"| node_sms
node_sms -->|"orders and polls"| node_sms_services
node_phone -.->|"requests voice OTP"| node_voice
node_voice_provider -.->|"posts recording"| node_voice
node_voice -.->|"provides OTP"| node_phone
node_captcha -.->|"submits challenge"| node_captcha_services
node_proxy -->|"reads settings"| node_config
node_browser_runner -.->|"selects proxy"| node_proxy
node_browser -->|"uses fingerprints"| node_fingerprint
node_browser -->|"uses simulation"| node_behavior
node_browser -.->|"injects script"| node_ghost
node_browser -.->|"injects script"| node_poltergeist
node_batch -->|"records outcomes"| node_accounts
node_accounts -->|"reads and writes"| node_database
node_entry -->|"initializes and migrates"| node_database
node_ui -->|"exports accounts"| node_accounts
node_warming -.->|"simulates activity"| node_google
node_warming -->|"builds reputation"| node_trust
node_entry -.->|"offers warmup"| node_warming
node_entry -->|"loads settings"| node_config

click node_entry "https://github.com/shadowhackrs/gmail-infinity/blob/main/auto_gmail_creator.py"
click node_ui "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/ui.py"
click node_batch "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/batch_runner.py"
click node_runners "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/runners.py"
click node_browser_runner "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/selenium_runner.py"
click node_android "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/android_creator.py"
click node_captcha "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/captcha_solver.py"
click node_phone "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/phone_bypass.py"
click node_sms "https://github.com/shadowhackrs/gmail-infinity/blob/main/services/sms_manager.py"
click node_voice "https://github.com/shadowhackrs/gmail-infinity/blob/main/services/voice.py"
click node_proxy "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/proxy_manager.py"
click node_browser "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/stealth_browser.py"
click node_fingerprint "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/fingerprint.py"
click node_behavior "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/behavior.py"
click node_ghost "https://github.com/shadowhackrs/gmail-infinity/blob/main/js/ghost_typer.js"
click node_poltergeist "https://github.com/shadowhackrs/gmail-infinity/blob/main/js/poltergeist_fp.js"
click node_accounts "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/account_manager.py"
click node_database "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/database.py"
click node_warming "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/account_warmer.py"
click node_trust "https://github.com/shadowhackrs/gmail-infinity/blob/main/core/trust_builder.py"
click node_config "https://github.com/shadowhackrs/gmail-infinity/blob/main/config/settings.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_entry,node_ui,node_batch,node_runners,node_config toneBlue
class node_browser_runner,node_android,node_captcha,node_phone,node_sms,node_voice toneAmber
class node_proxy,node_browser,node_fingerprint,node_behavior,node_ghost,node_poltergeist toneMint
class node_accounts,node_database,node_warming,node_trust toneRose
class node_operator,node_captcha_services,node_sms_services,node_voice_provider,node_google toneIndigo
```

## Components

### Application flow

- [Terminal entry](https://github.com/shadowhackrs/gmail-infinity/blob/main/auto_gmail_creator.py): `auto_gmail_creator.py`
- [Interactive UI](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/ui.py): `core/ui.py`
- [Batch runner](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/batch_runner.py): `core/batch_runner.py`
- [Runner selection](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/runners.py): `core/runners.py`
- [Runtime configuration](https://github.com/shadowhackrs/gmail-infinity/blob/main/config/settings.py): `config/settings.py`

### Creation and verification

- [Browser runner](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/selenium_runner.py): `core/selenium_runner.py`
- [Android creator](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/android_creator.py): `core/android_creator.py`
- [CAPTCHA solving](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/captcha_solver.py): `core/captcha_solver.py`
- [Phone bypass](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/phone_bypass.py): `core/phone_bypass.py`
- [SMS provider manager](https://github.com/shadowhackrs/gmail-infinity/blob/main/services/sms_manager.py): `services/sms_manager.py`
- [Voice OTP server](https://github.com/shadowhackrs/gmail-infinity/blob/main/services/voice.py): `services/voice.py`

### Browser and network

- [Proxy manager](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/proxy_manager.py): `core/proxy_manager.py`
- [Stealth browser](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/stealth_browser.py): `core/stealth_browser.py`
- [Fingerprint engine](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/fingerprint.py): `core/fingerprint.py`
- [Behavior simulation](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/behavior.py): `core/behavior.py`
- [Typing injection](https://github.com/shadowhackrs/gmail-infinity/blob/main/js/ghost_typer.js): `js/ghost_typer.js`
- [Fingerprint injection](https://github.com/shadowhackrs/gmail-infinity/blob/main/js/poltergeist_fp.js): `js/poltergeist_fp.js`

### Accounts and warming

- [Account manager](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/account_manager.py): `core/account_manager.py`
- [SQLite database](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/database.py): `core/database.py`
- [Account warming](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/account_warmer.py): `core/account_warmer.py`
- [Reputation builder](https://github.com/shadowhackrs/gmail-infinity/blob/main/core/trust_builder.py): `core/trust_builder.py`

### Other components

- **Operator**
- **CAPTCHA providers**
- **SMS providers**
- **Voice call provider**
- **Google services**

## Connections

- Operator → Terminal entry: starts
- Terminal entry → Interactive UI: presents menu
- Terminal entry → Batch runner: runs creation
- Batch runner → Runner selection: selects runner
- Runner selection → Browser runner: dispatches
- Runner selection → Android creator: dispatches
- Browser runner → Stealth browser: uses browser
- Android creator → Stealth browser: uses browser
- Browser runner → CAPTCHA solving: handles challenge
- Browser runner → Phone bypass: handles phone check
- Phone bypass → SMS provider manager: requests verification
- SMS provider manager → SMS providers: orders and polls
- Phone bypass → Voice OTP server: requests voice OTP
- Voice call provider → Voice OTP server: posts recording
- Voice OTP server → Phone bypass: provides OTP
- CAPTCHA solving → CAPTCHA providers: submits challenge
- Proxy manager → Runtime configuration: reads settings
- Browser runner → Proxy manager: selects proxy
- Stealth browser → Fingerprint engine: uses fingerprints
- Stealth browser → Behavior simulation: uses simulation
- Stealth browser → Typing injection: injects script
- Stealth browser → Fingerprint injection: injects script
- Batch runner → Account manager: records outcomes
- Account manager → SQLite database: reads and writes
- Terminal entry → SQLite database: initializes and migrates
- Interactive UI → Account manager: exports accounts
- Account warming → Google services: simulates activity
- Account warming → Reputation builder: builds reputation
- Terminal entry → Account warming: offers warmup
- Terminal entry → Runtime configuration: loads settings