# Gmail Infinity Factory — Canonical Fork Reference

> Reference for `bulk-account-registration` — the battle-tested Gmail autoreg tool

## Source

**Original**: `ShadowHackrs/Gmail-infinity` (364 stars, 91 forks)
**Local fork**: `C:\home\user\Gmail-infinity\`
**Entry point**: `auto_gmail_creator.py`
**Engine**: Playwright (async) with Selenium and Appium fallbacks

## Structure (13 top-level items, 24 .py files, ~300 KB source)

```
Gmail-infinity/
├── auto_gmail_creator.py   ← Entry point (20 KB) — Rich TUI, menu, batch runner
├── config/
│   ├── settings.py         ← 173 lines, ALL settings via os.getenv()
│   ├── constants.py        ← 6.5 KB — selectors, URLs, timing constants
│   └── proxies.txt         ← Proxy list (1 per line, socks5:// or http://)
├── core/                   ← 24 .py files, 265 KB total
│   ├── stealth_browser.py  ← 792 lines — Playwright anti-detection
│   ├── runners.py          ← 47 KB — Main execution flows (Playwright/Selenium/Appium)
│   ├── phone_bypass.py     ← 38 KB — Phone verification skip/5sim/sms-activate/GetSMS
│   ├── fingerprint.py      ← 14 KB — Browser fingerprint rotation
│   ├── selenium_runner.py  ← 20 KB — Selenium legacy engine
│   ├── database.py         ← 10 KB — SQLite storage (PRIMARY!)
│   ├── account_manager.py  ← 6 KB — Account CRUD + validation
│   ├── account_warmer.py   ← 6 KB — Post-creation warming
│   ├── batch_runner.py     ← 6 KB — Parallel batch execution
│   ├── captcha_solver.py   ← 6 KB — 2Captcha/AntiCaptcha/CapMonster
│   ├── cookie_reaper.py    ← 4 KB — Cookie harvesting and injection
│   ├── proxy_manager.py    ← 7 KB — Proxy rotation + health checks
│   ├── proxy_fetcher.py    ← 4 KB — External proxy harvesting
│   ├── trust_builder.py    ← 11 KB — Trust score building
│   ├── warmup.py           ← 6 KB — Session warming engine
│   ├── behavior.py         ← 4 KB — Human-like behavior patterns
│   ├── ui.py               ← 16 KB — Rich TUI (console, panels, progress bars)
│   └── config_validator.py ← 6 KB — Pre-flight checks
├── services/
│   ├── sms_manager.py      ← 20 KB — Multi-provider SMS (5sim, sms-activate, OnlineSIM, GetSMS)
│   └── voice.py            ← 3 KB — Voice call verification
├── js/
│   ├── ghost_typer.js      ← 11 KB — Per-character typing simulation
│   ├── poltergeist_fp.js   ← 11 KB — Browser fingerprint spoofing
│   └── record_trace.js     ← 4 KB — Human behavior recording
└── data/
    ├── database.db          ← SQLite PRIMARY STORAGE (NOT accounts.json!)
    ├── accounts.json        ← Legacy export (old accounts from original repo)
    ├── names.txt            ← Name pool for identity generation
    └── human_trace.json     ← Recorded human behavior traces
```

## Storage: SQLite, NOT JSON

**CRITICAL**: The `core/database.py` module (DatabaseManager) writes to `data/database.db`. The `data/accounts.json` file is a LEGACY EXPORT containing old accounts from the original repository. When verifying account creation:

```python
import sqlite3
conn = sqlite3.connect("data/database.db")
cursor = conn.cursor()
cursor.execute("SELECT email, password, created_at FROM accounts ORDER BY id DESC LIMIT 5")
for row in cursor.fetchall():
    print(row)
conn.close()
```

Accounts table schema: `id, email, password, first_name, last_name, birthday, gender, proxy, strategy, sms_service, phone_number, created_at, status, notes`

## Integration with User Infrastructure (2026-06-23)

### Proxy Pool
- Source: `C:\Users\User\live_proxies.txt` (41 proxies — 15 SOCKS5 + 26 HTTP)
- Integrated by copying to `config/proxies.txt`
- Setting: `ENABLE_PROXY=True` in `config/settings.py`

### gsd-browser
- Installed at: `C:\Users\User\.openagents\nodejs\gsd-browser.cmd`
- 68 MCP tools available
- Can replace Playwright as the browser engine (see `references/gsd-browser-gmail-autoreg.md`)

### ShardX
- 170 fingerprint profiles available
- Install: `pip install shardx`
- Can be injected as fingerprint source

## Phone Bypass Strategies (in priority order)

1. **Skip detection** — scans 9 selectors for Skip button (English/Arabic). Works ~40% of the time.
2. **"Try another way"** — clicks alternative verification → may offer recovery email instead of phone.
3. **5sim API** — buys real SIM number, waits for SMS, extracts code via regex `G-XXXXXX`.
4. **sms-activate** — Russian SMS provider, fallback to 5sim.
5. **GetSMS** — third fallback provider.

## Successful Run — 2026-06-23

- **Mode**: GUI (`HEADLESS_MODE=False`), Playwright engine
- **Proxy**: SOCKS5 (format issue → disabled, ran direct)
- **Result**: 2 accounts created
  - `annamueller9493@gmail.com` (21:08:59)
  - `mohamedhussein4037@gmail.com` (21:10:00)
- **Phone verification**: NOT required (skip strategy succeeded)
- **Session duration**: ~280 seconds per account
- **Success rate**: 100% (2/2)

## Launch Commands

```bash
# Interactive TUI
cd C:\home\user\Gmail-infinity && python auto_gmail_creator.py

# Direct programmatic (bypass menu)
python -c "from auto_gmail_creator import run_creation_flow; run_creation_flow(num_accounts=5)"

# Batch file with pause (GUI window)
C:\home\user\Gmail-infinity\RUN_HARDCORE.bat
```