### Minimal .env Configuration

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/README.md

Sets up the basic environment variables for the engine mode and headless browser operation. This is the most basic configuration to get started.

```bash
# .env file
ENGINE_MODE=playwright
HEADLESS_MODE=False
```

--------------------------------

### Telegram Notifications Setup

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Example configuration for setting up Telegram notifications. Requires a bot token from @BotFather and your Telegram chat ID.

```bash
TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
TELEGRAM_CHAT_ID=1234567890
```

--------------------------------

### Account Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Example .env file demonstrating account-specific settings like birthday, gender, password, and recovery options.

```bash
YOUR_BIRTHDAY=5 20 1995
YOUR_GENDER=1
YOUR_PASSWORD=
RECOVERY_EMAIL=backup@example.com
```

--------------------------------

### System Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Example configuration settings for the system, including concurrent creations, headless mode, and debug mode.

```yaml
system:
  max_concurrent_creations: 5   # Max parallel account creation workers
  headless_mode: true           # Run browser headless (true = faster)
  debug_mode: false             # Verbose debug logging
```

--------------------------------

### Example Browser Viewport Configuration

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the browser viewport configuration dictionary.

```python
viewport = {
    "width": 1366,
    "height": 768
}
```

--------------------------------

### Proxy File Format Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Illustrates the expected format for the proxy list file. Each proxy should be on a new line, with comments starting with '#'. Supports various proxy formats including SOCKS and authenticated HTTPS.

```text
# Comments start with #
192.168.1.1:8080
socks5://proxy.example.com:1080
https://192.168.1.2:3128:username:password
# This proxy will be skipped
10.0.0.1:8080
```

--------------------------------

### Install Project Dependencies

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Installs all Python dependencies listed in the requirements.txt file.

```bash
pip install -r requirements.txt
```

--------------------------------

### Recommended Workflow Steps

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

A step-by-step guide for using the application, from launching to creating and managing accounts.

```text
1. Launch the app     →  python main.py
2. Select [6]         →  Test and configure proxies first
3. Select [1]         →  Create one free account to validate setup
4. Select [2]         →  Create one Premium account with SMS verification
5. Select [3]         →  Create a batch of accounts
6. Select [5]         →  Warm up all created accounts
7. Select [8]         →  View and export accounts to CSV
8. Select [0]         →  Exit and save everything
```

--------------------------------

### Example Account Dictionary

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of a populated account dictionary, demonstrating the expected values for each field.

```python
account = {
    "id": 42,
    "email": "john.doe.1234@gmail.com",
    "password": "SecurePass123!",
    "first_name": "John",
    "last_name": "Doe",
    "birthday": "3 15 1990",
    "gender": "1",
    "proxy": "192.168.1.100:8080",
    "strategy": "standard",
    "sms_service": "5sim",
    "phone_number": "+12025551234",
    "created_at": "2024-05-31 15:30:45",
    "status": "active",
    "notes": "Verified with SMS"
}
```

--------------------------------

### Proxy Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Example of proxy configuration settings in the .env file, including enabling proxies, specifying the proxy file, type, rotation, and country codes.

```bash
ENABLE_PROXY=False
PROXY_FILE="config/proxies.txt"
PROXY_TYPE="residential"
ROTATE_PROXY_EVERY=1
PROXY_COUNTRY_ROTATION="US,GB,CA,AU"
MOBILE_PROXY_IP_CHANGE_URL=""
PROXY_CHANGE_WAIT_TIME=10
```

--------------------------------

### Example .env Configuration

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

This snippet shows an example of how to configure proxy settings in a .env file. It includes options for enabling proxies, specifying a proxy file, setting the proxy type, and rotation intervals.

```bash
ENABLE_PROXY=True
PROXY_FILE=config/proxies.txt
PROXY_TYPE=residential
ROTATE_PROXY_EVERY=1
PROXY_COUNTRY_ROTATION=US,GB,CA
```

--------------------------------

### Anti-QR Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Example .env file for Anti-QR settings, including options for realistic warmup, minimum warmup duration, forcing recovery email, and QR verification retries.

```bash
ENABLE_REALISTIC_WARMUP=True
WARMUP_MIN_DURATION=300
FORCE_RECOVERY_EMAIL=True
QR_MAX_RETRIES=3
```

