Skip to content

eli-labz/Third-Eye

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

19 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

⬑ THIRD EYE

Open-Source Global Intelligence & Reconnaissance Platform

third-eye

Next.js TypeScript MapLibre License Stars Forks Issues

A real-time global intelligence dashboard that aggregates live flight tracking, CCTV networks, earthquake monitoring, conflict zone mapping, and 24/7 news feeds into a single GPU-accelerated interface.

🌐 Live Demo Β· πŸ› Report Bug Β· ✨ Request Feature Β· ⭐ Star This Repo

If Third Eye is useful to you, please consider giving it a ⭐ β€” it helps the project grow and reach more people!


πŸ” Overview

Third Eye is a production-grade OSINT platform that provides real-time situational awareness across 13+ intelligence domains β€” all in one GPU-accelerated interface. Built with Next.js 16 and MapLibre GL, every data point is rendered via WebGL for 60fps performance even with thousands of concurrent entities on-screen.

No API keys required to get started. Clone, run, and you're live in under 2 minutes.


✨ Why Third Eye?

  • 🌍 16 live data layers β€” aviation, maritime, CCTV, seismic, fires, news, weather, space, cyber, conflict, crypto, sanctions, and more
  • ⚑ WebGL-powered β€” GPU-accelerated map rendering, not DOM-based. Handles thousands of entities at 60fps.
  • πŸ”‘ Zero-key startup β€” all core layers work out of the box with public, keyless APIs
  • 🐳 Docker-ready β€” single-command self-hosting with prebuilt GHCR image
  • 🧰 Built-in RECON toolkit β€” port scanner, DNS lookup, WHOIS, SSL inspector, IP intelligence, CVE scanner, crypto wallet tracer, and OFAC sanctions search
  • πŸ“‘ Telegram OSINT β€” geoparsed public channel posts plotted on the map in real time
  • πŸ’° Crypto intelligence β€” BTC + ETH wallet tracing with live OFAC SDN sanctions cross-check
  • 🏠 Self-hostable β€” CasaOS one-click install supported

πŸ—ΊοΈ Intelligence Domains

Domain Data Points Sources
✈️ Aviation Commercial, Private, Military, Jets OpenSky Network
🚒 Maritime 39 Global Ports, 10 Chokepoints Static Naval Intel
πŸ“· CCTV 2,000+ Cameras TfL, WSDOT, Caltrans, NYC DOT, VicRoads + more
πŸŒ‹ Seismic Real-time M2.5+ USGS Earthquake API
πŸ”₯ Fires Active Hotspots NASA FIRMS
πŸ“Ί News 24/7 Live Streams 25+ Global Broadcasters
πŸŒͺ️ Weather Severe Events NASA EONET
πŸ›°οΈ Space Solar Weather, Satellites NOAA SWPC, N2YO
πŸ›‘οΈ Cyber CVE Threats, Vulnerability Scanning NVD, Custom Scanner
βš”οΈ Conflict 13 Active Zones Static OSINT Intel
πŸ’° Crypto BTC + ETH Wallet Tracing, OFAC SDN Match blockstream.info, Blockscout, OpenSanctions
🚫 Sanctions Person / Org / Vessel SDN Search OpenSanctions (US OFAC SDN mirror)
πŸ“± Telegram OSINT Geoparsed Posts from Public Channels t.me/s/ web preview

πŸ—οΈ Architecture

third-eye-workflow

πŸš€ Quick Start

Option 1 β€” npm (2 minutes)

git clone https://github.com/eli-labz/Third-Eye.git
cd Third-Eye
npm install
npm run dev

Open http://localhost:3000 β€” done. No API keys needed.

Option 2 β€” Docker

git clone https://github.com/eli-labz/Third-Eye.git
cd Third-Eye
cp .env.template .env   # optional β€” configure keys / port
docker compose up -d

Option 3 β€” Prebuilt Image (fastest)

docker pull ghcr.io/aiacos/third-eye:latest
docker run -d -p 3000:3000 --env-file .env ghcr.io/aiacos/third-eye:latest

πŸ’‘ Custom port: Set THIRDEYE_PORT in .env to change the published host port without editing the compose file.


βš™οΈ Configuration

Third Eye works without any API keys β€” all core layers use public, keyless sources. Copy .env.template to .env and configure only what you need:

# Published host port (container always listens on 3000). Default: 3000
THIRDEYE_PORT=3000

# RECON scanner backend β€” generate key with: openssl rand -hex 32
SCANNER_URL=
SCANNER_KEY=

# Optional β€” for higher rate limits
FIRMS_API_KEY=         # NASA FIRMS
OPENSKY_CLIENT_ID=     # OpenSky OAuth2
OPENSKY_CLIENT_SECRET=
N2YO_API_KEY=          # N2YO satellites
AIS_API_KEY=           # aisstream.io maritime

Without SCANNER_URL/SCANNER_KEY the RECON toolkit returns 503; every other layer works out of the box.


πŸ› οΈ Features In Depth

