# kalyel473/eyes-of-god architecture

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

- Interactive diagram: https://gitdiagram.com/kalyel473/eyes-of-god
- Repository: https://github.com/kalyel473/eyes-of-god

## Overview

Olho de Deus is a Python CLI for OSINT collection, security analysis, and monitoring. Users invoke commands or the interactive menu; the CLI dispatches investigations and presents or saves results. The README describes broader domain, email, IP, URL, identity, network, cryptography, and system capabilities, all implemented in the single listed source file. Sampled code confirms shared HTTP access, caching, monitoring snapshots, and several external lookups; unsampled feature wiring is not inferred.

Main entry points: [`main.py`](https://github.com/kalyel473/eyes-of-god/blob/main/main.py) (CLI and menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry"]
  node_cli["CLI and menu<br/>[main.py]"]
end

subgraph group_osint["OSINT investigations"]
  node_domain["Domain OSINT<br/>[main.py]"]
  node_email["Email OSINT<br/>[main.py]"]
  node_ip["IP OSINT<br/>[main.py]"]
  node_url["URL analysis<br/>[main.py]"]
  node_identity["Identity search<br/>[main.py]"]
  node_image["Image analysis<br/>[main.py]"]
  node_darkweb["Dark web search<br/>[main.py]"]
end

subgraph group_security["Security analysis"]
  node_nexus["NEXUS correlation<br/>[main.py]"]
  node_threat["Threat intelligence<br/>[main.py]"]
  node_scanners["Network scanners<br/>[main.py]"]
  node_websecurity["Web security checks<br/>[main.py]"]
  node_validators["Data validators<br/>[main.py]"]
  node_monitor["Change monitoring<br/>[main.py]"]
  node_utilities["System and crypto<br/>[main.py]"]
end

subgraph group_shared["Shared services"]
  node_http["HTTP client<br/>[main.py]"]
  node_cache["Result cache<br/>[main.py]"]
  node_reports["Output and reports<br/>[main.py]"]
end

node_user(("Investigator"))
node_public_services["Public lookup services"]
node_optional_services["Keyed lookup services"]

node_user -->|"invokes"| node_cli
node_cli -->|"dispatches"| node_domain
node_cli -->|"dispatches"| node_email
node_cli -->|"dispatches"| node_ip
node_cli -->|"dispatches"| node_url
node_cli -->|"dispatches"| node_identity
node_cli -->|"dispatches"| node_nexus
node_cli -->|"dispatches"| node_threat
node_cli -->|"dispatches"| node_scanners
node_cli -->|"dispatches"| node_websecurity
node_cli -->|"dispatches"| node_validators
node_cli -->|"dispatches"| node_monitor
node_cli -->|"dispatches"| node_utilities
node_monitor -->|"snapshots"| node_domain
node_monitor -->|"snapshots"| node_email
node_monitor -->|"snapshots"| node_ip
node_domain -->|"uses"| node_http
node_email -->|"uses"| node_http
node_ip -->|"uses"| node_http
node_url -->|"uses"| node_http
node_identity -->|"uses"| node_http
node_email -->|"caches"| node_cache
node_ip -->|"caches"| node_cache
node_cli -->|"saves results"| node_reports
node_http -->|"queries"| node_public_services
node_email -.->|"queries"| node_optional_services
node_ip -->|"queries"| node_public_services

click node_cli "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_domain "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_email "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_ip "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_url "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_identity "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_image "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_darkweb "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_nexus "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_threat "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_scanners "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_websecurity "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_validators "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_monitor "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_utilities "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_http "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_cache "https://github.com/kalyel473/eyes-of-god/blob/main/main.py"
click node_reports "https://github.com/kalyel473/eyes-of-god/blob/main/main.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_cli toneBlue
class node_domain,node_email,node_ip,node_url,node_identity,node_image,node_darkweb toneAmber
class node_nexus,node_threat,node_scanners,node_websecurity,node_validators,node_monitor,node_utilities toneMint
class node_http,node_cache,node_reports toneRose
class node_user,node_public_services,node_optional_services toneIndigo
```

## Components

### CLI entry

- [CLI and menu](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`

### OSINT investigations

- [Domain OSINT](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Email OSINT](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [IP OSINT](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [URL analysis](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Identity search](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Image analysis](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Dark web search](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`

### Security analysis

- [NEXUS correlation](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Threat intelligence](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Network scanners](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Web security checks](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Data validators](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Change monitoring](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [System and crypto](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`

### Shared services

- [HTTP client](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Result cache](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`
- [Output and reports](https://github.com/kalyel473/eyes-of-god/blob/main/main.py): `main.py`

### Other components

- **Investigator**
- **Public lookup services**
- **Keyed lookup services**

## Connections

- Investigator → CLI and menu: invokes
- CLI and menu → Domain OSINT: dispatches
- CLI and menu → Email OSINT: dispatches
- CLI and menu → IP OSINT: dispatches
- CLI and menu → URL analysis: dispatches
- CLI and menu → Identity search: dispatches
- CLI and menu → NEXUS correlation: dispatches
- CLI and menu → Threat intelligence: dispatches
- CLI and menu → Network scanners: dispatches
- CLI and menu → Web security checks: dispatches
- CLI and menu → Data validators: dispatches
- CLI and menu → Change monitoring: dispatches
- CLI and menu → System and crypto: dispatches
- Change monitoring → Domain OSINT: snapshots
- Change monitoring → Email OSINT: snapshots
- Change monitoring → IP OSINT: snapshots
- Domain OSINT → HTTP client: uses
- Email OSINT → HTTP client: uses
- IP OSINT → HTTP client: uses
- URL analysis → HTTP client: uses
- Identity search → HTTP client: uses
- Email OSINT → Result cache: caches
- IP OSINT → Result cache: caches
- CLI and menu → Output and reports: saves results
- HTTP client → Public lookup services: queries
- Email OSINT → Keyed lookup services: queries
- IP OSINT → Public lookup services: queries