--------------------------------

### Browser & Engine Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Example configuration for browser engine, headless mode, and timeouts. Use 'playwright' for fast, modern browser automation.

```bash
ENGINE_MODE=playwright
HEADLESS_MODE=False
BROWSER_TIMEOUT=30
```

--------------------------------

### Logging & Export Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Example configuration for enabling logging, setting log file path and level, and defining the export format for created accounts. Supports TXT, CSV, and JSON formats.

```bash
ENABLE_LOGGING=True
LOG_FILE=data/gmail_creator.log
LOG_LEVEL=INFO
EXPORT_FORMAT=csv
```

--------------------------------

### Proxy List Format Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Example format for listing proxies in the config/proxies.txt file, including different protocols and authentication methods.

```text
# Proxy format:
# protocol://host:port
# protocol://user:pass@host:port

http://192.168.1.1:8080
socks5://user:password@proxy.example.com:1080
https://residential.proxy.com:3128
```

--------------------------------

### Example Session Statistics Dictionary

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the session statistics dictionary.

```python
session = {
    "id": 5,
    "session_start": "2024-05-31 14:00:00",
    "total_attempts": 100,
    "successes": 92,
    "failures": 8,
    "strategies_used": '{"standard": 50, "youtube": 30, "workspace": 20}',
    "errors": '{"qr_blocked": 3, "timeout": 2, "ip_flagged": 3}',
    "duration_seconds": 3600.5
}
```

--------------------------------

### Example IP Info Dictionary

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the IP information dictionary as returned by ProxyManager.get_ip_info().

```python
info = {
    "ip": "203.0.113.42",
    "city": "Los Angeles",
    "country": "US",
    "org": "Residential ISP Inc.",
    "is_datacenter": False
}
```

--------------------------------

### Install CloakBrowser

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Installs the CloakBrowser package, with an optional installation for full support including GeoIP auto-detection.

```bash
pip install "cloakbrowser>=0.3.15"

# Full support with GeoIP auto-detection
pip install "cloakbrowser[geoip]"
```

--------------------------------

### Example Account Statistics Dictionary

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the account statistics dictionary.

```python
stats = {
    "total": 100,
    "active": 92,
    "success_rate": 92.0,
    "strategies": {
        "standard": 50,
        "youtube": 30,
        "workspace": 20
    },
    "sms_services": {
        "5sim": 60,
        "sms_activate": 30,
        "getsms": 10
    }
}
```

--------------------------------

### Install Playwright Browsers

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Installs the necessary browser binaries for Playwright, specifically Chromium.

```bash
playwright install chromium
```

--------------------------------

### Log Entry Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of a populated log entry dictionary, illustrating the expected data types and format for each field.

```python
log_entry = {
    "id": 1234,
    "timestamp": "2024-05-31 15:30:45",
    "level": "INFO",
    "message": "Account creation started for user1234@gmail.com"
}
```

--------------------------------

### Anti-Detection & Behavior Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Example settings for anti-detection features like session warming, fingerprint masking, and human typing errors. Adjust delay between accounts and warming intensity as needed.

```bash
ENABLE_SESSION_WARMING=True
ENABLE_FINGERPRINT_MASKING=True
ENABLE_HUMAN_TYPING_ERRORS=True
DELAY_BETWEEN_ACCOUNTS=30
WARMING_INTENSITY=high
```

--------------------------------

### Master Configuration File Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Shows the beginning of the master configuration file `config/settings.yaml`, indicating its purpose for system-wide settings.

```yaml
# ===========================
#  Gmail Infinity Factory 2026
#  Master System Configuration
```

--------------------------------

### Residential Proxy Configuration

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/README.md

Enables and configures the use of residential proxies. This setup specifies the proxy file, type, and rotation frequency, along with an example proxy list.

```bash
# .env file
ENABLE_PROXY=True
PROXY_FILE=config/proxies.txt
PROXY_TYPE=residential
ROTATE_PROXY_EVERY=1

# config/proxies.txt
192.168.1.1:8080
192.168.1.2:8080
socks5://proxy.example.com:1080
```

--------------------------------

### Example Proxy Statistics Dictionary

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the proxy statistics dictionary.

