# ibnaleem/gosearch architecture

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

- Interactive diagram: https://gitdiagram.com/ibnaleem/gosearch
- Repository: https://github.com/ibnaleem/gosearch

## Overview

GoSearch is a command-line OSINT tool that checks a username across websites, identity services, GitHub, and breach-data sources, then displays and saves findings. The principal workflow begins in the CLI, loads the website catalog, performs concurrent profile checks, and then runs enrichment and credential searches. The graph preserves README-described capabilities, including optional BreachDirectory lookup and hash cracking. Some GitHub and search implementations are represented at their exact directory or file paths because their source was not fully sampled; edges are limited to shown calls or documented behavior.

Main entry points: [`main.go`](https://github.com/ibnaleem/gosearch/blob/main/main.go) (Command-line runner), [`internal/utils/utils.go`](https://github.com/ibnaleem/gosearch/blob/main/internal/utils/utils.go) (Findings files), [`internal/search/search.go`](https://github.com/ibnaleem/gosearch/blob/main/internal/search/search.go) (Website checks), [`internal/modules/hudsonrock/hudsonrock.go`](https://github.com/ibnaleem/gosearch/blob/main/internal/modules/hudsonrock/hudsonrock.go) (HudsonRock breach search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI workflow"]
  node_cli["Command-line runner<br/>[main.go]"]
  node_catalog["Website catalog loader<br/>[utils.go]"]
end

subgraph group_profiles["Profile discovery"]
  node_sitecheck["Website checks<br/>[search.go]"]
  node_domaincheck["Domain checks<br/>[search.go]"]
  node_website_service(("Website services"))
end

subgraph group_identity["Identity enrichment"]
  node_github["GitHub investigations"]
  node_gravatar["Gravatar lookup<br/>[gravatar.go]"]
  node_keybase["Keybase lookup<br/>[keybase.go]"]
end

subgraph group_breaches["Credential exposure"]
  node_hudson["HudsonRock breach search<br/>[hudsonrock.go]"]
  node_proxynova["ProxyNova breach search<br/>[proxynova.go]"]
  node_breachdirectory["BreachDirectory search<br/>[breachdirectory.go]"]
  node_weakpass["Hash cracking<br/>[weakpass.go]"]
end

subgraph group_support["Shared runtime"]
  node_output["Findings files<br/>[utils.go]"]
  node_config["Runtime configuration<br/>[config.go]"]
  node_models["Search data models<br/>[models.go]"]
  node_theme["Terminal presentation<br/>[theme.go]"]
end

node_user(("Username seeker"))
node_breach_services(("Breach data services"))
node_weakpass_service(("Weakpass service"))

node_user -->|"provides username"| node_cli
node_cli -->|"loads catalog"| node_catalog
node_catalog -->|"downloads catalog"| node_website_service
node_cli -->|"starts checks"| node_sitecheck
node_cli -->|"starts domain checks"| node_domaincheck
node_sitecheck -.->|"checks profiles"| node_website_service
node_cli -->|"runs enrichment"| node_github
node_cli -->|"searches breaches"| node_hudson
node_cli -->|"searches breaches"| node_proxynova
node_cli -->|"optional lookup"| node_breachdirectory
node_breachdirectory -->|"cracks hashes"| node_weakpass
node_hudson -->|"queries service"| node_breach_services
node_proxynova -->|"queries service"| node_breach_services
node_weakpass -.->|"checks hashes"| node_weakpass_service
node_cli -.->|"looks up profile"| node_gravatar
node_cli -.->|"looks up profile"| node_keybase
node_sitecheck -->|"writes findings"| node_output
node_hudson -->|"writes findings"| node_output
node_proxynova -->|"writes findings"| node_output
node_breachdirectory -->|"writes findings"| node_output
node_cli -->|"uses search data"| node_models
node_sitecheck -->|"reads website records"| node_models
node_github -.->|"saves findings"| node_output

click node_cli "https://github.com/ibnaleem/gosearch/blob/main/main.go"
click node_catalog "https://github.com/ibnaleem/gosearch/blob/main/internal/utils/utils.go"
click node_sitecheck "https://github.com/ibnaleem/gosearch/blob/main/internal/search/search.go"
click node_domaincheck "https://github.com/ibnaleem/gosearch/blob/main/internal/search/search.go"
click node_github "https://github.com/ibnaleem/gosearch/tree/main/internal/modules/github"
click node_gravatar "https://github.com/ibnaleem/gosearch/blob/main/internal/modules/gravatar/gravatar.go"
click node_keybase "https://github.com/ibnaleem/gosearch/blob/main/internal/modules/keybase/keybase.go"
click node_hudson "https://github.com/ibnaleem/gosearch/blob/main/internal/modules/hudsonrock/hudsonrock.go"
click node_proxynova "https://github.com/ibnaleem/gosearch/blob/main/internal/modules/proxynova/proxynova.go"
click node_breachdirectory "https://github.com/ibnaleem/gosearch/blob/main/internal/modules/breachdirectory/breachdirectory.go"
click node_weakpass "https://github.com/ibnaleem/gosearch/blob/main/internal/modules/weakpass/weakpass.go"
click node_output "https://github.com/ibnaleem/gosearch/blob/main/internal/utils/utils.go"
click node_config "https://github.com/ibnaleem/gosearch/blob/main/internal/config/config.go"
click node_models "https://github.com/ibnaleem/gosearch/blob/main/internal/models/models.go"
click node_theme "https://github.com/ibnaleem/gosearch/blob/main/internal/theme/theme.go"

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,node_catalog,node_user toneBlue
class node_sitecheck,node_domaincheck,node_website_service toneAmber
class node_github,node_gravatar,node_keybase toneMint
class node_hudson,node_proxynova,node_breachdirectory,node_weakpass toneRose
class node_output,node_config,node_models,node_theme,node_breach_services,node_weakpass_service toneIndigo
```

## Components

### CLI workflow

- [Command-line runner](https://github.com/ibnaleem/gosearch/blob/main/main.go): `main.go`
- [Website catalog loader](https://github.com/ibnaleem/gosearch/blob/main/internal/utils/utils.go): `internal/utils/utils.go`

### Profile discovery

- [Website checks](https://github.com/ibnaleem/gosearch/blob/main/internal/search/search.go): `internal/search/search.go`
- [Domain checks](https://github.com/ibnaleem/gosearch/blob/main/internal/search/search.go): `internal/search/search.go`
- **Website services**

### Identity enrichment

- [GitHub investigations](https://github.com/ibnaleem/gosearch/tree/main/internal/modules/github): `internal/modules/github`
- [Gravatar lookup](https://github.com/ibnaleem/gosearch/blob/main/internal/modules/gravatar/gravatar.go): `internal/modules/gravatar/gravatar.go`
- [Keybase lookup](https://github.com/ibnaleem/gosearch/blob/main/internal/modules/keybase/keybase.go): `internal/modules/keybase/keybase.go`

### Credential exposure

- [HudsonRock breach search](https://github.com/ibnaleem/gosearch/blob/main/internal/modules/hudsonrock/hudsonrock.go): `internal/modules/hudsonrock/hudsonrock.go`
- [ProxyNova breach search](https://github.com/ibnaleem/gosearch/blob/main/internal/modules/proxynova/proxynova.go): `internal/modules/proxynova/proxynova.go`
- [BreachDirectory search](https://github.com/ibnaleem/gosearch/blob/main/internal/modules/breachdirectory/breachdirectory.go): `internal/modules/breachdirectory/breachdirectory.go`
- [Hash cracking](https://github.com/ibnaleem/gosearch/blob/main/internal/modules/weakpass/weakpass.go): `internal/modules/weakpass/weakpass.go`

### Shared runtime

- [Findings files](https://github.com/ibnaleem/gosearch/blob/main/internal/utils/utils.go): `internal/utils/utils.go`
- [Runtime configuration](https://github.com/ibnaleem/gosearch/blob/main/internal/config/config.go): `internal/config/config.go`
- [Search data models](https://github.com/ibnaleem/gosearch/blob/main/internal/models/models.go): `internal/models/models.go`
- [Terminal presentation](https://github.com/ibnaleem/gosearch/blob/main/internal/theme/theme.go): `internal/theme/theme.go`

### Other components

- **Username seeker**
- **Breach data services**
- **Weakpass service**

## Connections

- Username seeker → Command-line runner: provides username (evidence: `README.md`)
- Command-line runner → Website catalog loader: loads catalog (evidence: `main.go`)
- Website catalog loader → Website services: downloads catalog (evidence: `internal/utils/utils.go`)
- Command-line runner → Website checks: starts checks (evidence: `main.go`)
- Command-line runner → Domain checks: starts domain checks (evidence: `main.go`)
- Website checks → Website services: checks profiles
- Command-line runner → GitHub investigations: runs enrichment (evidence: `main.go`)
- Command-line runner → HudsonRock breach search: searches breaches (evidence: `main.go`)
- Command-line runner → ProxyNova breach search: searches breaches (evidence: `main.go`)
- Command-line runner → BreachDirectory search: optional lookup (evidence: `main.go`)
- BreachDirectory search → Hash cracking: cracks hashes (evidence: `internal/modules/breachdirectory/breachdirectory.go`)
- HudsonRock breach search → Breach data services: queries service (evidence: `internal/modules/hudsonrock/hudsonrock.go`)
- ProxyNova breach search → Breach data services: queries service (evidence: `internal/modules/proxynova/proxynova.go`)
- Hash cracking → Weakpass service: checks hashes
- Command-line runner → Gravatar lookup: looks up profile
- Command-line runner → Keybase lookup: looks up profile
- Website checks → Findings files: writes findings (evidence: `internal/search/search.go`)
- HudsonRock breach search → Findings files: writes findings (evidence: `internal/modules/hudsonrock/hudsonrock.go`)
- ProxyNova breach search → Findings files: writes findings (evidence: `internal/modules/proxynova/proxynova.go`)
- BreachDirectory search → Findings files: writes findings (evidence: `internal/modules/breachdirectory/breachdirectory.go`)
- Command-line runner → Search data models: uses search data (evidence: `main.go`)
- Website checks → Search data models: reads website records (evidence: `internal/search/search.go`)
- GitHub investigations → Findings files: saves findings
