How bigbodycobain/shadowbroker works
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: auth.py Access Control · WorldviewLeftPanel.tsx Intel Panels · mesh_router.py Transport Routing · main.py Backend API
Components 31
Operator Interface
- Map Dashboard
frontend/src/app/page.tsx - Map Layers
frontend/src/components/MaplibreViewer.tsx - Intel Panels
frontend/src/components/WorldviewLeftPanel.tsx - Mesh Chat
frontend/src/components/MeshChat/useMeshChatController.ts
Intelligence Services
- Backend API
backend/main.py - Access Control
backend/auth.py - Live Feed Aggregation
backend/services/data_fetcher.py - AI Intel API
backend/routers/ai_intel.py - Intel Pin Store
backend/services/ai_pin_store.py - Runtime Settings
backend/services/config.py - Recon Toolkit
backend/routers/osint.py - Shodan Connector
backend/services/shodan_connector.py
Analysis Tools
- SAR Analysis
backend/services/sar/sar_products_client.py - Road Corridor Analysis
backend/services/road_corridor_sat/pipeline.py - Threat Analytics
backend/analytics/integration.py - Agent Command Channel
backend/services/openclaw_channel.py
Mesh Exchange
- Mesh API
backend/routers/mesh_public.py - Transport Routing
backend/services/mesh/mesh_router.py - Mesh Cryptography
backend/services/mesh/mesh_crypto.py - Privacy Policy
backend/services/mesh/mesh_privacy_policy.py - Compatibility State
backend/services/mesh/mesh_compatibility.py - Event Hashchain
backend/services/mesh/mesh_hashchain.py - Wormhole Supervisor
backend/services/wormhole_supervisor.py - Wormhole Settings
backend/services/wormhole_settings.py - Wormhole Status
backend/services/wormhole_status.py - Release Profiles
backend/services/release_profiles.py - Environment Checks
backend/services/env_check.py
Desktop Runtime
- Desktop Shell
desktop-shell/tauri-skeleton/src-tauri/src/main.rs - Gate Cryptography
desktop-shell/tauri-skeleton/src-tauri/src/gate_crypto.rs - Local Key Custody
desktop-shell/tauri-skeleton/src-tauri/src/local_custody.rs
Other components
- Analyst
Connections 38
- Analyst → Map Dashboard: uses
README.md - Map Dashboard → Map Layers: renders
README.md - Map Dashboard → Intel Panels: presents
README.md - Map Layers → Backend API: requests telemetry
README.md - Intel Panels → Backend API: requests features
README.md - Backend API → Access Control: checks access
backend/main.py - Backend API → Live Feed Aggregation: serves telemetry
backend/main.py - Intel Panels → AI Intel API: queries intel
README.md - AI Intel API → Intel Pin Store: manages pins
backend/routers/ai_intel.py - Access Control → Runtime Settings: loads settings
backend/auth.py - Intel Panels → Recon Toolkit: requests lookups
README.md - Recon Toolkit → Shodan Connector: queries devices
README.md - Intel Panels → SAR Analysis: requests imagery
README.md - Intel Panels → Road Corridor Analysis: views trends
README.md - Intel Panels → Threat Analytics: views alerts
README.md - Analyst → Agent Command Channel: connects agent
README.md - Agent Command Channel → Backend API: searches telemetry
README.md - Analyst → Mesh Chat: opens exchange
README.md - Mesh Chat → Mesh API: exchanges messages
README.md - Mesh API → Transport Routing: routes messages
- Transport Routing → Mesh Cryptography: secures payloads
backend/services/mesh/mesh_router.py - Transport Routing → Privacy Policy: checks transport policy
backend/services/mesh/mesh_router.py - Transport Routing → Wormhole Supervisor: uses private transport
backend/services/mesh/mesh_router.py - Transport Routing → Event Hashchain: records events
backend/services/mesh/mesh_router.py - Wormhole Supervisor → Wormhole Settings: loads settings
backend/services/wormhole_supervisor.py - Wormhole Supervisor → Wormhole Status: updates status
backend/services/wormhole_supervisor.py - Privacy Policy → Wormhole Supervisor: reads transport state
backend/services/mesh/mesh_privacy_policy.py - Access Control → Compatibility State: checks compatibility
backend/auth.py - Access Control → Mesh Cryptography: uses cryptography
backend/auth.py - Access Control → Privacy Policy: enforces privacy tiers
backend/auth.py - Access Control → Release Profiles: checks release profile
backend/auth.py - Access Control → Wormhole Settings: reads settings
backend/auth.py - Access Control → Wormhole Status: reads status
backend/auth.py - Environment Checks → Runtime Settings: validates settings
backend/services/env_check.py - Environment Checks → Release Profiles: checks profile
backend/services/env_check.py - Release Profiles → Runtime Settings: loads settings
backend/services/release_profiles.py - Desktop Shell → Gate Cryptography: registers handlers
desktop-shell/tauri-skeleton/src-tauri/src/main.rs - Desktop Shell → Local Key Custody: uses key custody
desktop-shell/tauri-skeleton/src-tauri/src/main.rs