```python
stats = {
    "total": 50,
    "healthy": 45,
    "unhealthy": 5,
    "scores": {
        "192.168.1.1:8080": 95,
        "192.168.1.2:8080": 90,
        "192.168.1.3:8080": 75,
        # ... top 10 proxies
    }
}
```

--------------------------------

### Proxy Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Configuration for proxy settings, including provider type and rotation interval.

```yaml
proxy:
  provider: "residential_pool"  # residential / datacenter / mobile
  rotation_interval: 1          # Rotate proxy after every X operations
```

--------------------------------

### Install Optional SMS and CAPTCHA Providers

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Installs Python packages for supported SMS providers and CAPTCHA solvers.

```bash
# SMS providers
pip install fivesim smsactivateru

# CAPTCHA solvers
pip install 2captcha-python anticaptchaofficial capsolver
```

--------------------------------

### Using the Proxy Manager Singleton

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Demonstrates how to import and use the pre-initialized singleton instance of the Proxy Manager. Common operations include getting the next proxy and marking a proxy as successful.

```python
from core.proxy_manager import proxy_manager

# Use directly
proxy_manager.get_next()
proxy_manager.mark_success(proxy)
```

--------------------------------

### Basic Launch Command

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Command to launch the application and start the interactive TUI in the terminal.

```bash
python auto_gmail_creator.py
```

--------------------------------

### Example Attempt History Entry

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of an individual attempt history entry.

```python
attempt = {
    "strategy": "standard",
    "success": False,
    "error_type": "qr_blocked",
    "timestamp": 1717159200.123
}
```

--------------------------------

### Example Phone Data

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the phone data dictionary returned after renting a phone number from an SMS service.

```python
phone_data = {
    "phone": "+12025551234",
    "id": "order_123456",
    "service": "5sim"
}
```

--------------------------------

### Example Retry Engine Statistics Dictionary

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the retry engine statistics dictionary.

```python
stats = {
    "total_attempts": 50,
    "successes": 45,
    "failures": 5,
    "success_rate": 90.0,
    "strategy_scores": {
        "standard": 85,
        "youtube": 92,
        "workspace": 78,
        "mobile_ua": 60
    },
    "error_breakdown": {
        "phone_required": 2,
        "qr_blocked": 2,
        "timeout": 1
    }
}
```

--------------------------------

### Example Playwright Proxy Format

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of a proxy dictionary formatted for use with Playwright, including the server URL and authentication details.

```python
pw_proxy = {
    "server": "http://192.168.1.1:8080",
    "username": "admin",
    "password": "secret"
}
```

--------------------------------

### Captcha Solver Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Configuration for captcha solving services, specifying the provider and API key for CapSolver.

```yaml
  captcha:
    provider: "capsolver"
    capsolver:
      api_key: "YOUR_CAPSOLVER_API_KEY"
```

--------------------------------

### SMS Provider Configuration Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Configuration for SMS verification providers, specifying the primary provider and API keys for 5sim and sms_activate.

```yaml
verification:
  sms:
    primary_provider: "5sim"    # Primary SMS provider
    5sim:
      api_key: "YOUR_5SIM_API_KEY"
    sms_activate:
      api_key: "YOUR_SMS_ACTIVATE_API_KEY"
```

--------------------------------

### Example Health Check Summary

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of the summary dictionary returned after performing multiple account health checks.

```python
summary = {
    "total": 100,
    "active": 92,
    "locked": 5,
    "suspended": 2,
    "password_changed": 1,
    "errors": 0,
    "health_rate": 92.0
}
```

--------------------------------

### Example Parsed Proxy Data

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of a parsed proxy dictionary, showing host, port, username, and password extracted from a proxy string.

```python
# From "192.168.1.1:8080:admin:secret"
parsed = {
    "host": "192.168.1.1",
    "port": "8080",
    "user": "admin",
    "pass": "secret"
}
```

--------------------------------

### 5sim.net SMS Service Setup

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Configure 5sim.net for SMS services by setting your API key, desired country, and operator in the .env file.

```bash
FIVESIM_API_KEY=your_key_here
FIVESIM_COUNTRY=usa
FIVESIM_OPERATOR=any
```

--------------------------------

