# bigbodycobain/shadowbroker architecture

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

- Interactive diagram: https://gitdiagram.com/bigbodycobain/shadowbroker
- Repository: https://github.com/bigbodycobain/shadowbroker

## Overview

ShadowBroker is a self-hosted geospatial intelligence platform: operators view aggregated public telemetry on a live map, then inspect entities, run recon, and use analysis tools. Its backend supplies feeds and secured lookup APIs; the frontend presents the map and domain panels. Separate capabilities include satellite change analysis, agent access, and the experimental InfoNet/mesh exchange. The graph preserves major README features, but several backend subsystems are unsampled; their connections are included only where documented in the README or visible in indexed references.

Main entry points: [`backend/auth.py`](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/auth.py) (Access Control), [`frontend/src/components/WorldviewLeftPanel.tsx`](https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/components/WorldviewLeftPanel.tsx) (Intel Panels), [`backend/services/mesh/mesh_router.py`](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_router.py) (Transport Routing), [`backend/main.py`](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/main.py) (Backend API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operator Interface"]
  node_dashboard["Map Dashboard<br/>[page.tsx]"]
  node_map["Map Layers<br/>[MaplibreViewer.tsx]"]
  node_panels["Intel Panels"]
  node_mesh_ui["Mesh Chat"]
end

subgraph group_intel["Intelligence Services"]
  node_api["Backend API<br/>[main.py]"]
  node_auth["Access Control<br/>[auth.py]"]
  node_feeds["Live Feed Aggregation<br/>[data_fetcher.py]"]
  node_ai_api["AI Intel API<br/>[ai_intel.py]"]
  node_pin_store[("Intel Pin Store<br/>[ai_pin_store.py]")]
  node_config["Runtime Settings<br/>[config.py]"]
  node_recon["Recon Toolkit<br/>[osint.py]"]
  node_shodan["Shodan Connector"]
end

subgraph group_analysis["Analysis Tools"]
  node_sar["SAR Analysis"]
  node_corridor["Road Corridor Analysis<br/>[pipeline.py]"]
  node_analytics["Threat Analytics<br/>[integration.py]"]
  node_agent["Agent Command Channel"]
end

subgraph group_mesh["Mesh Exchange"]
  node_mesh_api["Mesh API<br/>[mesh_public.py]"]
  node_mesh_router["Transport Routing<br/>[mesh_router.py]"]
  node_mesh_crypto["Mesh Cryptography<br/>[mesh_crypto.py]"]
  node_mesh_policy["Privacy Policy"]
  node_mesh_compat[("Compatibility State")]
  node_hashchain["Event Hashchain<br/>[mesh_hashchain.py]"]
  node_wormhole["Wormhole Supervisor"]
  node_worm_settings["Wormhole Settings"]
  node_worm_status["Wormhole Status<br/>[wormhole_status.py]"]
  node_release["Release Profiles"]
  node_env_check["Environment Checks<br/>[env_check.py]"]
end

subgraph group_desktop["Desktop Runtime"]
  node_desktop_shell["Desktop Shell<br/>[main.rs]"]
  node_gate_crypto["Gate Cryptography<br/>[gate_crypto.rs]"]
  node_custody["Local Key Custody<br/>[local_custody.rs]"]
end

node_operator(("Analyst"))

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_map
node_dashboard -->|"presents"| node_panels
node_map -->|"requests telemetry"| node_api
node_panels -->|"requests features"| node_api
node_api -->|"checks access"| node_auth
node_api -->|"serves telemetry"| node_feeds
node_panels -->|"queries intel"| node_ai_api
node_ai_api -->|"manages pins"| node_pin_store
node_auth -->|"loads settings"| node_config
node_panels -->|"requests lookups"| node_recon
node_recon -->|"queries devices"| node_shodan
node_panels -->|"requests imagery"| node_sar
node_panels -->|"views trends"| node_corridor
node_panels -->|"views alerts"| node_analytics
node_operator -->|"connects agent"| node_agent
node_agent -->|"searches telemetry"| node_api
node_operator -->|"opens exchange"| node_mesh_ui
node_mesh_ui -->|"exchanges messages"| node_mesh_api
node_mesh_api -.->|"routes messages"| node_mesh_router
node_mesh_router -->|"secures payloads"| node_mesh_crypto
node_mesh_router -->|"checks transport policy"| node_mesh_policy
node_mesh_router -->|"uses private transport"| node_wormhole
node_mesh_router -->|"records events"| node_hashchain
node_wormhole -->|"loads settings"| node_worm_settings
node_wormhole -->|"updates status"| node_worm_status
node_mesh_policy -->|"reads transport state"| node_wormhole
node_auth -->|"checks compatibility"| node_mesh_compat
node_auth -->|"uses cryptography"| node_mesh_crypto
node_auth -->|"enforces privacy tiers"| node_mesh_policy
node_auth -->|"checks release profile"| node_release
node_auth -->|"reads settings"| node_worm_settings
node_auth -->|"reads status"| node_worm_status
node_env_check -->|"validates settings"| node_config
node_env_check -->|"checks profile"| node_release
node_release -->|"loads settings"| node_config
node_desktop_shell -->|"registers handlers"| node_gate_crypto
node_desktop_shell -->|"uses key custody"| node_custody

click node_dashboard "https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/app/page.tsx"
click node_map "https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/components/MaplibreViewer.tsx"
click node_panels "https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/components/WorldviewLeftPanel.tsx"
click node_api "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/main.py"
click node_auth "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/auth.py"
click node_feeds "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/data_fetcher.py"
click node_ai_api "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/routers/ai_intel.py"
click node_pin_store "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/ai_pin_store.py"
click node_config "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/config.py"
click node_recon "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/routers/osint.py"
click node_shodan "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/shodan_connector.py"
click node_sar "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/sar/sar_products_client.py"
click node_corridor "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/road_corridor_sat/pipeline.py"
click node_analytics "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/analytics/integration.py"
click node_agent "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/openclaw_channel.py"
click node_mesh_ui "https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/components/MeshChat/useMeshChatController.ts"
click node_mesh_api "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/routers/mesh_public.py"
click node_mesh_router "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_router.py"
click node_mesh_crypto "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_crypto.py"
click node_mesh_policy "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_privacy_policy.py"
click node_mesh_compat "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_compatibility.py"
click node_hashchain "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_hashchain.py"
click node_wormhole "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/wormhole_supervisor.py"
click node_worm_settings "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/wormhole_settings.py"
click node_worm_status "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/wormhole_status.py"
click node_release "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/release_profiles.py"
click node_env_check "https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/env_check.py"
click node_desktop_shell "https://github.com/bigbodycobain/shadowbroker/blob/main/desktop-shell/tauri-skeleton/src-tauri/src/main.rs"
click node_gate_crypto "https://github.com/bigbodycobain/shadowbroker/blob/main/desktop-shell/tauri-skeleton/src-tauri/src/gate_crypto.rs"
click node_custody "https://github.com/bigbodycobain/shadowbroker/blob/main/desktop-shell/tauri-skeleton/src-tauri/src/local_custody.rs"

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_dashboard,node_map,node_panels,node_mesh_ui toneBlue
class node_api,node_auth,node_feeds,node_ai_api,node_pin_store,node_config,node_recon,node_shodan toneAmber
class node_sar,node_corridor,node_analytics,node_agent toneMint
class node_mesh_api,node_mesh_router,node_mesh_crypto,node_mesh_policy,node_mesh_compat,node_hashchain,node_wormhole,node_worm_settings,node_worm_status,node_release,node_env_check toneRose
class node_desktop_shell,node_gate_crypto,node_custody,node_operator toneIndigo
```

## Components

### Operator Interface

- [Map Dashboard](https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Map Layers](https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/components/MaplibreViewer.tsx): `frontend/src/components/MaplibreViewer.tsx`
- [Intel Panels](https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/components/WorldviewLeftPanel.tsx): `frontend/src/components/WorldviewLeftPanel.tsx`
- [Mesh Chat](https://github.com/bigbodycobain/shadowbroker/blob/main/frontend/src/components/MeshChat/useMeshChatController.ts): `frontend/src/components/MeshChat/useMeshChatController.ts`

### Intelligence Services

- [Backend API](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/main.py): `backend/main.py`
- [Access Control](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/auth.py): `backend/auth.py`
- [Live Feed Aggregation](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/data_fetcher.py): `backend/services/data_fetcher.py`
- [AI Intel API](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/routers/ai_intel.py): `backend/routers/ai_intel.py`
- [Intel Pin Store](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/ai_pin_store.py): `backend/services/ai_pin_store.py`
- [Runtime Settings](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/config.py): `backend/services/config.py`
- [Recon Toolkit](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/routers/osint.py): `backend/routers/osint.py`
- [Shodan Connector](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/shodan_connector.py): `backend/services/shodan_connector.py`

### Analysis Tools

- [SAR Analysis](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/sar/sar_products_client.py): `backend/services/sar/sar_products_client.py`
- [Road Corridor Analysis](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/road_corridor_sat/pipeline.py): `backend/services/road_corridor_sat/pipeline.py`
- [Threat Analytics](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/analytics/integration.py): `backend/analytics/integration.py`
- [Agent Command Channel](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/openclaw_channel.py): `backend/services/openclaw_channel.py`

### Mesh Exchange

- [Mesh API](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/routers/mesh_public.py): `backend/routers/mesh_public.py`
- [Transport Routing](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_router.py): `backend/services/mesh/mesh_router.py`
- [Mesh Cryptography](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_crypto.py): `backend/services/mesh/mesh_crypto.py`
- [Privacy Policy](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_privacy_policy.py): `backend/services/mesh/mesh_privacy_policy.py`
- [Compatibility State](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_compatibility.py): `backend/services/mesh/mesh_compatibility.py`
- [Event Hashchain](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/mesh/mesh_hashchain.py): `backend/services/mesh/mesh_hashchain.py`
- [Wormhole Supervisor](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/wormhole_supervisor.py): `backend/services/wormhole_supervisor.py`
- [Wormhole Settings](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/wormhole_settings.py): `backend/services/wormhole_settings.py`
- [Wormhole Status](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/wormhole_status.py): `backend/services/wormhole_status.py`
- [Release Profiles](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/release_profiles.py): `backend/services/release_profiles.py`
- [Environment Checks](https://github.com/bigbodycobain/shadowbroker/blob/main/backend/services/env_check.py): `backend/services/env_check.py`

### Desktop Runtime

- [Desktop Shell](https://github.com/bigbodycobain/shadowbroker/blob/main/desktop-shell/tauri-skeleton/src-tauri/src/main.rs): `desktop-shell/tauri-skeleton/src-tauri/src/main.rs`
- [Gate Cryptography](https://github.com/bigbodycobain/shadowbroker/blob/main/desktop-shell/tauri-skeleton/src-tauri/src/gate_crypto.rs): `desktop-shell/tauri-skeleton/src-tauri/src/gate_crypto.rs`
- [Local Key Custody](https://github.com/bigbodycobain/shadowbroker/blob/main/desktop-shell/tauri-skeleton/src-tauri/src/local_custody.rs): `desktop-shell/tauri-skeleton/src-tauri/src/local_custody.rs`

### Other components

- **Analyst**

## Connections

- Analyst → Map Dashboard: uses (evidence: `README.md`)
- Map Dashboard → Map Layers: renders (evidence: `README.md`)
- Map Dashboard → Intel Panels: presents (evidence: `README.md`)
- Map Layers → Backend API: requests telemetry (evidence: `README.md`)
- Intel Panels → Backend API: requests features (evidence: `README.md`)
- Backend API → Access Control: checks access (evidence: `backend/main.py`)
- Backend API → Live Feed Aggregation: serves telemetry (evidence: `backend/main.py`)
- Intel Panels → AI Intel API: queries intel (evidence: `README.md`)
- AI Intel API → Intel Pin Store: manages pins (evidence: `backend/routers/ai_intel.py`)
- Access Control → Runtime Settings: loads settings (evidence: `backend/auth.py`)
- Intel Panels → Recon Toolkit: requests lookups (evidence: `README.md`)
- Recon Toolkit → Shodan Connector: queries devices (evidence: `README.md`)
- Intel Panels → SAR Analysis: requests imagery (evidence: `README.md`)
- Intel Panels → Road Corridor Analysis: views trends (evidence: `README.md`)
- Intel Panels → Threat Analytics: views alerts (evidence: `README.md`)
- Analyst → Agent Command Channel: connects agent (evidence: `README.md`)
- Agent Command Channel → Backend API: searches telemetry (evidence: `README.md`)
- Analyst → Mesh Chat: opens exchange (evidence: `README.md`)
- Mesh Chat → Mesh API: exchanges messages (evidence: `README.md`)
- Mesh API → Transport Routing: routes messages
- Transport Routing → Mesh Cryptography: secures payloads (evidence: `backend/services/mesh/mesh_router.py`)
- Transport Routing → Privacy Policy: checks transport policy (evidence: `backend/services/mesh/mesh_router.py`)
- Transport Routing → Wormhole Supervisor: uses private transport (evidence: `backend/services/mesh/mesh_router.py`)
- Transport Routing → Event Hashchain: records events (evidence: `backend/services/mesh/mesh_router.py`)
- Wormhole Supervisor → Wormhole Settings: loads settings (evidence: `backend/services/wormhole_supervisor.py`)
- Wormhole Supervisor → Wormhole Status: updates status (evidence: `backend/services/wormhole_supervisor.py`)
- Privacy Policy → Wormhole Supervisor: reads transport state (evidence: `backend/services/mesh/mesh_privacy_policy.py`)
- Access Control → Compatibility State: checks compatibility (evidence: `backend/auth.py`)
- Access Control → Mesh Cryptography: uses cryptography (evidence: `backend/auth.py`)
- Access Control → Privacy Policy: enforces privacy tiers (evidence: `backend/auth.py`)
- Access Control → Release Profiles: checks release profile (evidence: `backend/auth.py`)
- Access Control → Wormhole Settings: reads settings (evidence: `backend/auth.py`)
- Access Control → Wormhole Status: reads status (evidence: `backend/auth.py`)
- Environment Checks → Runtime Settings: validates settings (evidence: `backend/services/env_check.py`)
- Environment Checks → Release Profiles: checks profile (evidence: `backend/services/env_check.py`)
- Release Profiles → Runtime Settings: loads settings (evidence: `backend/services/release_profiles.py`)
- Desktop Shell → Gate Cryptography: registers handlers (evidence: `desktop-shell/tauri-skeleton/src-tauri/src/main.rs`)
- Desktop Shell → Local Key Custody: uses key custody (evidence: `desktop-shell/tauri-skeleton/src-tauri/src/main.rs`)