osiris README

The project's README from github.com/simplifaisoul/osiris. As one markdown file: README.md.

⬡ OSIRIS

Open Source Intelligence & Reconnaissance Integrated System

Live Demo Support OSIRIS Next.js TypeScript MapLibre License

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 · Join Discord


Overview

Osiris is a production-grade OSINT platform that provides situational awareness across multiple intelligence domains. 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.

Key Capabilities

Domain Data Points Sources
Aviation Commercial, Private, Military, Jets OpenSky Network
Maritime 39 Global Ports, 10 Chokepoints Static Naval Intel
CCTV 17,000+ Cameras TfL, WSDOT, Caltrans, ODOT, MDOT, HK Transport Dept, Taiwan THB, NZTA + 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/<channel> web preview

Architecture

┌─────────────────────────────────────────────────┐
│                  OSIRIS CLIENT                   │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐ │
│  │ MapLibre  │  │  HUD     │  │  RECON Toolkit│ │
│  │  GL (GPU) │  │ Panels   │  │  Port Scan    │ │
│  │  WebGL    │  │ Layers   │  │  DNS / WHOIS  │ │
│  │  Render   │  │ Controls │  │  Vuln Scanner │ │
│  └──────────┘  └──────────┘  └───────────────┘ │
├─────────────────────────────────────────────────┤
│               NEXT.JS API ROUTES                 │
│  /api/flights         /api/earthquakes          │
│  /api/cctv            /api/news                 │
│  /api/fires           /api/maritime             │
│  /api/gdelt           /api/satellites           │
│  /api/weather         /api/scanner              │
│  /api/sentinel        /api/telegram-feed        │
│  /api/osint/*  (whois, dns, ip, cve, sanctions, │
│                 crypto, sweep, threats, …)      │
├─────────────────────────────────────────────────┤
│              EXTERNAL DATA SOURCES               │
│  OpenSky · USGS · NASA · NOAA · TfL · NVD      │
│  GDACS · EONET · FIRMS · N2YO · RSS Feeds      │
│  blockstream.info · Blockscout · OpenSanctions  │
│  t.me public previews                            │
└─────────────────────────────────────────────────┘

Features

Intelligence Layers

RECON Toolkit

Live Broadcast Network

Telegram OSINT Layer

Crypto Wallet Intelligence

OFAC SDN Cross-Check

Conflict Zone Monitoring

Performance Optimized


Quick Start

git clone https://github.com/simplifaisoul/osiris.git
cd osiris
npm install
npm run dev

Open http://localhost:3000

Docker / Self-Hosting

git clone https://github.com/simplifaisoul/osiris.git
cd osiris
cp .env.template .env     # optional — configure keys / port
docker compose up -d

Open http://localhost:3000. The image is a multi-stage node:22-alpine standalone build (~220 MB, non-root). The compose file also carries CasaOS app metadata (x-casaos:) for one-click install on CasaOS. See DOCKER.md for the full Docker, CasaOS and API-key guide.

Prebuilt image (GHCR) — skip the build and pull it directly:

docker pull ghcr.io/simplifaisoul/osiris:latest
docker run -d -p 3000:3000 --env-file .env ghcr.io/simplifaisoul/osiris:latest

Custom port — the container always listens on 3000; set OSIRIS_PORT in .env to change the published host port (e.g. OSIRIS_PORT=3005) without editing the compose file.

Environment Variables

OSIRIS works partially without any API keys — all core feeds use public, keyless sources. Copy .env.template to .env and set only what you need:

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

# RECON scanner backend (the only vars the current code reads).
# SCANNER_KEY must match the backend's OSIRIS_KEY — generate with: openssl rand -hex 32
SCANNER_URL=
SCANNER_KEY=

# Optional, for higher rate limits / future sources (see DOCKER.md for signup links)
FIRMS_API_KEY=                # NASA FIRMS  — firms.modaps.eosdis.nasa.gov/api/map_key/
OPENSKY_CLIENT_ID=            # OpenSky OAuth2 (since Mar 2025) — opensky-network.org
OPENSKY_CLIENT_SECRET=
N2YO_API_KEY=                 # N2YO satellites — n2yo.com (Profile → API key)
AIS_API_KEY=                 # aisstream.io maritime

Without SCANNER_URL/SCANNER_KEY the RECON toolkit returns 503; every other layer works out of the box. .env is gitignored — only the template is committed.


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

License

MIT — see LICENSE for details.


🛠️ SUPPORT THE OSIRIS PROJECT The OSIRIS Global Intelligence Grid is entirely open-source, but running the backend scanners and data firehoses isn't cheap.

If you want to help keep the servers alive, and support us to get access to better tools unlock the Special OSIRIS Console, Currently Just a Cool UI. a you can officially support the project here :

🔗 Support OSIRIS on Patreon

Supporters receive the 🔴 RedTeam Console role and access to encrypted developer comms.

Built by simplifaisoul

Join our Discord to be a part of this movement!

osiris (simplifaisoul/osiris)

Searching Database…

11.1K ·GitHub
What is this?OSIRIS is an open-source, real-time global intelligence (OSINT) dashboard. It aggregates live flight tracking, 17,000+ CCTV cameras, earthquakes, conflict zones, crypto tracing and 24/7 news streams onto a single WebGL map.
Is this a hosted service I sign up for, or something I run myself?You run it yourself — it is a self-hostable Next.js 16 web app. There is a prebuilt ~220 MB Docker image on GHCR, a compose file with CasaOS one-click metadata, and Vercel is the suggested deployment target.
How do I get it running?Skip the build and pull the prebuilt image from GHCR via the included docker compose file. Copy .env.template to .env and set only what you need; the container always listens on port 3000, and you can remap the published port via OSIRIS_PORT without editing the compose file.
Do I need API keys for all these data feeds?No — all core feeds use public, keyless sources. The only gap is the RECON toolkit: without SCANNER_URL and SCANNER_KEY it returns 503, while every other layer works out of the box.
Is there a live demo before I self-host it?Yes — the README links a Live Demo at the top, so you can explore the dashboard before pulling the Docker image. The stack also deploys to Vercel Edge if you would rather not self-host.
What keyboard shortcuts does the dashboard have?F toggles the flight layers, E toggles earthquakes, S toggles satellites, D switches the day/night cycle, and Escape closes panels.
Which CCTV feeds does it pull from?Over 17,000 cameras from public transport agencies: TfL in London, WSDOT, Caltrans, ODOT and MDOT in the US, Hong Kong's Transport Department, Taiwan's THB and New Zealand's NZTA, among others.
How is the project funded, and what do patrons get?Through Patreon. Supporters receive the RedTeam Console Discord role and access to the Special OSIRIS Console — which the README candidly notes is currently just a cool UI.
Size
9.9 MB
Stars
11.1K
Age
5mo
Commits · 90 Days