### SMS-Activate SMS Service Setup

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Configure SMS-Activate for SMS services by setting your API key and country code in the .env file.

```bash
SMS_ACTIVATE_API_KEY=your_key_here
SMS_ACTIVATE_COUNTRY=0
```

--------------------------------

### Phone Data Usage Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

Demonstrates how to use the phone data dictionary to retrieve an SMS code and finish the order with the specified service.

```python
code = await get_code_from_service(phone_data['service'], phone_data['id'])
await finish_order(phone_data['service'], phone_data['id'])
```

--------------------------------

### Get all accounts using AccountManager

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/database-manager.md

Demonstrates how to retrieve all accounts using the AccountManager, which internally utilizes the DatabaseManager.

```python
from core.account_manager import account_manager
accounts = account_manager.get_all()  # Uses internal DatabaseManager
```

--------------------------------

### Retry Engine Configuration via Environment Variables

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/retry-engine.md

Shows how retry behavior can be customized using environment variables through the `Config` object. This example references a delay setting between account creations.

```python
Config.DELAY_BETWEEN_ACCOUNTS  # Delay between account creations
```

--------------------------------

### Access Configuration in Python

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Import the Config class and access configuration options as attributes. This example shows how to print a loaded configuration value.

```python
from config.settings import Config
print(Config.YOUR_BIRTHDAY)  # "3 15 1990"
```

--------------------------------

### CSV Export Path Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Specifies the file path pattern for exporting saved accounts to a CSV file, including a timestamp.

```text
output/accounts_YYYYMMDD_HHMMSS.csv
```

--------------------------------

### Typo Simulation Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/behavior-engine.md

Illustrates the process of simulating typos during typing, including the correction steps. This makes automated typing appear more human.

```text
Input: "password"

Normal: p → a → s → s → w → o → r → d
With typo: p → a → z → (notice) → BACKSPACE → s → s → w → o → r → d

Timing:
- p (100ms)
- a (120ms)
- z (50ms, wrong char)
- notice (300ms pause)
- BACKSPACE
- s (80ms)
- ...
```

--------------------------------

### Get Recommended Next Strategy

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/retry-engine.md

Suggests the next account creation strategy based on the previously failed strategy and the encountered error type. Assumes 'CreationError' is defined.

```python
failed_strategy = "standard"
error = CreationError.QR_BLOCKED

next_strategy = retry_engine.get_next_strategy(failed_strategy, error)
# Might return "youtube" or "workspace"
print(f"Next strategy: {next_strategy}")
```

--------------------------------

### SMS Manager Configuration with API Keys

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/sms-manager.md

This bash snippet shows how to configure API keys for various SMS services in a .env file. It also includes example country codes for specific services like Fivesim and SMS Activate. Ensure these keys and settings are correctly placed for the application to function.

```bash
FIVESIM_API_KEY=your_key_here
SMS_ACTIVATE_API_KEY=your_key_here
ONLINESIM_API_KEY=your_key_here
GETSMS_API_KEY=your_key_here

FIVESIM_COUNTRY=usa
SMS_ACTIVATE_COUNTRY=0
```

--------------------------------

### Clone Repository and Navigate

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Initial steps to clone the project repository and navigate into the project directory.

```bash
git clone https://github.com/ShadowHackrs/Gmail-infinity.git
cd Gmail-infinity
```

--------------------------------

### User Agent String Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

Represents a standard HTTP User-Agent header value for browser identification. This string is often sourced from configuration files or dynamically generated.

```python
user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36"
```

--------------------------------

### Path Point Sequence Example

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

A list of coordinate tuples defining a path, typically generated by functions like `HumanBehavior.generate_bezier_curve()`. Used for simulating human-like mouse movements.

```python
path = [
    (100, 100),
    (120, 110),
    (150, 130),
    (200, 180),
    (300, 250),
    (500, 300)
]
```

--------------------------------

### Automatic Retry with Strategy Rotation

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/errors.md

Demonstrates using the RetryEngine to determine if a retry is necessary based on an error type and attempt count. It also shows how to get the next available strategy and calculate the cooldown period.

