# spyboy-productions/unve1ler architecture

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

- Interactive diagram: https://gitdiagram.com/spyboy-productions/unve1ler
- Repository: https://github.com/spyboy-productions/unve1ler

## Overview

unve1ler is a command-line OSINT tool for username-based profile discovery, email investigation, and reverse-image lookup. Its principal flow starts with a target username, checks candidate platform URLs concurrently, and prints a results summary; optional email and image inputs invoke separate investigations. The graph reflects README-described capabilities where implementation calls were not visible in the excerpts; those links are marked unverified rather than inferred as confirmed calls.

Main entry points: [`unve1ler.py`](https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py) (CLI workflow), [`email_osint.py`](https://github.com/spyboy-productions/unve1ler/blob/main/email_osint.py) (Email investigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_entry["CLI workflow<br/>[unve1ler.py]"]
end

subgraph group_profiles["Profile discovery"]
  node_profile_search["Profile search<br/>[unve1ler.py]"]
  node_platform_checks["Platform checks<br/>[unve1ler.py]"]
  node_profile_services{{"Social platforms"}}
  node_summary["Results summary<br/>[unve1ler.py]"]
end

subgraph group_email["Email OSINT"]
  node_email_input["Email validation<br/>[unve1ler.py]"]
  node_email_osint["Email investigation<br/>[email_osint.py]"]
  node_google{{"Google search"}}
  node_dns{{"DNS MX lookup"}}
end

subgraph group_image["Image search"]
  node_image_input["Image URL check<br/>[unve1ler.py]"]
  node_reverse_api{{"Reverse lookup API"}}
  node_image_engines{{"Image search engines"}}
  node_shortener{{"TinyURL service"}}
end

node_user(("Operator"))

node_user -->|"provides target"| node_entry
node_entry -.->|"starts search"| node_profile_search
node_profile_search -->|"checks concurrently"| node_platform_checks
node_platform_checks -->|"requests profiles"| node_profile_services
node_profile_search -->|"prints results"| node_summary
node_entry -.->|"accepts email"| node_email_input
node_email_input -->|"runs investigation"| node_email_osint
node_email_input -->|"looks up MX"| node_dns
node_email_osint -->|"searches dorks"| node_google
node_entry -.->|"accepts image URL"| node_image_input
node_image_input -->|"requests reverse lookup"| node_reverse_api
node_image_input -->|"shortens search URLs"| node_shortener
node_image_input -->|"prints search links"| node_image_engines

click node_entry "https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py"
click node_profile_search "https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py"
click node_platform_checks "https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py"
click node_summary "https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py"
click node_email_input "https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py"
click node_email_osint "https://github.com/spyboy-productions/unve1ler/blob/main/email_osint.py"
click node_image_input "https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.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 toneBlue
class node_profile_search,node_platform_checks,node_profile_services,node_summary toneAmber
class node_email_input,node_email_osint,node_google,node_dns toneMint
class node_image_input,node_reverse_api,node_image_engines,node_shortener toneRose
class node_user toneIndigo
```

## Components

### CLI workflow

- [CLI workflow](https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py): `unve1ler.py`

### Profile discovery

- [Profile search](https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py): `unve1ler.py`
- [Platform checks](https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py): `unve1ler.py`
- **Social platforms**
- [Results summary](https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py): `unve1ler.py`

### Email OSINT

- [Email validation](https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py): `unve1ler.py`
- [Email investigation](https://github.com/spyboy-productions/unve1ler/blob/main/email_osint.py): `email_osint.py`
- **Google search**
- **DNS MX lookup**

### Image search

- [Image URL check](https://github.com/spyboy-productions/unve1ler/blob/main/unve1ler.py): `unve1ler.py`
- **Reverse lookup API**
- **Image search engines**
- **TinyURL service**

### Other components

- **Operator**

## Connections

- Operator → CLI workflow: provides target (evidence: `README.md`)
- CLI workflow → Profile search: starts search (evidence: `unve1ler.py`)
- Profile search → Platform checks: checks concurrently (evidence: `unve1ler.py`)
- Platform checks → Social platforms: requests profiles (evidence: `unve1ler.py`)
- Profile search → Results summary: prints results (evidence: `unve1ler.py`)
- CLI workflow → Email validation: accepts email (evidence: `unve1ler.py`)
- Email validation → Email investigation: runs investigation (evidence: `unve1ler.py`)
- Email validation → DNS MX lookup: looks up MX (evidence: `unve1ler.py`)
- Email investigation → Google search: searches dorks (evidence: `email_osint.py`)
- CLI workflow → Image URL check: accepts image URL (evidence: `unve1ler.py`)
- Image URL check → Reverse lookup API: requests reverse lookup (evidence: `unve1ler.py`)
- Image URL check → TinyURL service: shortens search URLs (evidence: `unve1ler.py`)
- Image URL check → Image search engines: prints search links (evidence: `unve1ler.py`)