How gorkemguler/utilikit works
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: app.py HTTP application · safefetch.py Safe fetch · web_capture.py Capture tools · misc.py Request bin and links
Components 29
API and discovery
- HTTP application
src/utilikit/app.py - Tool registry
src/utilikit/registry.py - Tool index
src/utilikit/web/templates/index.html - CLI
src/utilikit/cli.py
Network intelligence
- DNS tools
src/utilikit/tools/net_dns.py - WHOIS and ASN
src/utilikit/tools/net_whois.py - HTTP and TLS
src/utilikit/tools/net_http.py
Web workflows
- Capture tools
src/utilikit/tools/web_capture.py - Chromium manager
src/utilikit/browser.py - Web metadata
src/utilikit/tools/web_meta.py - Request bin and links
src/utilikit/tools/misc.py
Utility tools
- Codecs and crypto
src/utilikit/tools/codec.py - Image tools
src/utilikit/tools/media_image.py - QR and barcode
src/utilikit/tools/qr.py - Text tools
src/utilikit/tools/text.py - Data conversion
src/utilikit/tools/data_fmt.py - IDs and passwords
src/utilikit/tools/idgen.py - Color tools
src/utilikit/tools/color.py - Time tools
src/utilikit/tools/time_tools.py
Runtime services
- Settings
src/utilikit/config.py - Auth and metrics
src/utilikit/security.py - Rate limiter
src/utilikit/ratelimit.py - Safe fetch
src/utilikit/safefetch.py - TTL cache
src/utilikit/cache.py - Async jobs
src/utilikit/jobs.py - SQLite store
src/utilikit/db.py - Error handling
src/utilikit/errors.py
Other components
- API caller
- Public network
Connections 39
- API caller → HTTP application: calls API
README.md - HTTP application → Tool registry: builds index
src/utilikit/app.py - HTTP application → Tool index: renders
src/utilikit/app.py - API caller → CLI: runs commands
README.md - CLI → HTTP application: serves
src/utilikit/cli.py - CLI → Tool registry: lists tools
src/utilikit/cli.py - HTTP application → Rate limiter: installs middleware
src/utilikit/app.py - Rate limiter → Auth and metrics: identifies clients
src/utilikit/ratelimit.py - HTTP application → Error handling: installs handlers
src/utilikit/app.py - HTTP application → Async jobs: reports status
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
src/utilikit/tools/net_dns.py - WHOIS and ASN → TTL cache: caches results
src/utilikit/tools/net_whois.py - HTTP and TLS → Safe fetch: fetches safely
src/utilikit/tools/net_http.py - Web metadata → Safe fetch: fetches safely
src/utilikit/tools/web_meta.py - Image tools → Safe fetch: fetches safely
src/utilikit/tools/media_image.py - Request bin and links → Safe fetch: checks hosts
src/utilikit/tools/misc.py - Capture tools → Chromium manager: renders pages
src/utilikit/tools/web_capture.py - Capture tools → Async jobs: submits jobs
src/utilikit/tools/web_capture.py - Capture tools → Safe fetch: validates targets
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
src/utilikit/tools/misc.py - Request bin and links → SQLite store: stores short links
src/utilikit/tools/misc.py