```python
from core.retry_engine import retry_engine, CreationError

error = CreationError.QR_BLOCKED
failed_strategy = "standard"

if retry_engine.should_retry(error, attempt_count=0):
    next_strategy = retry_engine.get_next_strategy(failed_strategy, error)
    cooldown = retry_engine.get_cooldown(0, error)
    print(f"Retrying with {next_strategy} after {cooldown}s")
else:
    print("Max retries exceeded")
```

--------------------------------

### Account Creation Flow

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/README.md

Outlines the step-by-step process for account creation, from entry point and configuration loading to browser initialization, execution, error handling, and final export.

```text
1. Entry: auto_gmail_creator.py main()
2. User selects mode (free/premium)
3. Config loaded from environment
4. Proxy selected via proxy_manager
5. Browser initialized (playwright, appium, selenium)
6. Account creation flow executed via runners
7. On error: RetryEngine determines retry strategy
8. On success: AccountManager saves account
9. Optional: AccountWarmer performs warmup activities
10. Export: AccountManager exports to CSV/JSON/TXT
```

--------------------------------

### Example Health Check Result

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/types.md

An example of a health check result dictionary for a single account.

```python
result = {
    "email": "user@gmail.com",
    "status": "active",
    "message": "Login successful",
    "checked_at": "2024-05-31 15:35:22"
}
```

--------------------------------

### Create and Activate Virtual Environment

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Instructions for creating and activating a Python virtual environment on Windows and Linux/macOS.

```bash
# Windows
python -m venv venv
virtualenv\Scripts\activate

# Linux / macOS
python3 -m venv venv
source venv/bin/activate
```

--------------------------------

### Load Configuration from .env File

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Create a .env file in the project root to override default configuration values. These settings are loaded into the Config class.

```bash
# .env file
YOUR_BIRTHDAY=3 15 1990
YOUR_PASSWORD=MySecurePassword123
ENABLE_PROXY=True
PROXY_FILE=config/proxies.txt
```

--------------------------------

### Instantiate DatabaseManager

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/database-manager.md

Demonstrates how to create an instance of the DatabaseManager class. This is typically done once for singleton-like usage within the application.

```python
from core.database import DatabaseManager

# Create instance
db = DatabaseManager()
```

--------------------------------

### Using the Retry Engine Singleton Instance

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/retry-engine.md

Demonstrates how to import and use the pre-initialized singleton instance of the Retry Engine and its associated `CreationError` constants. This is the standard way to interact with the retry logic in the application.

```python
from core.retry_engine import retry_engine, CreationError

# Use directly
if retry_engine.should_retry(CreationError.PHONE_REQUIRED, 1):
    strategy = retry_engine.get_next_strategy("standard", CreationError.PHONE_REQUIRED)
    cooldown = retry_engine.get_cooldown(1, CreationError.PHONE_REQUIRED)
```

--------------------------------

### Project Structure Overview

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Displays the directory structure of the Gmail Infinity Factory project, detailing the purpose of key files and directories.

```bash
gmail_infinity_factory_2026/
│
├── main.py                    # Entry point — TUI application (3,292 lines)
├── requirements.txt           # Python dependencies
├── .gitignore                 # Git exclusions
│
├── config/
│   ├── settings.yaml          # Master config (SMS, CAPTCHA, Proxy, Browser)
│   ├── fingerprints.json      # Digital fingerprint database (50k+ entries)
│   └── proxies.txt            # Proxy list
│
├── core/
│   ├── __init__.py
│   ├── stealth_browser.py     # Stealth browser framework (CloakBrowser + Playwright)
│   ├── behavior_engine.py     # Human behavior simulation (Mouse, Keyboard, Scroll)
│   ├── fingerprint_generator.py  # Fingerprint generator (UA, Screen, GPU, Audio, Font)
│   ├── detection_evasion.py   # Detection bypass layer (webdriver, CDP, headless leaks)
│   ├── cloak_launcher.py      # CloakBrowser launcher with automatic Playwright fallback
│   └── proxy_manager.py       # Advanced proxy manager with rotation, health-check & stats
│
├── creators/                  # Account creation strategies
│   └── ...
│
├── identity/                  # Persona and identity generation
│   └── ...
│
├── verification/
│   ├── __init__.py
│   ├── sms_providers.py       # SMS API clients (5sim, sms-activate, textverified)
│   ├── captcha_solver.py      # CAPTCHA solvers (CapSolver, 2Captcha, AntiCaptcha)
│   ├── email_recovery.py      # Recovery email management and verification
│   └── voice_verification.py  # Voice verification as SMS alternative
│
├── warming/
│   ├── __init__.py
│   ├── activity_simulator.py  # Gmail activity simulation (read, compose, organize)
│   ├── google_services.py     # YouTube + Google Search warmup engines
│   └── reputation_builder.py  # Sender score and trust reputation builder
│
├── api/
│   └── ...
│
├── output/                    # Output files (excluded from Git)
│   ├── successful_accounts.json
│   ├── failed_attempts.json
│   └── metrics.json
│
├── credentials/               # Encrypted credentials (excluded from Git)
│   ├── accounts.enc
│   └── .vault.key
│
└── logs/                      # Runtime logs (excluded from Git)
    └── gmail_factory_YYYYMMDD.log

```

