A real-time open-source intelligence console, wearing Samaritan's face.

Live aircraft, vessels, satellites, earthquakes and public cameras on a photorealistic 3D globe — plus a photograph you can hand to an AI and ask where was this taken?

---

---

What this is

A personal fork of God's Eye View by Bilawal Sidhu — the spy-satellite simulator whose data happens to be real. Everything that project does, this does. On top of it:

🔴 Samaritan interface	The word-by-word display from Person of Interest — blinking red marker, expanding rule, ambient phrases
🎨 Red-on-black skin	The full HUD restyled, generated from upstream's stylesheet rather than forked from it
📍 GEOINT	Drop in a photo → AI estimates where it was taken → the globe flies there

Built for learning geospatial intelligence tradecraft on entirely public signals. No private feeds, no scraping, no classified anything.

---

Quick start

Requires Node 24.14.x or 26.x (enforced by package.json — Node 25 will be rejected).

git clone https://github.com/likalight/samaritan
cd samaritan
npm install
cp .env.example .env          # add your keys, see below
npm run dev -- --host localhost --port 4173

Open http://localhost:4173.

It runs with zero keys — flights, satellites, earthquakes, CCTV, radio and the bundled datasets all work unauthenticated. The globe stays non-photorealistic until you add a Google Maps key.

---

Keys

🟢 no signup · 🟡 free key · 🔴 metered

	Key	Unlocks	Where
🔴	GOOGLE_MAPS_API_KEY	The photorealistic 3D planet	Cloud Console → enable Map Tiles API
🔴	GEMINI_API_KEY	GEOINT photo geolocation	aistudio.google.com/apikey
🔴	OPENAI_API_KEY	Voice control + AI HUD summary	platform.openai.com
🟡	AISSTREAM_API_KEY	Live global ships	aisstream.io
🟡	FIRMS_MAP_KEY	Live active fires	NASA FIRMS
🟡	TOMTOM_API_KEY	Real traffic instead of simulated	developer.tomtom.com
🟡	CESIUM_ION_TOKEN	Bing imagery stacks	cesium.com/ion

Warning

Restrict every metered key, and set a provider-side budget. GOOGLE_MAPS_API_KEY and CESIUM_ION_TOKEN are injected into the browser bundle by design and are visible in devtools — restrict them by HTTP referrer and API rather than trying to hide them. Every other key stays server-side. The app's rate limits are guards, not billing caps.

Google 3D tiles bill per root tileset request — one buys up to three hours of rendering, and the first 1,000 a month are free, so solo use rarely leaves the free tier. Gemini ships with a 50/day cap and a 6/min per-IP throttle here.

---

The two additions, in detail

GEOINT — where was this taken?

Click GEOINT, drop a photograph, optionally add context or your own guess, hit ANALYSE. You get coordinates, a named place, a confidence band, the model's reasoning, up to three alternatives, and a FLY THERE button.

The model weighs architecture, signage and script, which side of the road traffic uses, vegetation, terrain, plates, utility hardware and sun angle.

GET  /api/geoint/status   -> { hasKey, model, used, budget }
POST /api/geoint/locate   -> { lat, lon, place, confidence, reasoning, alternatives }

Images are downscaled to 1600px in the browser before upload — vision models bill by tokens, and a phone photo is far larger than the task needs.

The skin, and why it is generated

Upstream paints its HUD with roughly a hundred hardcoded cyan literals rather than its --accent variable, so redefining the variable only recolours part of the interface. Hand-writing overrides for every selector would be unmaintainable — and editing style.css directly would conflict with every upstream change.

So scripts/samaritan-theme.mjs walks style.css, finds every rule painting in the cyan/blue band, and re-emits that selector scoped to html[data-skin="samaritan"] with the hue rotated into red — 302 rules, @media wrappers preserved, upstream's stylesheet never touched.

npm run theme:samaritan    # re-derive after pulling upstream

Flip back to the original theme at any time:

delete document.documentElement.dataset.skin;

---

Staying current with upstream

The fork is deliberately additive — upstream files carry only three small edits (a few tags in index.html, one plugin in vite.config.js, an appended .env.example block). Everything else lives in src/samaritan/.

git remote add upstream https://github.com/bilawalsidhu/gods-eye-view.git
git fetch upstream && git merge upstream/main
npm run theme:samaritan

---

Credits and terms

Important

This repository is MIT — except for the parts that are not. Read NOTICE.md before copying anything out of it.

Project	Author	Terms
God's Eye View	Bilawal Sidhu	MIT — code only, some bundled datasets are NonCommercial
Samaritan interface	Rodrigo Graça	⚠️ No licence — all rights reserved. Used here with the author's permission
GeoIntel	atiilla	MIT — reimplemented, not vendored

On the Samaritan interface: that project publishes no licence, which under copyright means all rights reserved. The files in public/samaritan/vendor/ are included with the author's permission granted to this fork's owner. That permission is not a licence, does not transfer with the code, and does not extend to anyone cloning this repository. Want to use it? Ask Rodrigo Graça, or ask him to add a licence upstream.

Person of Interest and "Samaritan" are trademarks of Warner Bros. This is a non-commercial homage, unaffiliated and unendorsed.

---

Where the line is

Upstream models events, assets, infrastructure and systems — aircraft, vessels, satellites, fires, cameras, cities — and does not build features for named-person search, face recognition, or tracking individuals. This fork keeps that line. The GEOINT prompt explicitly instructs the model to identify places, not people, and not to describe or speculate about anyone appearing in an image.

Caution

Data here may be delayed, incomplete, modeled, inferred, or simply wrong. Do not use it for navigation, emergency response, or any safety-critical or operational purpose. Verify against authoritative sources.

---

_{MIT where it applies · see NOTICE.md for everything else}