# xdreizein666/getcontact-cli architecture

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

- Interactive diagram: https://gitdiagram.com/xdreizein666/getcontact-cli
- Repository: https://github.com/xdreizein666/getcontact-cli

## Overview

GetContact CLI is a single-file Python client for authenticated GetContact lookups and account management. Its main workflow accepts a command or interactive choice, selects credentials, makes encrypted API requests, formats results, and saves command output locally. Additional branches cover CSV batch lookup, quota checks, captcha handling, and WhatsApp-verified account generation. The README documents these capabilities; the sampled source is partial, so internal links for unsampled command details are omitted.

Main entry points: [`gtc.py`](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py) (Interactive menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["CLI interface"]
  node_entry["CLI entry<br/>[gtc.py]"]
  node_interactive["Interactive menu<br/>[gtc.py]"]
  node_commands["Command dispatch<br/>[gtc.py]"]
end

subgraph group_accounts["Accounts and verification"]
  node_credentials["Credential management<br/>[gtc.py]"]
  node_generate["Account generation<br/>[gtc.py]"]
  node_verifykit["VerifyKit verification<br/>[gtc.py]"]
end

subgraph group_service["API operations"]
  node_search["Profile and tag lookup<br/>[gtc.py]"]
  node_batch["CSV batch lookup<br/>[gtc.py]"]
  node_quota["Quota check<br/>[gtc.py]"]
  node_captcha["Captcha handling<br/>[gtc.py]"]
  node_api["API request and crypto<br/>[gtc.py]"]
end

subgraph group_local["Local data"]
  node_credential_file[("Credential store<br/>[gtc.py]")]
  node_output["Result formatting<br/>[gtc.py]"]
  node_results["Saved results<br/>[gtc.py]"]
end

node_user(("CLI user"))
node_getcontact{{"GetContact API"}}
node_verify_service{{"VerifyKit service"}}
node_whatsapp(("WhatsApp verification"))

node_user -->|"runs"| node_entry
node_entry -->|"no-argument mode"| node_interactive
node_entry -->|"dispatches"| node_commands
node_interactive -->|"selects lookup"| node_search
node_interactive -->|"selects batch"| node_batch
node_interactive -->|"selects quota"| node_quota
node_interactive -->|"selects captcha"| node_captcha
node_interactive -->|"selects generation"| node_generate
node_interactive -->|"selects account action"| node_credentials
node_commands -->|"dispatches"| node_search
node_commands -->|"dispatches"| node_batch
node_commands -->|"dispatches"| node_quota
node_commands -->|"dispatches"| node_captcha
node_commands -->|"dispatches"| node_generate
node_commands -->|"dispatches"| node_credentials
node_search -->|"requests lookup"| node_api
node_batch -->|"requests per row"| node_api
node_quota -->|"requests subscription"| node_api
node_captcha -->|"requests captcha"| node_api
node_api -->|"sends encrypted requests"| node_getcontact
node_search -->|"selects account"| node_credentials
node_batch -->|"selects account"| node_credentials
node_quota -->|"selects account"| node_credentials
node_captcha -->|"selects account"| node_credentials
node_credentials -->|"reads and writes"| node_credential_file
node_generate -->|"registers device"| node_api
node_generate -->|"starts verification"| node_verifykit
node_verifykit -->|"sends verification requests"| node_verify_service
node_whatsapp -->|"supplies verification"| node_verifykit
node_generate -->|"saves credentials"| node_credential_file
node_search -->|"formats response"| node_output
node_batch -->|"formats rows"| node_output
node_quota -->|"formats quota"| node_output
node_captcha -->|"displays challenge"| node_output
node_output -->|"prints results"| node_user
node_output -->|"saves output"| node_results

click node_entry "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_interactive "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_commands "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_search "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_batch "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_quota "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_captcha "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_api "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_credentials "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_credential_file "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_generate "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_verifykit "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_output "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py"
click node_results "https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.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_interactive,node_commands,node_user toneBlue
class node_credentials,node_generate,node_verifykit toneAmber
class node_search,node_batch,node_quota,node_captcha,node_api,node_getcontact toneMint
class node_credential_file,node_output,node_results toneRose
class node_verify_service,node_whatsapp toneIndigo
```

## Components

### CLI interface

- [CLI entry](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [Interactive menu](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [Command dispatch](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`

### Accounts and verification

- [Credential management](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [Account generation](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [VerifyKit verification](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`

### API operations

- [Profile and tag lookup](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [CSV batch lookup](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [Quota check](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [Captcha handling](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [API request and crypto](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`

### Local data

- [Credential store](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [Result formatting](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`
- [Saved results](https://github.com/xdreizein666/getcontact-cli/blob/main/gtc.py): `gtc.py`

### Other components

- **CLI user**
- **GetContact API**
- **VerifyKit service**
- **WhatsApp verification**

## Connections

- CLI user → CLI entry: runs
- CLI entry → Interactive menu: no-argument mode
- CLI entry → Command dispatch: dispatches
- Interactive menu → Profile and tag lookup: selects lookup
- Interactive menu → CSV batch lookup: selects batch
- Interactive menu → Quota check: selects quota
- Interactive menu → Captcha handling: selects captcha
- Interactive menu → Account generation: selects generation
- Interactive menu → Credential management: selects account action
- Command dispatch → Profile and tag lookup: dispatches
- Command dispatch → CSV batch lookup: dispatches
- Command dispatch → Quota check: dispatches
- Command dispatch → Captcha handling: dispatches
- Command dispatch → Account generation: dispatches
- Command dispatch → Credential management: dispatches
- Profile and tag lookup → API request and crypto: requests lookup
- CSV batch lookup → API request and crypto: requests per row
- Quota check → API request and crypto: requests subscription
- Captcha handling → API request and crypto: requests captcha
- API request and crypto → GetContact API: sends encrypted requests
- Profile and tag lookup → Credential management: selects account
- CSV batch lookup → Credential management: selects account
- Quota check → Credential management: selects account
- Captcha handling → Credential management: selects account
- Credential management → Credential store: reads and writes
- Account generation → API request and crypto: registers device
- Account generation → VerifyKit verification: starts verification
- VerifyKit verification → VerifyKit service: sends verification requests
- WhatsApp verification → VerifyKit verification: supplies verification
- Account generation → Credential store: saves credentials
- Profile and tag lookup → Result formatting: formats response
- CSV batch lookup → Result formatting: formats rows
- Quota check → Result formatting: formats quota
- Captcha handling → Result formatting: displays challenge
- Result formatting → CLI user: prints results
- Result formatting → Saved results: saves output