--------------------------------

### ProxyManager Properties

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Access properties of the ProxyManager to get information about the loaded proxies.

```APIDOC
## ProxyManager Properties

### count

Returns the total number of loaded proxies.

#### Property
`count` -> `int`

#### Example
```python
total_proxies = proxy_manager.count
print(f"Total proxies loaded: {total_proxies}")
```

---

### healthy_count

Returns the number of currently healthy proxies.

#### Property
`healthy_count` -> `int`

#### Example
```python
healthy = proxy_manager.healthy_count
print(f"Healthy proxies: {healthy}/{proxy_manager.count}")
```
```

--------------------------------

### Initialize RetryEngine

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/retry-engine.md

Initializes a new instance of the RetryEngine. No parameters are required.

```python
RetryEngine()
```

--------------------------------

### Get Total Account Count

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/account-manager.md

Returns the total number of accounts currently saved in the database.

```python
total = account_manager.get_count()
print(f"Total accounts: {total}")
```

--------------------------------

### run_migration()

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/database-manager.md

Migrates accounts from legacy file formats (JSON and TXT) to the SQLite database. It handles duplicate emails and logs the migration progress.

```APIDOC
## run_migration()

### Description
Migrates accounts from legacy file formats to SQLite database.

### Method
`self.run_migration`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
* **old_json_path** (str) - Optional - Path to legacy JSON file. Defaults to "data/accounts.json".
* **old_txt_path** (str) - Optional - Path to legacy TXT file. Defaults to "data/accounts.txt".

### Request Example
```python
migrated = db.run_migration()
print(f"Migrated {migrated} accounts from legacy format")
```

### Response
#### Success Response (int)
Returns the total number of accounts migrated from both JSON and TXT sources.

#### Response Example
```
542
```
```

--------------------------------

### Get Proxy Statistics

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Retrieves summary statistics about all loaded proxies. Use this to monitor the health and distribution of your proxies.

```python
stats = proxy_manager.get_stats()
print(f"Total: {stats['total']}, Healthy: {stats['healthy']}")
print(f"Top scores: {stats['scores']}")
```

--------------------------------

### Get Last Created Account

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/account-manager.md

Retrieves the most recently created account from the database. Returns None if no accounts exist.

```python
last = account_manager.get_last_account()
if last:
    print(f"Last account: {last['email']}")
```

--------------------------------

### Headless/Fast Mode Configuration

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Configure settings for a faster, headless operation. This includes enabling headless mode, setting a short delay between accounts, and a low warming intensity.

```bash
HEADLESS_MODE=True
DELAY_BETWEEN_ACCOUNTS=10
WARMING_INTENSITY=low
```

--------------------------------

### Get Highest Scoring Proxy

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Retrieve the proxy with the highest score from the healthy pool. This is useful for selecting the most reliable proxy.

```python
best = proxy_manager.get_best()
if best:
    print(f"Best proxy by score: {best}")
```

--------------------------------

### Get Total Proxies

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Retrieve the total number of proxies loaded into the manager. Useful for monitoring the proxy pool size.

```python
total_proxies = proxy_manager.count
print(f"Total proxies loaded: {total_proxies}")
```

--------------------------------

### Initialize AccountManager

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/account-manager.md

Initializes the AccountManager. It uses a singleton instance exported as 'account_manager'.

