# kerlooo/freeosintui architecture

> Architecture diagram of the GitHub repository kerlooo/freeosintui, 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/kerlooo/freeosintui
- Repository: https://github.com/kerlooo/freeosintui

## Overview

FreeOSINT-UI is a browser-first OSINT toolkit: users submit an indicator or file, a tool-specific analyzer gathers or derives public-data results, and the UI presents findings and export options. Most analysis is client-side; the Python API supplies CORS-blocked lookups and the username and Telegram tools. The graph preserves the README’s major tool families, including capabilities whose implementation was not sampled. Dashed links mark frontend/API relationships not visible in the excerpts; unsampled frontend internals are represented by their exact source directories.

Main entry points: [`src/routes`](https://github.com/kerlooo/freeosintui/tree/main/src/routes) (Tool pages), [`backend/app/main.py`](https://github.com/kerlooo/freeosintui/blob/main/backend/app/main.py) (API routing), [`backend/app/url.py`](https://github.com/kerlooo/freeosintui/blob/main/backend/app/url.py) (URL services), [`backend/app/reputation.py`](https://github.com/kerlooo/freeosintui/blob/main/backend/app/reputation.py) (Reputation service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser tools"]
  node_email["Email analysis"]
  node_phone["Phone analysis"]
  node_dorks["Dork generation"]
  node_github["GitHub OSINT"]
  node_domain["Domain analysis"]
  node_ip["IP analysis"]
  node_lookalike["Lookalike domains"]
  node_footprint["Site footprint"]
  node_favicon["Favicon analysis"]
  node_reputation["Reputation checks"]
  node_url["URL analysis"]
  node_headers["Header analysis"]
  node_leaks["Leak checks"]
  node_hash["Hash analysis"]
  node_metadata["Metadata extraction"]
  node_crypto["Crypto tracing"]
  node_timestamp["Timestamp decoding"]
  node_mac["MAC lookup"]
  node_export["Report export<br/>[report.js]"]
end

subgraph group_backend["Backend services"]
  node_telegram["Telegram OSINT<br/>[telegram.py]"]
  node_username["Username checks<br/>[wmn.py]"]
  node_backend_url["URL services<br/>[url.py]"]
  node_backend_footprint["Footprint service<br/>[footprint.py]"]
  node_backend_rep["Reputation service<br/>[reputation.py]"]
  node_api_routes["API routing<br/>[main.py]"]
end

subgraph group_shared["Shared runtime"]
  node_api_client["API client<br/>[api.js]"]
  node_http["HTTP client<br/>[http.py]"]
  node_rate_limit["Rate limiting<br/>[ratelimit.py]"]
  node_config["Service settings<br/>[config.py]"]
end

subgraph group_presentation["User interface"]
  node_tool_pages["Tool pages"]
  node_tool_ui["Result views"]
end

node_user(("Investigator"))

node_user -->|"uses"| node_tool_pages
node_tool_pages -.->|"shows results"| node_tool_ui
node_tool_pages -.->|"runs analysis"| node_email
node_tool_pages -.->|"runs analysis"| node_phone
node_tool_pages -.->|"generates dorks"| node_dorks
node_tool_pages -.->|"runs lookup"| node_github
node_tool_pages -.->|"runs analysis"| node_domain
node_tool_pages -.->|"runs lookup"| node_ip
node_tool_pages -.->|"checks variants"| node_lookalike
node_tool_pages -.->|"searches archives"| node_footprint
node_tool_pages -.->|"computes hashes"| node_favicon
node_tool_pages -.->|"checks indicators"| node_reputation
node_tool_pages -.->|"analyzes URL"| node_url
node_tool_pages -.->|"parses headers"| node_headers
node_tool_pages -.->|"checks exposure"| node_leaks
node_tool_pages -.->|"computes hashes"| node_hash
node_tool_pages -.->|"extracts metadata"| node_metadata
node_tool_pages -.->|"traces addresses"| node_crypto
node_tool_pages -.->|"decodes values"| node_timestamp
node_tool_pages -.->|"resolves vendor"| node_mac
node_tool_pages -.->|"requests API"| node_api_client
node_api_client -.->|"calls endpoints"| node_api_routes
node_api_routes -->|"dispatches"| node_telegram
node_api_routes -->|"dispatches"| node_username
node_api_routes -->|"dispatches"| node_backend_url
node_api_routes -->|"dispatches"| node_backend_footprint
node_api_routes -->|"dispatches"| node_backend_rep
node_backend_url -->|"fetches data"| node_http
node_backend_rep -->|"fetches data"| node_http
node_username -->|"fetches profiles"| node_http
node_backend_url -.->|"served by"| node_api_routes
node_tool_pages -.->|"exports reports"| node_export
node_api_routes -->|"uses settings"| node_config
node_backend_rep -.->|"limits requests"| node_rate_limit

click node_tool_pages "https://github.com/kerlooo/freeosintui/tree/main/src/routes"
click node_tool_ui "https://github.com/kerlooo/freeosintui/tree/main/src/lib/components"
click node_api_client "https://github.com/kerlooo/freeosintui/blob/main/src/lib/api.js"
click node_email "https://github.com/kerlooo/freeosintui/tree/main/src/lib/email"
click node_phone "https://github.com/kerlooo/freeosintui/tree/main/src/lib/phone"
click node_dorks "https://github.com/kerlooo/freeosintui/tree/main/src/lib/dorks"
click node_github "https://github.com/kerlooo/freeosintui/tree/main/src/lib/github"
click node_domain "https://github.com/kerlooo/freeosintui/tree/main/src/lib/domain"
click node_ip "https://github.com/kerlooo/freeosintui/tree/main/src/lib/ip"
click node_lookalike "https://github.com/kerlooo/freeosintui/tree/main/src/lib/lookalike"
click node_footprint "https://github.com/kerlooo/freeosintui/tree/main/src/lib/footprint"
click node_favicon "https://github.com/kerlooo/freeosintui/tree/main/src/lib/favicon"
click node_reputation "https://github.com/kerlooo/freeosintui/tree/main/src/lib/reputation"
click node_url "https://github.com/kerlooo/freeosintui/tree/main/src/lib/url"
click node_headers "https://github.com/kerlooo/freeosintui/tree/main/src/lib/headers"
click node_leaks "https://github.com/kerlooo/freeosintui/tree/main/src/lib/leaks"
click node_hash "https://github.com/kerlooo/freeosintui/tree/main/src/lib/hash"
click node_metadata "https://github.com/kerlooo/freeosintui/tree/main/src/lib/metadata"
click node_crypto "https://github.com/kerlooo/freeosintui/tree/main/src/lib/crypto"
click node_timestamp "https://github.com/kerlooo/freeosintui/tree/main/src/lib/timestamp"
click node_mac "https://github.com/kerlooo/freeosintui/tree/main/src/lib/mac"
click node_telegram "https://github.com/kerlooo/freeosintui/blob/main/backend/app/telegram.py"
click node_username "https://github.com/kerlooo/freeosintui/blob/main/backend/app/wmn.py"
click node_backend_url "https://github.com/kerlooo/freeosintui/blob/main/backend/app/url.py"
click node_backend_footprint "https://github.com/kerlooo/freeosintui/blob/main/backend/app/footprint.py"
click node_backend_rep "https://github.com/kerlooo/freeosintui/blob/main/backend/app/reputation.py"
click node_api_routes "https://github.com/kerlooo/freeosintui/blob/main/backend/app/main.py"
click node_http "https://github.com/kerlooo/freeosintui/blob/main/backend/app/http.py"
click node_rate_limit "https://github.com/kerlooo/freeosintui/blob/main/backend/app/ratelimit.py"
click node_config "https://github.com/kerlooo/freeosintui/blob/main/backend/app/config.py"
click node_export "https://github.com/kerlooo/freeosintui/blob/main/src/lib/export/report.js"

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_email,node_phone,node_dorks,node_github,node_domain,node_ip,node_lookalike,node_footprint,node_favicon,node_reputation,node_url,node_headers,node_leaks,node_hash,node_metadata,node_crypto,node_timestamp,node_mac,node_export toneBlue
class node_telegram,node_username,node_backend_url,node_backend_footprint,node_backend_rep,node_api_routes toneAmber
class node_api_client,node_http,node_rate_limit,node_config toneMint
class node_tool_pages,node_tool_ui toneRose
class node_user toneIndigo
```

## Components

### Browser tools

- [Email analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/email): `src/lib/email`
- [Phone analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/phone): `src/lib/phone`
- [Dork generation](https://github.com/kerlooo/freeosintui/tree/main/src/lib/dorks): `src/lib/dorks`
- [GitHub OSINT](https://github.com/kerlooo/freeosintui/tree/main/src/lib/github): `src/lib/github`
- [Domain analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/domain): `src/lib/domain`
- [IP analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/ip): `src/lib/ip`
- [Lookalike domains](https://github.com/kerlooo/freeosintui/tree/main/src/lib/lookalike): `src/lib/lookalike`
- [Site footprint](https://github.com/kerlooo/freeosintui/tree/main/src/lib/footprint): `src/lib/footprint`
- [Favicon analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/favicon): `src/lib/favicon`
- [Reputation checks](https://github.com/kerlooo/freeosintui/tree/main/src/lib/reputation): `src/lib/reputation`
- [URL analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/url): `src/lib/url`
- [Header analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/headers): `src/lib/headers`
- [Leak checks](https://github.com/kerlooo/freeosintui/tree/main/src/lib/leaks): `src/lib/leaks`
- [Hash analysis](https://github.com/kerlooo/freeosintui/tree/main/src/lib/hash): `src/lib/hash`
- [Metadata extraction](https://github.com/kerlooo/freeosintui/tree/main/src/lib/metadata): `src/lib/metadata`
- [Crypto tracing](https://github.com/kerlooo/freeosintui/tree/main/src/lib/crypto): `src/lib/crypto`
- [Timestamp decoding](https://github.com/kerlooo/freeosintui/tree/main/src/lib/timestamp): `src/lib/timestamp`
- [MAC lookup](https://github.com/kerlooo/freeosintui/tree/main/src/lib/mac): `src/lib/mac`
- [Report export](https://github.com/kerlooo/freeosintui/blob/main/src/lib/export/report.js): `src/lib/export/report.js`

### Backend services

- [Telegram OSINT](https://github.com/kerlooo/freeosintui/blob/main/backend/app/telegram.py): `backend/app/telegram.py`
- [Username checks](https://github.com/kerlooo/freeosintui/blob/main/backend/app/wmn.py): `backend/app/wmn.py`
- [URL services](https://github.com/kerlooo/freeosintui/blob/main/backend/app/url.py): `backend/app/url.py`
- [Footprint service](https://github.com/kerlooo/freeosintui/blob/main/backend/app/footprint.py): `backend/app/footprint.py`
- [Reputation service](https://github.com/kerlooo/freeosintui/blob/main/backend/app/reputation.py): `backend/app/reputation.py`
- [API routing](https://github.com/kerlooo/freeosintui/blob/main/backend/app/main.py): `backend/app/main.py`

### Shared runtime

- [API client](https://github.com/kerlooo/freeosintui/blob/main/src/lib/api.js): `src/lib/api.js`
- [HTTP client](https://github.com/kerlooo/freeosintui/blob/main/backend/app/http.py): `backend/app/http.py`
- [Rate limiting](https://github.com/kerlooo/freeosintui/blob/main/backend/app/ratelimit.py): `backend/app/ratelimit.py`
- [Service settings](https://github.com/kerlooo/freeosintui/blob/main/backend/app/config.py): `backend/app/config.py`

### User interface

- [Tool pages](https://github.com/kerlooo/freeosintui/tree/main/src/routes): `src/routes`
- [Result views](https://github.com/kerlooo/freeosintui/tree/main/src/lib/components): `src/lib/components`

### Other components

- **Investigator**

## Connections

- Investigator → Tool pages: uses
- Tool pages → Result views: shows results
- Tool pages → Email analysis: runs analysis
- Tool pages → Phone analysis: runs analysis
- Tool pages → Dork generation: generates dorks
- Tool pages → GitHub OSINT: runs lookup
- Tool pages → Domain analysis: runs analysis
- Tool pages → IP analysis: runs lookup
- Tool pages → Lookalike domains: checks variants
- Tool pages → Site footprint: searches archives
- Tool pages → Favicon analysis: computes hashes
- Tool pages → Reputation checks: checks indicators
- Tool pages → URL analysis: analyzes URL
- Tool pages → Header analysis: parses headers
- Tool pages → Leak checks: checks exposure
- Tool pages → Hash analysis: computes hashes
- Tool pages → Metadata extraction: extracts metadata
- Tool pages → Crypto tracing: traces addresses
- Tool pages → Timestamp decoding: decodes values
- Tool pages → MAC lookup: resolves vendor
- Tool pages → API client: requests API
- API client → API routing: calls endpoints
- API routing → Telegram OSINT: dispatches (evidence: `backend/app/main.py`)
- API routing → Username checks: dispatches (evidence: `backend/app/main.py`)
- API routing → URL services: dispatches (evidence: `backend/app/main.py`)
- API routing → Footprint service: dispatches (evidence: `backend/app/main.py`)
- API routing → Reputation service: dispatches (evidence: `backend/app/main.py`)
- URL services → HTTP client: fetches data (evidence: `backend/app/routers/url.py`)
- Reputation service → HTTP client: fetches data (evidence: `backend/app/routers/reputation.py`)
- Username checks → HTTP client: fetches profiles (evidence: `backend/app/routers/username.py`)
- URL services → API routing: served by
- Tool pages → Report export: exports reports
- API routing → Service settings: uses settings (evidence: `backend/app/main.py`)
- Reputation service → Rate limiting: limits requests
