# 0x178f/yandexmail-account-creator architecture

> Architecture diagram of the GitHub repository 0x178f/yandexmail-account-creator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/0x178f/yandexmail-account-creator
- Repository: https://github.com/0x178f/yandexmail-account-creator

## Overview

This repository is a command-line Yandex account creator. Its main workflow collects creation and network options, builds account details and a captcha client, then runs registration; successful accounts are saved, with optional IMAP setup. Proxy rotation and Android-based network changes are alternate IP-management capabilities, and account creation can use multiple threads. The graph includes the documented capabilities and the sampled runtime modules. Some registration and IMAP request details are omitted from the excerpts, so only documented or visible relationships are shown.

Main entry points: [`utils/Helper.py`](https://github.com/0x178f/yandexmail-account-creator/blob/master/utils/Helper.py) (Account and utilities), [`main.py`](https://github.com/0x178f/yandexmail-account-creator/blob/master/main.py) (CLI and workers), [`base/YandexRegister.py`](https://github.com/0x178f/yandexmail-account-creator/blob/master/base/YandexRegister.py) (Registration coordinator), [`base/BaseRequests.py`](https://github.com/0x178f/yandexmail-account-creator/blob/master/base/BaseRequests.py) (Yandex request session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI orchestration"]
  node_main["CLI and workers<br/>[main.py]"]
end

subgraph group_account["Account workflow"]
  node_helper["Account and utilities<br/>[Helper.py]"]
  node_register["Registration coordinator<br/>[YandexRegister.py]"]
  node_requests["Yandex request session<br/>[BaseRequests.py]"]
  node_logger["Registration logger<br/>[Logger.py]"]
end

subgraph group_network["Network options"]
  node_android{{"Android device"}}
  node_adb["ADB tools"]
  node_ipify{{"IP lookup service"}}
  node_proxies["Proxy list<br/>[proxies.txt]"]
  node_usedproxy["Used proxies<br/>[usedproxy.txt]"]
end

subgraph group_integrations["External services and state"]
  node_captcha2["2Captcha client<br/>[_2captcha.py]"]
  node_captcha3["CapMonster client<br/>[Capmonster.py]"]
  node_yandex{{"Yandex services"}}
  node_captcha_service{{"Captcha providers"}}
  node_settings["Creator settings<br/>[settings.json]"]
  node_names["Name lists<br/>[firstname.txt]"]
  node_created[("Created accounts<br/>[createdAccs.txt]")]
end

node_user(("Operator"))

node_user -->|"selects options"| node_main
node_main -->|"builds account"| node_helper
node_helper -->|"reads settings"| node_settings
node_helper -->|"reads names"| node_names
node_helper -->|"creates client"| node_captcha2
node_helper -->|"creates client"| node_captcha3
node_main -->|"starts registration"| node_register
node_register -->|"delegates requests"| node_requests
node_register -->|"solves challenge"| node_captcha_service
node_captcha2 -->|"submits challenge"| node_captcha_service
node_captcha3 -->|"submits challenge"| node_captcha_service
node_requests -->|"requests registration"| node_yandex
node_requests -->|"uses encoder"| node_logger
node_requests -->|"configures IMAP"| node_yandex
node_register -->|"loads and records"| node_helper
node_helper -->|"reads and removes"| node_proxies
node_helper -->|"appends account"| node_created
node_helper -->|"appends proxy"| node_usedproxy
node_main -->|"starts ADB"| node_adb
node_helper -->|"connects and toggles data"| node_android
node_main -->|"changes mobile IP"| node_helper
node_helper -->|"checks IP"| node_ipify

click node_main "https://github.com/0x178f/yandexmail-account-creator/blob/master/main.py"
click node_helper "https://github.com/0x178f/yandexmail-account-creator/blob/master/utils/Helper.py"
click node_register "https://github.com/0x178f/yandexmail-account-creator/blob/master/base/YandexRegister.py"
click node_requests "https://github.com/0x178f/yandexmail-account-creator/blob/master/base/BaseRequests.py"
click node_logger "https://github.com/0x178f/yandexmail-account-creator/blob/master/base/Logger.py"
click node_captcha2 "https://github.com/0x178f/yandexmail-account-creator/blob/master/utils/_2captcha.py"
click node_captcha3 "https://github.com/0x178f/yandexmail-account-creator/blob/master/utils/Capmonster.py"
click node_adb "https://github.com/0x178f/yandexmail-account-creator/tree/master/adb"
click node_settings "https://github.com/0x178f/yandexmail-account-creator/blob/master/settings.json"
click node_names "https://github.com/0x178f/yandexmail-account-creator/blob/master/data/firstname.txt"
click node_proxies "https://github.com/0x178f/yandexmail-account-creator/blob/master/data/proxies.txt"
click node_created "https://github.com/0x178f/yandexmail-account-creator/blob/master/data/createdAccs.txt"
click node_usedproxy "https://github.com/0x178f/yandexmail-account-creator/blob/master/data/usedproxy.txt"

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_main toneBlue
class node_helper,node_register,node_requests,node_logger toneAmber
class node_android,node_adb,node_ipify,node_proxies,node_usedproxy toneMint
class node_captcha2,node_captcha3,node_yandex,node_captcha_service,node_settings,node_names,node_created toneRose
class node_user toneIndigo
```

## Components

### CLI orchestration

- [CLI and workers](https://github.com/0x178f/yandexmail-account-creator/blob/master/main.py): `main.py`

### Account workflow

- [Account and utilities](https://github.com/0x178f/yandexmail-account-creator/blob/master/utils/Helper.py): `utils/Helper.py`
- [Registration coordinator](https://github.com/0x178f/yandexmail-account-creator/blob/master/base/YandexRegister.py): `base/YandexRegister.py`
- [Yandex request session](https://github.com/0x178f/yandexmail-account-creator/blob/master/base/BaseRequests.py): `base/BaseRequests.py`
- [Registration logger](https://github.com/0x178f/yandexmail-account-creator/blob/master/base/Logger.py): `base/Logger.py`

### Network options

- **Android device**
- [ADB tools](https://github.com/0x178f/yandexmail-account-creator/tree/master/adb): `adb`
- **IP lookup service**
- [Proxy list](https://github.com/0x178f/yandexmail-account-creator/blob/master/data/proxies.txt): `data/proxies.txt`
- [Used proxies](https://github.com/0x178f/yandexmail-account-creator/blob/master/data/usedproxy.txt): `data/usedproxy.txt`

### External services and state

- [2Captcha client](https://github.com/0x178f/yandexmail-account-creator/blob/master/utils/_2captcha.py): `utils/_2captcha.py`
- [CapMonster client](https://github.com/0x178f/yandexmail-account-creator/blob/master/utils/Capmonster.py): `utils/Capmonster.py`
- **Yandex services**
- **Captcha providers**
- [Creator settings](https://github.com/0x178f/yandexmail-account-creator/blob/master/settings.json): `settings.json`
- [Name lists](https://github.com/0x178f/yandexmail-account-creator/blob/master/data/firstname.txt): `data/firstname.txt`
- [Created accounts](https://github.com/0x178f/yandexmail-account-creator/blob/master/data/createdAccs.txt): `data/createdAccs.txt`

### Other components

- **Operator**

## Connections

- Operator → CLI and workers: selects options (evidence: `main.py`)
- CLI and workers → Account and utilities: builds account (evidence: `main.py`)
- Account and utilities → Creator settings: reads settings (evidence: `utils/Helper.py`)
- Account and utilities → Name lists: reads names (evidence: `utils/Helper.py`)
- Account and utilities → 2Captcha client: creates client (evidence: `utils/Helper.py`)
- Account and utilities → CapMonster client: creates client (evidence: `utils/Helper.py`)
- CLI and workers → Registration coordinator: starts registration (evidence: `main.py`)
- Registration coordinator → Yandex request session: delegates requests (evidence: `base/YandexRegister.py`)
- Registration coordinator → Captcha providers: solves challenge (evidence: `base/YandexRegister.py`)
- 2Captcha client → Captcha providers: submits challenge (evidence: `utils/_2captcha.py`)
- CapMonster client → Captcha providers: submits challenge (evidence: `utils/Capmonster.py`)
- Yandex request session → Yandex services: requests registration (evidence: `base/BaseRequests.py`)
- Yandex request session → Registration logger: uses encoder (evidence: `base/BaseRequests.py`)
- Yandex request session → Yandex services: configures IMAP (evidence: `base/BaseRequests.py`)
- Registration coordinator → Account and utilities: loads and records (evidence: `base/YandexRegister.py`)
- Account and utilities → Proxy list: reads and removes (evidence: `utils/Helper.py`)
- Account and utilities → Created accounts: appends account (evidence: `utils/Helper.py`)
- Account and utilities → Used proxies: appends proxy (evidence: `utils/Helper.py`)
- CLI and workers → ADB tools: starts ADB
- Account and utilities → Android device: connects and toggles data (evidence: `utils/Helper.py`)
- CLI and workers → Account and utilities: changes mobile IP (evidence: `main.py`)
- Account and utilities → IP lookup service: checks IP (evidence: `utils/Helper.py`)