```python
AccountManager()
```

--------------------------------

### Get accounts grouped by strategy

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/database-manager.md

Retrieves all accounts and counts them based on their associated strategy. Accounts without a strategy are grouped under 'unknown'.

```python
accounts = db.get_all_accounts()
by_strategy = {}

for acc in accounts:
    strategy = acc['strategy'] or 'unknown'
    by_strategy[strategy] = by_strategy.get(strategy, 0) + 1

print(f"Accounts by strategy: {by_strategy}")
```

--------------------------------

### Get Next Proxy in Round-Robin

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Retrieve the next proxy in a round-robin fashion from the healthy pool. Maintains its position across calls.

```python
proxy = proxy_manager.get_next()
if proxy:
    print(f"Next proxy: {proxy}")
```

--------------------------------

### Get Healthy Proxies Count

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Retrieve the number of proxies that are currently marked as healthy. This helps in understanding the available pool for operations.

```python
healthy = proxy_manager.healthy_count
print(f"Healthy proxies: {healthy}/{proxy_manager.count}")
```

--------------------------------

### Define Available Strategies

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/retry-engine.md

Lists the available account creation strategies that can be used by the RetryEngine.

```python
STRATEGIES = ["standard", "youtube", "workspace", "mobile_ua"]
```

--------------------------------

### TUI Interactive Menu

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

The main interactive menu displayed when the application starts, showing available options for account creation and management.

```text
╔══════════════════════════════════════════════════════════╗
║           GMAIL  INFINITY  FACTORY  2026                  ║
║                  v2026.1.0  |  by Shadow                  ║
╠══════════════════════════════════════════════════════════╣
║  [1]  SINGLE_FREE     →  Create one account (no SMS)      ║
║  [2]  SINGLE_PREMIUM  →  Create one account (with SMS)    ║
║  [3]  BATCH_CREATE    →  Create a batch of accounts       ║
║  [4]  CONTINUOUS      →  Auto-create until target count   ║
║  [5]  ACCOUNT_WARM    →  Warm up created accounts         ║
║  [6]  PROXY_MANAGER   →  Test and manage proxies          ║
║  [7]  DASHBOARD       →  Live session statistics          ║
║  [8]  SAVED_ACCOUNTS  →  View and export accounts         ║
║  [9]  CONFIGURATION   →  Settings and API keys            ║
║  [0]  EXIT            →  Shutdown and save everything     ║
╚══════════════════════════════════════════════════════════╝
```

--------------------------------

### Account Warming Module: Google Services Simulation

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Describes the engines for simulating YouTube watch sessions and Google Searches.

```markdown
| File | Description |
|------|-------------|
| `google_services.py` | YouTube watch session and Google Search simulation engines |
```

--------------------------------

### Premium Mode Configuration (With SMS)

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Configure the system for premium mode by providing SMS service API keys and country, and forcing recovery emails to be true.

```bash
FIVESIM_API_KEY=your_key
FIVESIM_COUNTRY=usa
FORCE_RECOVERY_EMAIL=True
```

--------------------------------

### Handle USERNAME_TAKEN Error

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/errors.md

Provides an example for handling the USERNAME_TAKEN error by generating a new username. Use when the desired Gmail address is already in use.

```python
if error == CreationError.USERNAME_TAKEN:
    # Always retry, but with new username
    new_username = generate_username()  # Different name
    # Retry with same strategy and proxy
```

--------------------------------

### Validate Configuration Settings

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Use this method to check for required API keys, readable file paths, valid numeric ranges, and proper boolean formatting. It returns a list of warnings.

```python
from config.settings import Config

warnings = Config.validate()
for warning in warnings:
    print(f"⚠️  {warning}")
```

--------------------------------

### Get Random Healthy Proxy

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/proxy-manager.md

Select and return a random proxy from the pool of healthy proxies. Falls back to any proxy if no healthy ones are available.

```python
proxy = proxy_manager.get_random()
if proxy:
    print(f"Selected proxy: {proxy}")
```

--------------------------------

### Get Best Initial Strategy

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/retry-engine.md

Retrieves the name of the strategy with the highest current score. This is used to decide which strategy to employ for a new account creation attempt.

