# megadose/holehe architecture

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

- Interactive diagram: https://gitdiagram.com/megadose/holehe
- Repository: https://github.com/megadose/holehe

## Overview

Holehe is an OSINT tool for checking whether an email is associated with accounts across 120+ services. The principal workflow accepts an email through the CLI, discovers and runs service-specific checks concurrently, and reports whether accounts exist, along with possible recovery details and rate-limit status. The checks span social, community, business, and consumer services; their implementations make HTTP requests directly to those services. The README also documents calling an individual check from Python. The excerpts show core orchestration and representative checks, but not every module’s implementation or the complete CLI flow.

Main entry points: [`holehe/core.py`](https://github.com/megadose/holehe/blob/master/holehe/core.py) (CLI and runner), [`holehe/localuseragent.py`](https://github.com/megadose/holehe/blob/master/holehe/localuseragent.py) (User-agent data), [`holehe/modules`](https://github.com/megadose/holehe/tree/master/holehe/modules) (Social and media checks), [`holehe/instruments.py`](https://github.com/megadose/holehe/blob/master/holehe/instruments.py) (Progress tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and orchestration"]
  node_core["CLI and runner<br/>[core.py]"]
  node_result["Check results<br/>[core.py]"]
end

subgraph group_runtime["Runtime support"]
  node_progress["Progress tracker<br/>[instruments.py]"]
  node_agents["User-agent data<br/>[localuseragent.py]"]
end

subgraph group_checks["Account checks"]
  node_social["Social and media checks"]
  node_community["Community and interest checks"]
  node_business["Business and work checks"]
  node_consumer["Consumer and service checks"]
end

subgraph group_outside["External systems"]
  node_service{{"Target services"}}
end

node_user(("CLI user"))

node_user -->|"provides email"| node_core
node_core -.->|"dispatches checks"| node_social
node_core -.->|"dispatches checks"| node_community
node_core -.->|"dispatches checks"| node_business
node_core -.->|"dispatches checks"| node_consumer
node_core -->|"registers tracker"| node_progress
node_progress -->|"tracks tasks"| node_core
node_social -->|"uses user agents"| node_agents
node_community -->|"uses user agents"| node_agents
node_business -->|"uses user agents"| node_agents
node_consumer -->|"uses user agents"| node_agents
node_social -.->|"queries accounts"| node_service
node_community -.->|"queries accounts"| node_service
node_business -.->|"queries accounts"| node_service
node_consumer -.->|"queries accounts"| node_service
node_core -->|"prints and exports"| node_result

click node_core "https://github.com/megadose/holehe/blob/master/holehe/core.py"
click node_result "https://github.com/megadose/holehe/blob/master/holehe/core.py"
click node_progress "https://github.com/megadose/holehe/blob/master/holehe/instruments.py"
click node_agents "https://github.com/megadose/holehe/blob/master/holehe/localuseragent.py"
click node_social "https://github.com/megadose/holehe/tree/master/holehe/modules"
click node_community "https://github.com/megadose/holehe/tree/master/holehe/modules"
click node_business "https://github.com/megadose/holehe/tree/master/holehe/modules"
click node_consumer "https://github.com/megadose/holehe/tree/master/holehe/modules"

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_core,node_result,node_user toneBlue
class node_progress,node_agents toneAmber
class node_social,node_community,node_business,node_consumer toneMint
class node_service toneRose
```

## Components

### Entry and orchestration

- [CLI and runner](https://github.com/megadose/holehe/blob/master/holehe/core.py): `holehe/core.py`
- [Check results](https://github.com/megadose/holehe/blob/master/holehe/core.py): `holehe/core.py`

### Runtime support

- [Progress tracker](https://github.com/megadose/holehe/blob/master/holehe/instruments.py): `holehe/instruments.py`
- [User-agent data](https://github.com/megadose/holehe/blob/master/holehe/localuseragent.py): `holehe/localuseragent.py`

### Account checks

- [Social and media checks](https://github.com/megadose/holehe/tree/master/holehe/modules): `holehe/modules`
- [Community and interest checks](https://github.com/megadose/holehe/tree/master/holehe/modules): `holehe/modules`
- [Business and work checks](https://github.com/megadose/holehe/tree/master/holehe/modules): `holehe/modules`
- [Consumer and service checks](https://github.com/megadose/holehe/tree/master/holehe/modules): `holehe/modules`

### External systems

- **Target services**

### Other components

- **CLI user**

## Connections

- CLI user → CLI and runner: provides email
- CLI and runner → Social and media checks: dispatches checks (evidence: `holehe/modules/shopping/garmin.py`)
- CLI and runner → Community and interest checks: dispatches checks (evidence: `holehe/modules/shopping/garmin.py`)
- CLI and runner → Business and work checks: dispatches checks (evidence: `holehe/modules/shopping/garmin.py`)
- CLI and runner → Consumer and service checks: dispatches checks (evidence: `holehe/modules/shopping/garmin.py`)
- CLI and runner → Progress tracker: registers tracker (evidence: `holehe/core.py`)
- Progress tracker → CLI and runner: tracks tasks (evidence: `holehe/instruments.py`)
- Social and media checks → User-agent data: uses user agents (evidence: `holehe/modules/social_media/tumblr.py`)
- Community and interest checks → User-agent data: uses user agents (evidence: `holehe/modules/forum/nattyornot.py`)
- Business and work checks → User-agent data: uses user agents (evidence: `holehe/modules/company/aboutme.py`)
- Consumer and service checks → User-agent data: uses user agents (evidence: `holehe/modules/shopping/garmin.py`)
- Social and media checks → Target services: queries accounts
- Community and interest checks → Target services: queries accounts
- Business and work checks → Target services: queries accounts
- Consumer and service checks → Target services: queries accounts
- CLI and runner → Check results: prints and exports (evidence: `holehe/core.py`)
