# knwldgmedia/knwldgbox architecture

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

- Interactive diagram: https://gitdiagram.com/knwldgmedia/knwldgbox
- Repository: https://github.com/knwldgmedia/knwldgbox

## Overview

KNWLDGBox is a web-based OSINT and media-tools platform. A user enters through the Vue application, selects an investigation or utility, and receives analysis or streamed task results through the FastAPI backend; some analysis, notably image forensics, is described as browser-based. The graph preserves the major documented feature areas and the central API/configuration layer. Several feature views and backend integrations are unsampled, so their internal calls are omitted rather than inferred.

Main entry points: [`app/src/router/index.js`](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/router/index.js) (View router), [`backend/main.py`](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/main.py) (FastAPI routes), [`app/src/services/api.js`](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/services/api.js) (API client), [`backend/config.py`](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/config.py) (Runtime configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["App shell<br/>[App.vue]"]
  node_router["View router<br/>[index.js]"]
  node_api["API client<br/>[api.js]"]
  node_dashboard["Dashboard<br/>[Dashboard.vue]"]
  node_settings["Settings<br/>[Settings.vue]"]
end

subgraph group_investigation["OSINT investigations"]
  node_target_view["Target analysis<br/>[TargetAnalysis.vue]"]
  node_target_service["Target intelligence<br/>[target_service.py]"]
  node_social_view["Social forensics"]
  node_social_tools["Social tool modules"]
  node_leaks["Data leak checks<br/>[DataLeaks.vue]"]
  node_leak_service["Leak service"]
  node_dork["Dork builder<br/>[DorkBuilder.vue]"]
  node_map["OSINT map<br/>[OsintMap.vue]"]
end

subgraph group_media["Media and image tools"]
  node_image_view["Image forensics<br/>[ImageForensics.vue]"]
  node_image_engine["Image analysis<br/>[imageForensics.js]"]
  node_download_view["Media downloaders"]
  node_download_service["Download service"]
  node_archives["Local archives<br/>[Archives.vue]"]
  node_archive_service["Archive service<br/>[archive_service.py]"]
  node_collage["Collage tools<br/>[collage_service.py]"]
end

subgraph group_backend["API and runtime"]
  node_graph_service[("Graph persistence<br/>[graph_service.py]")]
  node_backend_api["FastAPI routes<br/>[main.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_router_class["Router discovery<br/>[routerClass.py]"]
end

subgraph group_state["Monitoring and graphs"]
  node_monitoring["Monitoring view<br/>[Monitoring.vue]"]
  node_telegram_ui["Telegram monitor"]
  node_rss_ui["RSS monitor<br/>[RssMonitor.vue]"]
  node_telegram_service["Telegram service"]
  node_graph_view["Network graphs<br/>[NetworkGraph.vue]"]
  node_graph_button["Send to graph"]
  node_graph_store["Graph state<br/>[graphStore.js]"]
end

node_user(("Investigator"))

node_user -->|"uses"| node_app
node_app -->|"navigates"| node_router
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_target_view
node_router -->|"routes to"| node_social_view
node_router -->|"routes to"| node_leaks
node_router -->|"routes to"| node_dork
node_router -->|"routes to"| node_map
node_router -->|"routes to"| node_image_view
node_router -->|"routes to"| node_download_view
node_router -->|"routes to"| node_archives
node_router -->|"routes to"| node_monitoring
node_router -->|"routes to"| node_graph_view
node_router -->|"routes to"| node_settings
node_social_view -.->|"offers tools"| node_social_tools
node_image_view -.->|"analyzes images"| node_image_engine
node_monitoring -->|"renders"| node_telegram_ui
node_monitoring -->|"renders"| node_rss_ui
node_telegram_ui -->|"requests service"| node_api
node_api -->|"calls HTTP routes"| node_backend_api
node_backend_api -->|"delegates"| node_telegram_service
node_backend_api -->|"delegates"| node_target_service
node_backend_api -->|"delegates"| node_leak_service
node_backend_api -->|"delegates"| node_download_service
node_backend_api -->|"delegates"| node_archive_service
node_backend_api -->|"delegates"| node_graph_service
node_backend_api -->|"registers routes"| node_collage
node_backend_api -->|"uses discovery"| node_router_class
node_settings -.->|"saves settings"| node_api
node_api -->|"manages graphs"| node_graph_service
node_graph_button -->|"updates state"| node_graph_store
node_graph_button -->|"loads graphs"| node_api
node_graph_store -->|"persists graphs"| node_api
node_download_service -->|"reads paths"| node_config
node_archive_service -->|"reads paths"| node_config
node_graph_service -->|"reads paths"| node_config
node_telegram_service -->|"loads credentials"| node_config

click node_app "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/App.vue"
click node_router "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/router/index.js"
click node_api "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/services/api.js"
click node_dashboard "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Dashboard.vue"
click node_target_view "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/TargetAnalysis.vue"
click node_target_service "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/target_service.py"
click node_social_view "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/SocialForensics.vue"
click node_social_tools "https://github.com/knwldgmedia/knwldgbox/tree/main/app/src/components/social"
click node_leaks "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/DataLeaks.vue"
click node_leak_service "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/dataleak_service.py"
click node_dork "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/DorkBuilder.vue"
click node_map "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/OsintMap.vue"
click node_image_view "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/ImageForensics.vue"
click node_image_engine "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/utils/imageForensics.js"
click node_download_view "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/MediaDownloaders.vue"
click node_download_service "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/downloader_service.py"
click node_archives "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Archives.vue"
click node_archive_service "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/archive_service.py"
click node_collage "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/collage_service.py"
click node_monitoring "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Monitoring.vue"
click node_telegram_ui "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/components/TelegramMonitor.vue"
click node_rss_ui "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/components/RssMonitor.vue"
click node_telegram_service "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/telegram_service.py"
click node_graph_view "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/NetworkGraph.vue"
click node_graph_button "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/components/SendToGraphButton.vue"
click node_graph_store "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/utils/graphStore.js"
click node_graph_service "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/graph_service.py"
click node_settings "https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Settings.vue"
click node_backend_api "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/main.py"
click node_config "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/config.py"
click node_router_class "https://github.com/knwldgmedia/knwldgbox/blob/main/backend/routerClass/routerClass.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_router,node_api,node_dashboard,node_settings toneBlue
class node_target_view,node_target_service,node_social_view,node_social_tools,node_leaks,node_leak_service,node_dork,node_map toneAmber
class node_image_view,node_image_engine,node_download_view,node_download_service,node_archives,node_archive_service,node_collage toneMint
class node_graph_service,node_backend_api,node_config,node_router_class toneRose
class node_monitoring,node_telegram_ui,node_rss_ui,node_telegram_service,node_graph_view,node_graph_button,node_graph_store,node_user toneIndigo
```

## Components

### Web application

- [App shell](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/App.vue): `app/src/App.vue`
- [View router](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/router/index.js): `app/src/router/index.js`
- [API client](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/services/api.js): `app/src/services/api.js`
- [Dashboard](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Dashboard.vue): `app/src/views/Dashboard.vue`
- [Settings](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Settings.vue): `app/src/views/Settings.vue`

### OSINT investigations

- [Target analysis](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/TargetAnalysis.vue): `app/src/views/TargetAnalysis.vue`
- [Target intelligence](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/target_service.py): `backend/target_service.py`
- [Social forensics](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/SocialForensics.vue): `app/src/views/SocialForensics.vue`
- [Social tool modules](https://github.com/knwldgmedia/knwldgbox/tree/main/app/src/components/social): `app/src/components/social`
- [Data leak checks](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/DataLeaks.vue): `app/src/views/DataLeaks.vue`
- [Leak service](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/dataleak_service.py): `backend/dataleak_service.py`
- [Dork builder](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/DorkBuilder.vue): `app/src/views/DorkBuilder.vue`
- [OSINT map](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/OsintMap.vue): `app/src/views/OsintMap.vue`

### Media and image tools

- [Image forensics](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/ImageForensics.vue): `app/src/views/ImageForensics.vue`
- [Image analysis](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/utils/imageForensics.js): `app/src/utils/imageForensics.js`
- [Media downloaders](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/MediaDownloaders.vue): `app/src/views/MediaDownloaders.vue`
- [Download service](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/downloader_service.py): `backend/downloader_service.py`
- [Local archives](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Archives.vue): `app/src/views/Archives.vue`
- [Archive service](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/archive_service.py): `backend/archive_service.py`
- [Collage tools](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/collage_service.py): `backend/collage_service.py`

### API and runtime

- [Graph persistence](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/graph_service.py): `backend/graph_service.py`
- [FastAPI routes](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/main.py): `backend/main.py`
- [Runtime configuration](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/config.py): `backend/config.py`
- [Router discovery](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/routerClass/routerClass.py): `backend/routerClass/routerClass.py`

### Monitoring and graphs

- [Monitoring view](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/Monitoring.vue): `app/src/views/Monitoring.vue`
- [Telegram monitor](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/components/TelegramMonitor.vue): `app/src/components/TelegramMonitor.vue`
- [RSS monitor](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/components/RssMonitor.vue): `app/src/components/RssMonitor.vue`
- [Telegram service](https://github.com/knwldgmedia/knwldgbox/blob/main/backend/telegram_service.py): `backend/telegram_service.py`
- [Network graphs](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/views/NetworkGraph.vue): `app/src/views/NetworkGraph.vue`
- [Send to graph](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/components/SendToGraphButton.vue): `app/src/components/SendToGraphButton.vue`
- [Graph state](https://github.com/knwldgmedia/knwldgbox/blob/main/app/src/utils/graphStore.js): `app/src/utils/graphStore.js`

### Other components

- **Investigator**

## Connections

- Investigator → App shell: uses (evidence: `README.md`)
- App shell → View router: navigates (evidence: `app/src/main.js`)
- View router → Dashboard: routes to (evidence: `app/src/router/index.js`)
- View router → Target analysis: routes to (evidence: `app/src/router/index.js`)
- View router → Social forensics: routes to (evidence: `app/src/router/index.js`)
- View router → Data leak checks: routes to (evidence: `app/src/router/index.js`)
- View router → Dork builder: routes to (evidence: `app/src/router/index.js`)
- View router → OSINT map: routes to (evidence: `app/src/router/index.js`)
- View router → Image forensics: routes to (evidence: `app/src/router/index.js`)
- View router → Media downloaders: routes to (evidence: `app/src/router/index.js`)
- View router → Local archives: routes to (evidence: `app/src/router/index.js`)
- View router → Monitoring view: routes to (evidence: `app/src/router/index.js`)
- View router → Network graphs: routes to (evidence: `app/src/router/index.js`)
- View router → Settings: routes to (evidence: `app/src/router/index.js`)
- Social forensics → Social tool modules: offers tools
- Image forensics → Image analysis: analyzes images
- Monitoring view → Telegram monitor: renders (evidence: `app/src/views/Monitoring.vue`)
- Monitoring view → RSS monitor: renders (evidence: `app/src/views/Monitoring.vue`)
- Telegram monitor → API client: requests service (evidence: `app/src/components/TelegramMonitor.vue`)
- API client → FastAPI routes: calls HTTP routes (evidence: `app/src/services/api.js`)
- FastAPI routes → Telegram service: delegates (evidence: `backend/main.py`)
- FastAPI routes → Target intelligence: delegates (evidence: `backend/main.py`)
- FastAPI routes → Leak service: delegates (evidence: `backend/main.py`)
- FastAPI routes → Download service: delegates (evidence: `backend/main.py`)
- FastAPI routes → Archive service: delegates (evidence: `backend/main.py`)
- FastAPI routes → Graph persistence: delegates (evidence: `backend/main.py`)
- FastAPI routes → Collage tools: registers routes (evidence: `backend/main.py`)
- FastAPI routes → Router discovery: uses discovery (evidence: `backend/main.py`)
- Settings → API client: saves settings
- API client → Graph persistence: manages graphs (evidence: `app/src/services/api.js`)
- Send to graph → Graph state: updates state (evidence: `app/src/components/SendToGraphButton.vue`)
- Send to graph → API client: loads graphs (evidence: `app/src/components/SendToGraphButton.vue`)
- Graph state → API client: persists graphs (evidence: `app/src/utils/graphStore.js`)
- Download service → Runtime configuration: reads paths (evidence: `backend/downloader_service.py`)
- Archive service → Runtime configuration: reads paths (evidence: `backend/archive_service.py`)
- Graph persistence → Runtime configuration: reads paths (evidence: `backend/graph_service.py`)
- Telegram service → Runtime configuration: loads credentials (evidence: `backend/telegram_service.py`)