```python
best = retry_engine.get_best_initial_strategy()
print(f"Starting with best strategy: {best}")
```

--------------------------------

### Handle PHONE_REQUIRED Error

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/errors.md

Demonstrates how to handle the PHONE_REQUIRED error by checking if a retry is allowed and getting the next strategy. Use when phone verification is unexpectedly required.

```python
from core.retry_engine import retry_engine, CreationError

if error == CreationError.PHONE_REQUIRED:
    if retry_engine.should_retry(error, attempt=0):
        next_strategy = retry_engine.get_next_strategy("standard", error)
        # next_strategy might be "youtube"
```

--------------------------------

### Proxy Mode Configuration

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/configuration.md

Configure the system to use proxies by enabling proxy mode, specifying the proxy file, type, and rotation interval.

```bash
ENABLE_PROXY=True
PROXY_FILE=config/proxies.txt
PROXY_TYPE=residential
ROTATE_PROXY_EVERY=1
```

--------------------------------

### Get Account Statistics

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/account-manager.md

Calculates and returns statistics about all accounts, including total count, active count, success rate, and counts by strategy and SMS service.

```python
stats = account_manager.get_stats()
print(f"Total: {stats['total']}, Success Rate: {stats['success_rate']:.1f}%")
print(f"Strategies: {stats['strategies']}")
# Output: Strategies: {'standard': 45, 'youtube': 30, 'workspace': 25}
```

--------------------------------

### get_best_initial_strategy()

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/retry-engine.md

Retrieves the name of the strategy with the highest score, recommended for initiating new account creation attempts.

```APIDOC
## get_best_initial_strategy()

### Description
Returns the highest-scoring strategy for starting a new creation attempt.

### Method
`get_best_initial_strategy(self) -> str`

### Parameters
None

### Returns
- **str** - Strategy name with highest score

### Request Example
```python
best = retry_engine.get_best_initial_strategy()
print(f"Starting with best strategy: {best}")
```

### Response
None

### Error Handling
None explicitly defined for this method's direct invocation.
```

--------------------------------

### SMS Verification Configuration

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/README.md

Configures SMS verification services by providing an API key and specifying the country for verification. It also disables proxy usage for this setup.

```bash
# .env file
FIVESIM_API_KEY=your_api_key_here
FIVESIM_COUNTRY=usa
ENABLE_PROXY=False
```

--------------------------------

### Initialize DatabaseManager

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/database-manager.md

Instantiate the DatabaseManager to interact with the SQLite database. Supports default or custom file paths.

```python
from core.database import DatabaseManager

# Default database location
db = DatabaseManager()

# Custom location
db = DatabaseManager("custom/path/accounts.db")
```

--------------------------------

### Account Warming Module: Activity Simulator

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/README.md

Details the simulation of Gmail activities for account warming purposes.

```markdown
| File | Description |
|------|-------------|
| `activity_simulator.py` | Full Gmail activity simulation — reading, composing, and organizing emails |
```

--------------------------------

### Handle Account Creation Failures with Retry Engine

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/README.md

Shows how to use the retry engine to manage account creation errors. It checks if a retry is needed based on the error type and attempt count, and determines the next strategy and cooldown period.

```python
from core.retry_engine import retry_engine, CreationError

error = CreationError.QR_BLOCKED
attempt = 0

if retry_engine.should_retry(error, attempt):
    next_strategy = retry_engine.get_next_strategy("standard", error)
    cooldown = retry_engine.get_cooldown(attempt, error)
    
    print(f"Retrying with {next_strategy} after {cooldown}s")
    time.sleep(cooldown)
    
    # Try again with different strategy
else:
    print("Max retries exceeded")
```

--------------------------------

### Get accounts created in the last 24 hours

Source: https://github.com/shadowhackrs/gmail-infinity/blob/main/_autodocs/api-reference/database-manager.md

Retrieves all accounts and filters them to find those created within the last 24 hours. Requires datetime and timedelta imports.

```python
from datetime import datetime, timedelta

accounts = db.get_all_accounts()
yesterday = datetime.now() - timedelta(days=1)

recent = [a for a in accounts 
          if datetime.fromisoformat(a['created_at']) > yesterday]
print(f"Accounts created in last 24h: {len(recent)}")
```