# traynertunder2047/nexus architecture

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

- Interactive diagram: https://gitdiagram.com/traynertunder2047/nexus
- Repository: https://github.com/traynertunder2047/nexus

## Overview

OSINTNexusBot is presented in the README as a multi-stage OSINT toolchain, but the supplied tree contains none of its documented Atlas, Doppelganger, or Locus mode directories. The visible runnable workflow prompts for a username, calls the GitHub profile checker, and prints its result. Identity, metadata, and network modules are present as supporting areas, though most sampled implementations are empty or minimal. The graph therefore preserves the actual tree and the documented capabilities only where a source path and relationship can be supported; unsampled mode internals are not inferred.

Main entry points: [`main.py`](https://github.com/traynertunder2047/nexus/blob/main/main.py) (Username scan), [`modules/github_check.py`](https://github.com/traynertunder2047/nexus/blob/main/modules/github_check.py) (GitHub profile check), [`modules/identity/social_finder.py`](https://github.com/traynertunder2047/nexus/blob/main/modules/identity/social_finder.py) (Social account search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI entry points"]
  node_main["Username scan<br/>[main.py]"]
  node_cli_entry["CLI entry<br/>[main_cli.py]"]
  node_telegram_entry["Telegram entry<br/>[main_telegram.py]"]
end

subgraph group_identity["Identity reconnaissance"]
  node_github_check["GitHub profile check<br/>[github_check.py]"]
  node_social_finder["Social account search<br/>[social_finder.py]"]
  node_email_predictor["Email prediction<br/>[email_predictor.py]"]
  node_breach_checker["Breach checks<br/>[breach_checker.py]"]
  node_phone_lookup["Phone lookup<br/>[phone_lookup.py]"]
  node_social_linker["Social correlation<br/>[social_linker.py]"]
end

subgraph group_metadata["File metadata"]
  node_doc_reader["Document reader<br/>[doc_reader.py]"]
  node_exif_extractor["EXIF extraction<br/>[exif_extractor.py]"]
end

subgraph group_network["Network reconnaissance"]
  node_dns_enumerator["DNS enumeration<br/>[dns_enumerator.py]"]
  node_geolocator["IP geolocation<br/>[geolocator.py]"]
  node_port_scanner["Port scanning<br/>[port_scanner.py]"]
  node_whois_lookup["WHOIS lookup<br/>[whois_lookup.py]"]
end

node_operator(("Analyst"))
node_github_api{{"GitHub API"}}
node_social_sites{{"Public social sites"}}

node_operator -->|"enters username"| node_main
node_main -->|"calls checker"| node_github_check
node_github_check -->|"requests profile"| node_github_api
node_social_finder -->|"checks profiles"| node_social_sites

click node_main "https://github.com/traynertunder2047/nexus/blob/main/main.py"
click node_cli_entry "https://github.com/traynertunder2047/nexus/blob/main/main_cli.py"
click node_telegram_entry "https://github.com/traynertunder2047/nexus/blob/main/main_telegram.py"
click node_github_check "https://github.com/traynertunder2047/nexus/blob/main/modules/github_check.py"
click node_social_finder "https://github.com/traynertunder2047/nexus/blob/main/modules/identity/social_finder.py"
click node_email_predictor "https://github.com/traynertunder2047/nexus/blob/main/modules/identity/email_predictor.py"
click node_breach_checker "https://github.com/traynertunder2047/nexus/blob/main/modules/identity/breach_checker.py"
click node_phone_lookup "https://github.com/traynertunder2047/nexus/blob/main/modules/identity/phone_lookup.py"
click node_social_linker "https://github.com/traynertunder2047/nexus/blob/main/modules/identity/social_linker.py"
click node_doc_reader "https://github.com/traynertunder2047/nexus/blob/main/modules/metadata/doc_reader.py"
click node_exif_extractor "https://github.com/traynertunder2047/nexus/blob/main/modules/metadata/exif_extractor.py"
click node_dns_enumerator "https://github.com/traynertunder2047/nexus/blob/main/modules/network/dns_enumerator.py"
click node_geolocator "https://github.com/traynertunder2047/nexus/blob/main/modules/network/geolocator.py"
click node_port_scanner "https://github.com/traynertunder2047/nexus/blob/main/modules/network/port_scanner.py"
click node_whois_lookup "https://github.com/traynertunder2047/nexus/blob/main/modules/network/whois_lookup.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_main,node_cli_entry,node_telegram_entry toneBlue
class node_github_check,node_social_finder,node_email_predictor,node_breach_checker,node_phone_lookup,node_social_linker toneAmber
class node_doc_reader,node_exif_extractor,node_github_api toneMint
class node_dns_enumerator,node_geolocator,node_port_scanner,node_whois_lookup toneRose
class node_operator,node_social_sites toneIndigo
```

## Components

### CLI entry points

- [Username scan](https://github.com/traynertunder2047/nexus/blob/main/main.py): `main.py`
- [CLI entry](https://github.com/traynertunder2047/nexus/blob/main/main_cli.py): `main_cli.py`
- [Telegram entry](https://github.com/traynertunder2047/nexus/blob/main/main_telegram.py): `main_telegram.py`

### Identity reconnaissance

- [GitHub profile check](https://github.com/traynertunder2047/nexus/blob/main/modules/github_check.py): `modules/github_check.py`
- [Social account search](https://github.com/traynertunder2047/nexus/blob/main/modules/identity/social_finder.py): `modules/identity/social_finder.py`
- [Email prediction](https://github.com/traynertunder2047/nexus/blob/main/modules/identity/email_predictor.py): `modules/identity/email_predictor.py`
- [Breach checks](https://github.com/traynertunder2047/nexus/blob/main/modules/identity/breach_checker.py): `modules/identity/breach_checker.py`
- [Phone lookup](https://github.com/traynertunder2047/nexus/blob/main/modules/identity/phone_lookup.py): `modules/identity/phone_lookup.py`
- [Social correlation](https://github.com/traynertunder2047/nexus/blob/main/modules/identity/social_linker.py): `modules/identity/social_linker.py`

### File metadata

- [Document reader](https://github.com/traynertunder2047/nexus/blob/main/modules/metadata/doc_reader.py): `modules/metadata/doc_reader.py`
- [EXIF extraction](https://github.com/traynertunder2047/nexus/blob/main/modules/metadata/exif_extractor.py): `modules/metadata/exif_extractor.py`

### Network reconnaissance

- [DNS enumeration](https://github.com/traynertunder2047/nexus/blob/main/modules/network/dns_enumerator.py): `modules/network/dns_enumerator.py`
- [IP geolocation](https://github.com/traynertunder2047/nexus/blob/main/modules/network/geolocator.py): `modules/network/geolocator.py`
- [Port scanning](https://github.com/traynertunder2047/nexus/blob/main/modules/network/port_scanner.py): `modules/network/port_scanner.py`
- [WHOIS lookup](https://github.com/traynertunder2047/nexus/blob/main/modules/network/whois_lookup.py): `modules/network/whois_lookup.py`

### Other components

- **Analyst**
- **GitHub API**
- **Public social sites**

## Connections

- Analyst → Username scan: enters username (evidence: `main.py`)
- Username scan → GitHub profile check: calls checker (evidence: `main.py`)
- GitHub profile check → GitHub API: requests profile (evidence: `modules/github_check.py`)
- Social account search → Public social sites: checks profiles (evidence: `modules/identity/social_finder.py`)
