# termuxhackers-id/sigit architecture

> Architecture diagram of the GitHub repository termuxhackers-id/sigit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/termuxhackers-id/sigit
- Repository: https://github.com/termuxhackers-id/sigit

## Overview

SIGIT is a modular OSINT toolkit: users launch a service through either the scriptable CLI or interactive menu, provide schema-validated inputs, and receive rendered and optionally exported results. The service catalog spans domain, email, network, reconnaissance, security, and social-profile investigations. Shared internals provide service discovery, result contracts, and asynchronous HTTP transport. Service implementations were not all excerpted, so category-level capabilities follow the README; edges are limited to relationships shown in excerpts or explicitly documented.

Main entry points: [`sigit/__main__.py`](https://github.com/termuxhackers-id/sigit/blob/main/sigit/__main__.py) (Application Entry), [`sigit/cli/menu.py`](https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/menu.py) (Interactive Menu), [`sigit/services/email`](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/email) (Email Services), [`sigit/services/social`](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/social) (Social Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI Experience"]
  node_entrypoint["Application Entry<br/>[__main__.py]"]
  node_parser["CLI Parser<br/>[parser.py]"]
  node_menu["Interactive Menu<br/>[menu.py]"]
  node_prompt["Schema Prompts<br/>[prompt.py]"]
  node_display["Result Display<br/>[display.py]"]
end

subgraph group_runtime["Service Runtime"]
  node_registry["Service Registry<br/>[registry.py]"]
  node_contract["Service Contract<br/>[base.py]"]
  node_settings["Runtime Settings<br/>[config.py]"]
  node_http["Async HTTP Client<br/>[http.py]"]
end

subgraph group_domain["Domain and Email"]
  node_domain_services["Domain Services"]
  node_email_services["Email Services"]
  node_email_platforms["Email Platform Rules<br/>[platforms.py]"]
  node_email_models["Email Rule Models<br/>[models.py]"]
  node_email_custom["Email Checkers<br/>[custom_checkers.py]"]
end

subgraph group_network["Network and Recon"]
  node_network_services["Network Services"]
  node_recon_services["Recon Services"]
end

subgraph group_security["Security Checks"]
  node_security_services["Security Services"]
end

subgraph group_social["Identity and Social"]
  node_social_services["Social Services"]
  node_user_platforms["Username Platform Rules<br/>[platforms.py]"]
  node_user_models["Username Rule Models<br/>[models.py]"]
  node_user_custom["Username Checkers<br/>[custom_checkers.py]"]
end

node_user(("Terminal User"))
node_external_services(("External Web Services"))

node_user -->|"runs"| node_entrypoint
node_entrypoint -->|"builds arguments"| node_parser
node_entrypoint -->|"starts menu"| node_menu
node_entrypoint -->|"loads services"| node_registry
node_parser -->|"lists services"| node_registry
node_menu -->|"lists services"| node_registry
node_menu -->|"collects inputs"| node_prompt
node_entrypoint -->|"executes selected service"| node_domain_services
node_entrypoint -->|"executes selected service"| node_email_services
node_entrypoint -->|"executes selected service"| node_network_services
node_entrypoint -->|"executes selected service"| node_recon_services
node_entrypoint -->|"executes selected service"| node_security_services
node_entrypoint -->|"executes selected service"| node_social_services
node_menu -->|"executes selected service"| node_domain_services
node_menu -->|"executes selected service"| node_email_services
node_menu -->|"executes selected service"| node_network_services
node_menu -->|"executes selected service"| node_recon_services
node_menu -->|"executes selected service"| node_security_services
node_menu -->|"executes selected service"| node_social_services
node_entrypoint -->|"renders results"| node_display
node_menu -->|"renders results"| node_display
node_email_services -->|"checks rules"| node_email_platforms
node_email_services -->|"uses rule schema"| node_email_models
node_email_platforms -->|"uses custom checks"| node_email_custom
node_social_services -->|"checks rules"| node_user_platforms
node_social_services -->|"uses rule schema"| node_user_models
node_user_platforms -->|"uses custom checks"| node_user_custom
node_domain_services -.->|"sends requests"| node_http
node_email_services -->|"sends requests"| node_http
node_network_services -.->|"sends requests"| node_http
node_recon_services -->|"sends requests"| node_http
node_security_services -.->|"sends requests"| node_http
node_social_services -->|"sends requests"| node_http
node_http -->|"reads settings"| node_settings
node_domain_services -.->|"returns results"| node_contract
node_email_services -->|"returns results"| node_contract
node_network_services -.->|"returns results"| node_contract
node_recon_services -->|"returns results"| node_contract
node_security_services -.->|"returns results"| node_contract
node_social_services -->|"returns results"| node_contract
node_domain_services -.->|"queries targets"| node_external_services
node_email_services -->|"probes platforms"| node_external_services
node_network_services -.->|"queries targets"| node_external_services
node_recon_services -->|"inspects websites"| node_external_services
node_security_services -.->|"checks exposures"| node_external_services
node_social_services -->|"probes platforms"| node_external_services

click node_entrypoint "https://github.com/termuxhackers-id/sigit/blob/main/sigit/__main__.py"
click node_parser "https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/parser.py"
click node_menu "https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/menu.py"
click node_prompt "https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/prompt.py"
click node_display "https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/display.py"
click node_registry "https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/registry.py"
click node_contract "https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/base.py"
click node_settings "https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/config.py"
click node_http "https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/http.py"
click node_domain_services "https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/domain"
click node_email_services "https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/email"
click node_network_services "https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/network"
click node_recon_services "https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/recon"
click node_security_services "https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/security"
click node_social_services "https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/social"
click node_email_platforms "https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/email/email_recon/platforms.py"
click node_email_models "https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/email/email_recon/models.py"
click node_email_custom "https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/email/email_recon/custom_checkers.py"
click node_user_platforms "https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/social/user_recon/platforms.py"
click node_user_models "https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/social/user_recon/models.py"
click node_user_custom "https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/social/user_recon/custom_checkers.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_entrypoint,node_parser,node_menu,node_prompt,node_display,node_user toneBlue
class node_registry,node_contract,node_settings,node_http toneAmber
class node_domain_services,node_email_services,node_email_platforms,node_email_models,node_email_custom toneMint
class node_network_services,node_recon_services toneRose
class node_security_services,node_external_services toneIndigo
class node_social_services,node_user_platforms,node_user_models,node_user_custom toneTeal
```

## Components

### CLI Experience

- [Application Entry](https://github.com/termuxhackers-id/sigit/blob/main/sigit/__main__.py): `sigit/__main__.py`
- [CLI Parser](https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/parser.py): `sigit/cli/parser.py`
- [Interactive Menu](https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/menu.py): `sigit/cli/menu.py`
- [Schema Prompts](https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/prompt.py): `sigit/cli/prompt.py`
- [Result Display](https://github.com/termuxhackers-id/sigit/blob/main/sigit/cli/display.py): `sigit/cli/display.py`

### Service Runtime

- [Service Registry](https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/registry.py): `sigit/core/registry.py`
- [Service Contract](https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/base.py): `sigit/core/base.py`
- [Runtime Settings](https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/config.py): `sigit/core/config.py`
- [Async HTTP Client](https://github.com/termuxhackers-id/sigit/blob/main/sigit/core/http.py): `sigit/core/http.py`

### Domain and Email

- [Domain Services](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/domain): `sigit/services/domain`
- [Email Services](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/email): `sigit/services/email`
- [Email Platform Rules](https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/email/email_recon/platforms.py): `sigit/services/email/email_recon/platforms.py`
- [Email Rule Models](https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/email/email_recon/models.py): `sigit/services/email/email_recon/models.py`
- [Email Checkers](https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/email/email_recon/custom_checkers.py): `sigit/services/email/email_recon/custom_checkers.py`

### Network and Recon

- [Network Services](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/network): `sigit/services/network`
- [Recon Services](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/recon): `sigit/services/recon`

### Security Checks

- [Security Services](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/security): `sigit/services/security`

### Identity and Social

- [Social Services](https://github.com/termuxhackers-id/sigit/tree/main/sigit/services/social): `sigit/services/social`
- [Username Platform Rules](https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/social/user_recon/platforms.py): `sigit/services/social/user_recon/platforms.py`
- [Username Rule Models](https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/social/user_recon/models.py): `sigit/services/social/user_recon/models.py`
- [Username Checkers](https://github.com/termuxhackers-id/sigit/blob/main/sigit/services/social/user_recon/custom_checkers.py): `sigit/services/social/user_recon/custom_checkers.py`

### Other components

- **Terminal User**
- **External Web Services**

## Connections

- Terminal User → Application Entry: runs (evidence: `README.md`)
- Application Entry → CLI Parser: builds arguments (evidence: `sigit/__main__.py`)
- Application Entry → Interactive Menu: starts menu (evidence: `sigit/__main__.py`)
- Application Entry → Service Registry: loads services
- CLI Parser → Service Registry: lists services (evidence: `sigit/cli/parser.py`)
- Interactive Menu → Service Registry: lists services (evidence: `sigit/cli/menu.py`)
- Interactive Menu → Schema Prompts: collects inputs (evidence: `sigit/cli/menu.py`)
- Application Entry → Domain Services: executes selected service (evidence: `sigit/__main__.py`)
- Application Entry → Email Services: executes selected service (evidence: `sigit/__main__.py`)
- Application Entry → Network Services: executes selected service (evidence: `sigit/__main__.py`)
- Application Entry → Recon Services: executes selected service (evidence: `sigit/__main__.py`)
- Application Entry → Security Services: executes selected service (evidence: `sigit/__main__.py`)
- Application Entry → Social Services: executes selected service (evidence: `sigit/__main__.py`)
- Interactive Menu → Domain Services: executes selected service (evidence: `sigit/cli/menu.py`)
- Interactive Menu → Email Services: executes selected service (evidence: `sigit/cli/menu.py`)
- Interactive Menu → Network Services: executes selected service (evidence: `sigit/cli/menu.py`)
- Interactive Menu → Recon Services: executes selected service (evidence: `sigit/cli/menu.py`)
- Interactive Menu → Security Services: executes selected service (evidence: `sigit/cli/menu.py`)
- Interactive Menu → Social Services: executes selected service (evidence: `sigit/cli/menu.py`)
- Application Entry → Result Display: renders results (evidence: `sigit/__main__.py`)
- Interactive Menu → Result Display: renders results (evidence: `sigit/cli/menu.py`)
- Email Services → Email Platform Rules: checks rules (evidence: `sigit/services/email/email_recon/service.py`)
- Email Services → Email Rule Models: uses rule schema (evidence: `sigit/services/email/email_recon/service.py`)
- Email Platform Rules → Email Checkers: uses custom checks (evidence: `sigit/services/email/email_recon/platforms.py`)
- Social Services → Username Platform Rules: checks rules (evidence: `sigit/services/social/user_recon/service.py`)
- Social Services → Username Rule Models: uses rule schema (evidence: `sigit/services/social/user_recon/service.py`)
- Username Platform Rules → Username Checkers: uses custom checks (evidence: `sigit/services/social/user_recon/platforms.py`)
- Domain Services → Async HTTP Client: sends requests (evidence: `sigit/services/domain/subdomain_scanner/service.py`)
- Email Services → Async HTTP Client: sends requests (evidence: `sigit/services/email/email_recon/service.py`)
- Network Services → Async HTTP Client: sends requests (evidence: `sigit/services/network/ip_location/service.py`)
- Recon Services → Async HTTP Client: sends requests (evidence: `sigit/services/recon/tech_detector/service.py`)
- Security Services → Async HTTP Client: sends requests (evidence: `sigit/services/security/header_analyzer/service.py`)
- Social Services → Async HTTP Client: sends requests (evidence: `sigit/services/social/user_recon/service.py`)
- Async HTTP Client → Runtime Settings: reads settings (evidence: `sigit/core/http.py`)
- Domain Services → Service Contract: returns results (evidence: `sigit/services/domain/subdomain_scanner/service.py`)
- Email Services → Service Contract: returns results (evidence: `sigit/services/email/email_recon/service.py`)
- Network Services → Service Contract: returns results (evidence: `sigit/services/network/port_scanner/service.py`)
- Recon Services → Service Contract: returns results (evidence: `sigit/services/recon/tech_detector/service.py`)
- Security Services → Service Contract: returns results (evidence: `sigit/services/security/ssl_checker/service.py`)
- Social Services → Service Contract: returns results (evidence: `sigit/services/social/user_recon/service.py`)
- Domain Services → External Web Services: queries targets
- Email Services → External Web Services: probes platforms (evidence: `sigit/services/email/email_recon/service.py`)
- Network Services → External Web Services: queries targets
- Recon Services → External Web Services: inspects websites (evidence: `sigit/services/recon/tech_detector/service.py`)
- Security Services → External Web Services: checks exposures
- Social Services → External Web Services: probes platforms (evidence: `sigit/services/social/user_recon/service.py`)
