About This Project

GulfStraitsAI

Open-source maritime risk intelligence for the Gulf and Strait regions.

What It Is

GulfStraitsAI aggregates maritime security data across five critical chokepoints: the Strait of Hormuz, Bab-el-Mandeb, Persian Gulf, Red Sea, and Gulf of Oman.

Data is pulled every 15 minutes from authoritative sources — including official US Navy / NGA maritime advisories (ASAMs), newswires, and specialist maritime publications. AI is used to extract structured data (entities, location, event type) from unstructured text, not to generate analysis.

This is an informational aggregation tool. Data reflects public sources only and does not constitute operational intelligence guidance.

Technology

IngestionCloudflare Workers (Python) · Cron every 15 min

StorageCloudflare D1 (SQLite) · Cloudflare Vectorize

EmbeddingGemini text-embedding-004 · 768-dim · cosine similarity

DeduplicationVector similarity threshold 0.92 — cross-source dedup

ClassificationGemini Flash — entity extraction, location tagging, event type

Similar incidentsVectorize ANN search — surfaces contextually related past events

FrontendNext.js · Tailwind CSS · Cloudflare Pages

APIREST · MCP (Model Context Protocol) · JSON-RPC 2.0

API Access

GET https://gulfstraitsai.sxg.workers.dev/api/risk

GET .../api/risk/:region

GET .../api/risk/:region/history?hours=48

GET .../api/events?region=&limit=20

POST .../mcp — MCP JSON-RPC 2.0

No API key required. Rate limiting may apply.

Support This Project

GulfStraitsAI runs entirely on free-tier services.

Donations directly fund expanded data sources (full-text news access, satellite AIS coverage, higher update frequency) and keep the service running.

☕ Support on Ko-fi

Any amount helps. Ko-fi takes 0% platform fee on one-time donations.

Open source · MIT License

GitHub →

← Back to Dashboard