# gorkemguler/utilikit architecture

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

- Interactive diagram: https://gitdiagram.com/gorkemguler/utilikit
- Repository: https://github.com/gorkemguler/utilikit

## Overview

Utilikit is a self-hosted FastAPI toolbox: callers use its HTTP API or browser index to request small network, web, media, text, time, and data tools. The app mounts registered tool routers and exposes a live catalogue; handlers return results directly or, for longer capture work, submit jobs for polling. Shared runtime concerns include configuration, auth/rate limiting, safe outbound fetches, caching, SQLite-backed request-bin/shortener state, and optional Chromium. The graph follows explicit README and sampled-source links; undocumented router wiring and unsampled internals are not inferred.

Main entry points: [`src/utilikit/app.py`](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/app.py) (HTTP application), [`src/utilikit/safefetch.py`](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/safefetch.py) (Safe fetch), [`src/utilikit/tools/web_capture.py`](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/web_capture.py) (Capture tools), [`src/utilikit/tools/misc.py`](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/misc.py) (Request bin and links)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and discovery"]
  node_app["HTTP application<br/>[app.py]"]
  node_catalog["Tool registry<br/>[registry.py]"]
  node_index["Tool index<br/>[index.html]"]
  node_cli["CLI<br/>[cli.py]"]
end

subgraph group_network["Network intelligence"]
  node_dns["DNS tools<br/>[net_dns.py]"]
  node_whois["WHOIS and ASN<br/>[net_whois.py]"]
  node_http["HTTP and TLS<br/>[net_http.py]"]
end

subgraph group_web["Web workflows"]
  node_capture["Capture tools<br/>[web_capture.py]"]
  node_browser["Chromium manager<br/>[browser.py]"]
  node_webmeta["Web metadata<br/>[web_meta.py]"]
  node_misc["Request bin and links<br/>[misc.py]"]
end

subgraph group_utilities["Utility tools"]
  node_codec["Codecs and crypto<br/>[codec.py]"]
  node_media["Image tools<br/>[media_image.py]"]
  node_qr["QR and barcode<br/>[qr.py]"]
  node_text["Text tools<br/>[text.py]"]
  node_data["Data conversion<br/>[data_fmt.py]"]
  node_ids["IDs and passwords<br/>[idgen.py]"]
  node_color["Color tools<br/>[color.py]"]
  node_time["Time tools<br/>[time_tools.py]"]
end

subgraph group_runtime["Runtime services"]
  node_config["Settings<br/>[config.py]"]
  node_auth["Auth and metrics<br/>[security.py]"]
  node_limiter["Rate limiter<br/>[ratelimit.py]"]
  node_fetch["Safe fetch<br/>[safefetch.py]"]
  node_cache["TTL cache<br/>[cache.py]"]
  node_jobs["Async jobs<br/>[jobs.py]"]
  node_db[("SQLite store<br/>[db.py]")]
  node_errors["Error handling<br/>[errors.py]"]
end

node_caller(("API caller"))
node_external(("Public network"))