Intelligence Layers

  • 16 toggleable data layers with real-time entity counts
  • GPU-accelerated rendering β€” all map data rendered via WebGL, not DOM
  • Progressive loading β€” data fetched on-demand when layers are activated
  • Viewport-aware β€” only loads relevant data for the visible region

RECON Toolkit

  • Port Scanner β€” TCP connect scan with service fingerprinting
  • DNS Lookup β€” Full record resolution (A, AAAA, MX, NS, TXT, CNAME)
  • WHOIS β€” Domain/IP registration data (auto-cross-checked against OFAC SDN)
  • SSL/TLS Inspector β€” Certificate chain analysis
  • IP Intelligence β€” Geolocation, ASN, threat reputation (auto-cross-checked against OFAC SDN)
  • Vulnerability Scanner β€” CVE lookup against NVD database
  • Crypto Wallet Trace β€” BTC + ETH lookup (balance, tx history, OFAC SDN sanctions flag)
  • OFAC Sanctions Search β€” Full-text search across persons, organizations, vessels, and aircraft

Live Broadcast Network

  • 25+ live 24/7 news streams from global broadcasters
  • Click any news dot on the map to open the live stream
  • Feeds from NBC, CBS, ABC, Sky News, Al Jazeera, France 24, NHK, WION, and more

Telegram OSINT Layer

  • Public-channel feed scraped from the unauthenticated web preview β€” no Bot API token, no MTProto
  • Overridable channel list via THIRDEYE_TELEGRAM_CHANNELS
  • Posts geoparsed against a multilingual place dictionary (EN + Cyrillic + Arabic) and plotted on the map

Crypto Wallet Intelligence

  • BTC via blockstream.info (Esplora API, keyless)
  • ETH via Blockscout's public ETH instance (keyless)
  • Every lookup auto-cross-checked against the OFAC SDN sanctioned-address list
  • Sanctioned wallets surface a red SANCTIONED β€” OFAC SDN badge

Conflict Zone Monitoring

  • 13 active conflict/tension zones with severity-coded markers
  • Active Wars: Ukraine, Gaza, Sudan, Myanmar, DRC, Yemen
  • High Tension: Syria, Lebanon, Sahel, Somalia, Red Sea
  • Elevated: Taiwan Strait, Korean DMZ

Performance

  • 75% reduction in edge requests vs initial release
  • Aggressive polling relaxation (15-30 min intervals for stable data)
  • Static data served from memory β€” zero external API calls for news feeds

πŸ–₯️ Tech Stack

Layer Technology
Framework Next.js 16 (App Router, Turbopack)
Language TypeScript 5
Map Engine MapLibre GL JS (WebGL)
Animations Framer Motion
Icons Lucide React
Styling Custom CSS Design System
Deployment Vercel Edge Network

⌨️ Keyboard Shortcuts

Key Action
F Toggle flight layers
E Toggle earthquakes
S Toggle satellites
D Toggle day/night cycle
Escape Close panels

🧠 Smart System (optional, off by default)

Smart_System_Visual_Diagram

An optional, feature-flagged, human-in-the-loop data-fusion module that layers an analyst workflow over the platform's existing live feeds:

Ingestion β†’ Ontology β†’ Advisory AI models β†’ Human review β†’ Audit

It is decision-support only β€” nothing autonomous, kinetic, or real-world. It ingests the platform's real feeds (flights, maritime, satellites, earthquakes, GDELT, news), normalizes them into canonical entities, runs explainable advisory models (object-detection summary, track-anomaly detection, report summarization, course-of-action generation, risk scoring), and routes every recommendation into a human approve / reject / request-changes queue with a full audit trail.

Completely invisible unless enabled:

ENABLE_MSS_SMART_SYSTEM_MODULE=true      # adds a "Smart System" panel + /api/smart-system/*
SMART_SYSTEM_RUN_KEY=<random-secret>     # (recommended) guards the heavy /run endpoint
KV_REST_API_URL=...                      # (optional) Vercel KV / Upstash β†’ state persists
KV_REST_API_TOKEN=...                    #             across serverless requests

When off, the GUI, routes and workflows are unchanged. Full architecture, API reference, and safety notes: docs/SMART_SYSTEM.md. Run its test suite with npm test.


🀝 Contributing

Contributions are what make the open-source community amazing. Any contributions you make are greatly appreciated.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ—ΊοΈ Roadmap

  • WebSocket-based live flight position updates
  • User-configurable Telegram channel watchlist (UI)
  • Dark/light map theme toggle
  • Export layer data as GeoJSON / CSV
  • Historical playback mode
  • Mobile-responsive layout

Have an idea? Open a feature request!


πŸ“„ License

Distributed under the MIT License. See LICENSE for more information.


Built with ❀️ by eli-labz

⭐ If you find Third Eye useful, please star the repo β€” it helps others discover it! ⭐

Star History Chart

About

A production-grade OSINT platform that provides situational awareness across multiple intelligence domains.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors