Skip to content
Get packs

Guide · Open source

How to use Osiris: clone, test and explore the map dashboard

Updated · written with AI from the project's own documentation and checked against our catalogue data

Osiris is an open-source, web-based map dashboard that puts many public data feeds, such as flight tracking, earthquake alerts, fire hotspots, traffic cameras and news streams, onto one interface. It is built with Next.js and MapLibre GL, and it is released under the MIT licence. This guide shows you how to try the hosted demo, clone and test the code, and understand what the main panels and layers do, so you can judge whether it fits your project.

OSIRISsimplifaisoul/osiris · ★ 11.5k · MIT

Quick start

  1. 1Check prerequisites. Make sure Node.js and npm are installed on your computer.
  2. 2Try the demo. Open the hosted demo at osirisai.live to see the layers before installing anything.
  3. 3Clone the repository. Run git clone https://github.com/simplifaisoul/osiris to download the source code.
  4. 4Read the README build steps. The excerpt does not list build or start commands, so follow the full repository README for those.
  5. 5Run the tests. Run npm test to execute the offline checks after installation.

What Osiris is and who it is for

Osiris draws live and near-live public data on a globe. The README describes it as a real-time global intelligence dashboard that aggregates flight tracking, CCTV networks, earthquake monitoring, conflict zone mapping and news feeds into a single interface.

It suits people who want to see how a live open-data map dashboard is built, developers who work with Next.js and MapLibre GL, and researchers who want to see which public sources can be combined on one map. It is not a source of verified intelligence: the README describes many third-party feeds and does not discuss accuracy or validation.

  • Good fit: studying map dashboard architecture, learning Next.js and MapLibre GL, comparing public data sources
  • Poor fit: anything that needs verified facts, a fully offline tool (most layers call external APIs), or a polished packaged download (the latest release has no binaries)

Try the hosted demo first

The quickest way to see Osiris is the hosted demo linked from the project homepage at osirisai.live. Nothing needs to be installed. The README also links a live demo at a different address, osirislive.app, so if one link does not load, try the other.

The screenshots in the README show the main views: traffic-camera previews over a city, live CCTV in 3D terrain, and a Save an Area tool that finds every camera inside a drawn region and lets you export it as GeoJSON.

  • Open the demo and pan or zoom the globe to see the data layers
  • Draw an area to find the cameras inside it, then export the result as GeoJSON

Install Osiris from source

Osiris is installed by cloning the repository. The prerequisites listed for it are Node.js and npm. Clone the code with the command below.

The README excerpt does not give the install or run commands beyond the tests, so check the repository README for the full build and start steps before you begin.

  • Install Node.js and npm on your machine
  • Clone the repository with the command shown here
git clone https://github.com/simplifaisoul/osiris

Run the offline tests

After installing, run the offline test suite with npm test. These checks run without a network connection to the data providers.

To check the public Texas CCTV inventory against the live source, the README gives a separate command that calls the live TxDOT data. Because it uses the network, it is optional.

npm test

Understand the layers and the RECON toolkit

The README says Osiris has 16 toggleable data layers, each with real-time entity counts. Layers are fetched on demand when they are switched on and only for the visible region. Sources named in the README include OpenSky Network for aviation, USGS for earthquakes, NASA FIRMS for fires, and NASA EONET for severe weather.

The RECON toolkit adds lookups including a port scanner, DNS lookup, WHOIS, SSL/TLS inspector, IP intelligence, vulnerability scanner against the NVD database, crypto wallet trace for BTC and ETH, and an OFAC sanctions search. WHOIS and IP lookups are automatically cross-checked against the OFAC SDN list.

  • Aviation: OpenSky Network
  • Seismic: USGS Earthquake API, real-time M2.5+
  • Fires: NASA FIRMS hotspots
  • Weather: NASA EONET severe events
  • Sanctions: OpenSanctions, US OFAC SDN mirror

Use the OI assistant and Forecast features

OI Assist lets you type or speak a question to the map, and it can move the view, switch on layers and list matching live items. OI Forecast is a prediction feature that researches a question from sources and runs simulated scenarios. Both need your own model API key from a supported provider. The README says the key is kept in your browser, sent per request and never stored on the server.

Osiris also exposes a REST API under /api/oi and an MCP server at /api/mcp. The README links to the docs at osirisai.live/docs.

  • Supported key providers listed: OpenAI, Anthropic, Google Gemini, OpenRouter, Groq, DeepSeek, xAI, Mistral, Qwen
  • Telegram OSINT layer reads public channels through the t.me/s/ web preview, with no Bot API token needed

What people use it for

  • Studying how a MapLibre GL map dashboard is structured with Next.js API routes
  • Comparing which public data feeds, such as flights, quakes and fires, can share one map
  • Drawing a region and exporting the cameras inside it as GeoJSON
  • Learning how sanctions and WHOIS lookups can be cross-checked in one tool

Frequently asked questions

Is Osiris free and open source?

Yes. The repository is listed under the MIT licence, and the source is on GitHub at simplifaisoul/osiris. The README also links a Patreon page for supporting the project.

What do I need to install Osiris?

The install method is clone-and-build, with Node.js and npm as the listed prerequisites. Clone the repository from GitHub and run npm test to check the install.

Is there a downloadable app for Osiris?

No. The README states the latest release has no binaries, so you need to clone the source and build it yourself. The hosted demo at osirisai.live is the simplest way to try it without installing.

Does Osiris work offline?

Not fully. Most layers call external APIs such as OpenSky, USGS and NASA, so they need an internet connection. The npm test suite is offline, but the data layers are not.

Is the data in Osiris verified?

The README does not discuss accuracy or validation. It describes data pulled from many third-party feeds, so check important information against the original source before relying on it.

What are alternatives to Osiris?

The project lists Kepler.gl, Grafana, Leaflet and OpenStreetMap-based map tools as comparable projects. Those are general mapping or dashboard tools rather than a packaged set of public intelligence feeds.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Osiris is worth exploring if you want to study a real-time, open-data map dashboard built with Next.js and MapLibre GL, or see which public feeds can share one map. Pick something else if you need verified intelligence, an offline tool, or a ready-made download, since the README makes none of those promises.

Install options & downloads