node_caller -->|"calls API"| node_app
node_app -->|"builds index"| node_catalog
node_app -->|"renders"| node_index
node_caller -->|"runs commands"| node_cli
node_cli -->|"serves"| node_app
node_cli -->|"lists tools"| node_catalog
node_app -->|"installs middleware"| node_limiter
node_limiter -->|"identifies clients"| node_auth
node_app -->|"installs handlers"| node_errors
node_app -->|"reports status"| node_jobs
node_app -.->|"mounts routers"| node_dns
node_app -.->|"mounts routers"| node_whois
node_app -.->|"mounts routers"| node_http
node_app -.->|"mounts routers"| node_capture
node_app -.->|"mounts routers"| node_webmeta
node_app -.->|"mounts routers"| node_misc
node_app -.->|"mounts routers"| node_codec
node_app -.->|"mounts routers"| node_media
node_app -.->|"mounts routers"| node_qr
node_app -.->|"mounts routers"| node_text
node_app -.->|"mounts routers"| node_data
node_app -.->|"mounts routers"| node_ids
node_app -.->|"mounts routers"| node_color
node_app -.->|"mounts routers"| node_time
node_dns -->|"caches results"| node_cache
node_whois -->|"caches results"| node_cache
node_http -->|"fetches safely"| node_fetch
node_webmeta -->|"fetches safely"| node_fetch
node_media -->|"fetches safely"| node_fetch
node_misc -->|"checks hosts"| node_fetch
node_capture -->|"renders pages"| node_browser
node_capture -->|"submits jobs"| node_jobs
node_capture -->|"validates targets"| node_fetch
node_external -.->|"resolves names"| node_dns
node_external -.->|"serves records"| node_whois
node_external -.->|"serves responses"| node_http
node_external -.->|"receives requests"| node_fetch
node_misc -->|"stores bins"| node_db
node_misc -->|"stores short links"| node_db

