How arandomguyhere/ais_tracker works
Arsenal Ship Tracker is a maritime intelligence fusion proof of concept. Its principal workflow is AIS collection and vessel tracking through the API and persistent state, followed by analyst-facing enrichment and risk assessment. Separate documented branches cover SAR-to-AIS correlation, OSINT news analysis, and specialized threat monitoring. The excerpts show the server’s module imports and AIS source orchestration; several specialist capabilities are documented but their internal calls were not sampled, so those connections are limited to supported server imports or omitted.
Main entry points: server.py REST API · manager.py Source manager · base.py AIS source models · correlator.py News correlation
Components 31
AIS collection
- Stream runner
stream_area.py - Source manager
ais_sources/manager.py - AIS source models
ais_sources/base.py - AISStream
ais_sources/aisstream.py - AISHub
ais_sources/aishub.py - Marinesia
ais_sources/marinesia.py - GFW source
ais_sources/gfw.py - AIS ingestion
ais_ingest.py
Tracking API
- REST API
server.py - Vessel state
server.py
Vessel intelligence
- Vessel intelligence
vessel_intel.py - Weather enrichment
weather.py - Confidence scoring
confidence.py - Behavior detection
behavior.py - Intelligence reports
intelligence.py
OSINT analysis
- News sources
osint/sources - Entity extraction
osint/entities.py - Relevance scoring
osint/scoring.py - News correlation
osint/correlator.py - OSINT models
osint/models.py
Specialist monitoring
- SAR detections
sar_import.py - Satellite imagery
satellite_intel.py - Sanctions checks
sanctions.py - Dark fleet analysis
dark_fleet.py - Venezuela monitoring
venezuela.py - Infrastructure analysis
infra_analysis.py - Laden status
laden_status.py - Shoreside photos
shoreside_photos.py - GFW analysis
gfw_integration.py - Ports database
ports_database.py
Other components
- Analyst
Connections 33
- Analyst → REST API: uses API
- Stream runner → Source manager: starts sources
stream_area.py - Source manager → AIS source models: uses interface
ais_sources/manager.py - Source manager → AISStream: dispatches to
ais_sources/manager.py - Source manager → AISHub: dispatches to
ais_sources/manager.py - Source manager → Marinesia: dispatches to
ais_sources/manager.py - Source manager → GFW source: dispatches to
ais_sources/manager.py - AISStream → AIS source models: implements
ais_sources/aisstream.py - AISHub → AIS source models: implements
ais_sources/aishub.py - Marinesia → AIS source models: implements
ais_sources/marinesia.py - GFW source → AIS source models: implements
ais_sources/gfw.py - Analyst → Stream runner: starts stream
- REST API → Vessel state: reads and writes
server.py - REST API → Vessel intelligence: uses
server.py - REST API → Weather enrichment: uses
server.py - REST API → Confidence scoring: uses
server.py - REST API → Behavior detection: uses
server.py - REST API → Intelligence reports: uses
server.py - REST API → SAR detections: routes to
server.py - REST API → Satellite imagery: uses
server.py - REST API → Sanctions checks: uses
server.py - REST API → Dark fleet analysis: uses
server.py - REST API → Venezuela monitoring: uses
server.py - REST API → Infrastructure analysis: uses
server.py - REST API → Laden status: uses
server.py - REST API → Shoreside photos: uses
server.py - REST API → GFW analysis: uses
server.py - REST API → Ports database: uses
server.py - News correlation → Entity extraction: extracts entities
osint/correlator.py - News correlation → Relevance scoring: scores relevance
osint/correlator.py - Entity extraction → OSINT models: uses models
osint/entities.py - Relevance scoring → OSINT models: uses models
osint/scoring.py - News correlation → OSINT models: builds events
osint/correlator.py