# ai-to-ai/auto-gmail-creator architecture

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

- Interactive diagram: https://gitdiagram.com/ai-to-ai/auto-gmail-creator
- Repository: https://github.com/ai-to-ai/auto-gmail-creator

## Overview

##### Project Type and Purpose
- This is a Python‐based automation bot (“Auto‐Gmail‐Creator”) that orchestrates a WebDriver (Chrome or Firefox) to programmatically register bulk Gmail accounts.
- It reads or generates user profiles (CSV), manages proxy settings, invokes an SMS‐verification API (sms-activate.org), and writes out successfully created accounts.

a. Data Layer
- CSV Databases (First_Name_DB.csv, Last_Name_DB.csv, Proxy_DB.csv)
- User Input CSV (user.csv)
b. Automation Engine (app.py)
- Config & Options Module (AUTO_GENERATE_USERINFO, proxy toggles, headless/UI mode, browser profile settings)
- Data Reader/Generator (reads CSV or synthesizes usernames/dates/passwords)
- WebDriver Manager (uses webdriver-manager to fetch and launch Chromedriver/Geckodriver)
- Stealth Browser Automation (selenium + seleniumwire + undetectable WebDriver)
- SMS API Client (interfaces with sms-activate.org for phone verification)
- Proxy Manager (applies SOCKS5 or HTTP proxies from Proxy_DB)
- Output Writer (writes “Created.txt” for successful registrations)
c. External Services
- Google Account Creation Endpoints (the public Gmail signup pages)
- sms-activate.org (phone verification service)
- Proxy Providers (any third‐party proxy service)
d. Generated Artifacts
- Created.txt (log of successful accounts)
- Local browser profiles (optional, if configured)

##### Relationships and Data Flows
1. CSV Databases → Automation Engine (Data Reader)
2. Automation Engine → webdriver-manager (driver download)
3. Automation Engine → Stealth Browser Automation → Google Signup Pages
4. Automation Engine → SMS API Client ↔ sms-activate.org
5. Automation Engine → Proxy Manager → Proxy Providers
6. Automation Engine → Output Writer → Created.txt
- Control flow inside the Automation Engine: Config → Data Reader/Generator → Browser setup → Phone verification → Form submission → Result logging.

##### Architectural Patterns and Design Principles
- Single‐process, modular architecture: break the bot into clear functional modules (Config, Data, Browser, API, Output).
- Separation of concerns: Data ingestion, browser orchestration, external API calls, and logging are independent.
- Plug-in style for WebDriver and proxy: options to switch Chrome/Firefox or enable headless mode with minimal code changes.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Layer
    subgraph "Data Layer"
        FNDB["First_Name_DB.csv"]:::data
        LNDB["Last_Name_DB.csv"]:::data
        PDB["Proxy_DB.csv"]:::data
        UICSV["user.csv"]:::data
    end

    %% Automation Engine
    subgraph "app.py (Automation Engine)"
        AppFile["app.py"]:::internal
        CFG["Config & Options"]:::internal
        DRG["Data Reader/Generator"]:::internal
        WDM["WebDriver Manager"]:::internal
        SBA["Stealth Browser Automation"]:::internal
        SMSC["SMS API Client"]:::internal
        PM["Proxy Manager"]:::internal
        OW["Output Writer"]:::internal
    end

    %% External Services
    Google["Google Signup Pages"]:::external
    SMSService["sms-activate.org"]:::external
    ProxyProv["Proxy Providers"]:::external

    %% Generated Artifacts
    subgraph "Generated Artifacts"
        CTXT["Created.txt"]:::data
        PROFILES["Local Browser Profiles"]:::data
    end

    %% Project Dependencies
    Req["requirements.txt"]:::data

    %% Data Flows & Control Flow
    FNDB -->|1 CSV read| DRG
    LNDB -->|1 CSV read| DRG
    UICSV -->|1 CSV read| DRG
    PDB -->|1 CSV read| PM

    AppFile --> CFG
    CFG --> DRG
    CFG --> WDM
    CFG --> SBA
    CFG --> SMSC
    CFG --> PM
    CFG --> OW

    DRG -->|2 configure driver| WDM
    DRG -->|3 prepare data| SBA

    WDM -->|driver download| Req

    PM -->|5 apply proxy| SBA
    PM -->|5 fetch proxy| ProxyProv

    SBA -->|3 HTTP actions| Google
    SBA -->|result| OW

    SMSC -->|4 send/receive| SMSService
    OW -->|6 write| CTXT

    %% Click Events
    click FNDB "https://github.com/ai-to-ai/auto-gmail-creator/blob/master/data/First_Name_DB.csv"
    click LNDB "https://github.com/ai-to-ai/auto-gmail-creator/blob/master/data/Last_Name_DB.csv"
    click PDB "https://github.com/ai-to-ai/auto-gmail-creator/blob/master/data/Proxy_DB.csv"
    click UICSV "https://github.com/ai-to-ai/auto-gmail-creator/blob/master/user.csv"
    click AppFile "https://github.com/ai-to-ai/auto-gmail-creator/blob/master/app.py"
    click Req "https://github.com/ai-to-ai/auto-gmail-creator/blob/master/requirements.txt"

    %% Styles
    classDef internal fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef data fill:#90EE90,stroke:#000,stroke-width:1px
    classDef external fill:#FFA500,stroke:#000,stroke-width:1px
```