click node_app "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/app.py"
click node_catalog "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/registry.py"
click node_index "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/web/templates/index.html"
click node_cli "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/cli.py"
click node_dns "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/net_dns.py"
click node_whois "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/net_whois.py"
click node_http "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/net_http.py"
click node_capture "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/web_capture.py"
click node_browser "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/browser.py"
click node_webmeta "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/web_meta.py"
click node_misc "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/misc.py"
click node_codec "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/codec.py"
click node_media "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/media_image.py"
click node_qr "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/qr.py"
click node_text "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/text.py"
click node_data "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/data_fmt.py"
click node_ids "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/idgen.py"
click node_color "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/color.py"
click node_time "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/time_tools.py"
click node_config "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/config.py"
click node_auth "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/security.py"
click node_limiter "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/ratelimit.py"
click node_fetch "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/safefetch.py"
click node_cache "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/cache.py"
click node_jobs "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/jobs.py"
click node_db "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/db.py"
click node_errors "https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/errors.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_app,node_catalog,node_index,node_cli toneBlue
class node_dns,node_whois,node_http toneAmber
class node_capture,node_browser,node_webmeta,node_misc,node_caller toneMint
class node_codec,node_media,node_qr,node_text,node_data,node_ids,node_color,node_time toneRose
class node_config,node_auth,node_limiter,node_fetch,node_cache,node_jobs,node_db,node_errors,node_external toneIndigo
```

## Components

### API and discovery

- [HTTP application](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/app.py): `src/utilikit/app.py`
- [Tool registry](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/registry.py): `src/utilikit/registry.py`
- [Tool index](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/web/templates/index.html): `src/utilikit/web/templates/index.html`
- [CLI](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/cli.py): `src/utilikit/cli.py`

### Network intelligence

- [DNS tools](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/net_dns.py): `src/utilikit/tools/net_dns.py`
- [WHOIS and ASN](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/net_whois.py): `src/utilikit/tools/net_whois.py`
- [HTTP and TLS](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/net_http.py): `src/utilikit/tools/net_http.py`

### Web workflows

- [Capture tools](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/web_capture.py): `src/utilikit/tools/web_capture.py`
- [Chromium manager](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/browser.py): `src/utilikit/browser.py`
- [Web metadata](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/web_meta.py): `src/utilikit/tools/web_meta.py`
- [Request bin and links](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/misc.py): `src/utilikit/tools/misc.py`

### Utility tools

- [Codecs and crypto](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/codec.py): `src/utilikit/tools/codec.py`
- [Image tools](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/media_image.py): `src/utilikit/tools/media_image.py`
- [QR and barcode](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/qr.py): `src/utilikit/tools/qr.py`
- [Text tools](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/text.py): `src/utilikit/tools/text.py`
- [Data conversion](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/data_fmt.py): `src/utilikit/tools/data_fmt.py`
- [IDs and passwords](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/idgen.py): `src/utilikit/tools/idgen.py`
- [Color tools](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/color.py): `src/utilikit/tools/color.py`
- [Time tools](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/tools/time_tools.py): `src/utilikit/tools/time_tools.py`

### Runtime services

- [Settings](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/config.py): `src/utilikit/config.py`
- [Auth and metrics](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/security.py): `src/utilikit/security.py`
- [Rate limiter](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/ratelimit.py): `src/utilikit/ratelimit.py`
- [Safe fetch](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/safefetch.py): `src/utilikit/safefetch.py`
- [TTL cache](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/cache.py): `src/utilikit/cache.py`
- [Async jobs](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/jobs.py): `src/utilikit/jobs.py`
- [SQLite store](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/db.py): `src/utilikit/db.py`
- [Error handling](https://github.com/gorkemguler/utilikit/blob/main/src/utilikit/errors.py): `src/utilikit/errors.py`

### Other components

- **API caller**
- **Public network**

## Connections

- API caller → HTTP application: calls API (evidence: `README.md`)
- HTTP application → Tool registry: builds index (evidence: `src/utilikit/app.py`)
- HTTP application → Tool index: renders (evidence: `src/utilikit/app.py`)
- API caller → CLI: runs commands (evidence: `README.md`)
- CLI → HTTP application: serves (evidence: `src/utilikit/cli.py`)
- CLI → Tool registry: lists tools (evidence: `src/utilikit/cli.py`)
- HTTP application → Rate limiter: installs middleware (evidence: `src/utilikit/app.py`)
- Rate limiter → Auth and metrics: identifies clients (evidence: `src/utilikit/ratelimit.py`)
- HTTP application → Error handling: installs handlers (evidence: `src/utilikit/app.py`)
- HTTP application → Async jobs: reports status (evidence: `src/utilikit/app.py`)
- HTTP application → DNS tools: mounts routers
- HTTP application → WHOIS and ASN: mounts routers
- HTTP application → HTTP and TLS: mounts routers
- HTTP application → Capture tools: mounts routers
- HTTP application → Web metadata: mounts routers
- HTTP application → Request bin and links: mounts routers
- HTTP application → Codecs and crypto: mounts routers
- HTTP application → Image tools: mounts routers
- HTTP application → QR and barcode: mounts routers
- HTTP application → Text tools: mounts routers
- HTTP application → Data conversion: mounts routers
- HTTP application → IDs and passwords: mounts routers
- HTTP application → Color tools: mounts routers
- HTTP application → Time tools: mounts routers
- DNS tools → TTL cache: caches results (evidence: `src/utilikit/tools/net_dns.py`)
- WHOIS and ASN → TTL cache: caches results (evidence: `src/utilikit/tools/net_whois.py`)
- HTTP and TLS → Safe fetch: fetches safely (evidence: `src/utilikit/tools/net_http.py`)
- Web metadata → Safe fetch: fetches safely (evidence: `src/utilikit/tools/web_meta.py`)
- Image tools → Safe fetch: fetches safely (evidence: `src/utilikit/tools/media_image.py`)
- Request bin and links → Safe fetch: checks hosts (evidence: `src/utilikit/tools/misc.py`)
- Capture tools → Chromium manager: renders pages (evidence: `src/utilikit/tools/web_capture.py`)
- Capture tools → Async jobs: submits jobs (evidence: `src/utilikit/tools/web_capture.py`)
- Capture tools → Safe fetch: validates targets (evidence: `src/utilikit/tools/web_capture.py`)
- Public network → DNS tools: resolves names
- Public network → WHOIS and ASN: serves records
- Public network → HTTP and TLS: serves responses
- Public network → Safe fetch: receives requests
- Request bin and links → SQLite store: stores bins (evidence: `src/utilikit/tools/misc.py`)
- Request bin and links → SQLite store: stores short links (evidence: `src/utilikit/tools/misc.py`)
