explaingit

owlinkai/redroom

Analysis updated 2026-05-18

59TypeScriptAudience · researcherComplexity · 4/5LicenseSetup · hard

TLDR

An open-source open-source-intelligence platform that crawls global news, scores sentiment and threat level, and shows the results on dashboards and a 3D globe.

Mindmap

mindmap
  root((redroom))
    What it is
      OSINT platform
      News monitoring
    Views
      Live dashboard
      3D globe
      Satellite tracker
      Narrative engine
    Backend
      RSS crawlers
      MySQL or TiDB
      AI classification
    Setup
      Node.js
      API keys
      Role based access

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monitor global news for threat indicators and coordinated disinformation campaigns.

USE CASE 2

Explore geopolitical events by region using an interactive 3D globe dashboard.

USE CASE 3

Run scheduled crawl missions against specific regions, topics, or news source types.

USE CASE 4

Track satellite positions alongside news-derived intelligence signals.

What is it built with?

TypeScriptNode.jsMySQLTiDB

How does it compare?

owlinkai/redroomjlevy/tbdqelos-io/testai
Stars595959
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderateeasy
Complexity4/52/52/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Node.js, a MySQL or TiDB database, and several third-party API keys before it runs.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Redroom is an open-source platform for monitoring global news and events, aimed at geopolitical analysts, researchers, and intelligence professionals. It collects articles from hundreds of news agencies worldwide through automated RSS crawlers, processes them to assign sentiment scores and threat classifications, and displays the results through a set of analytical views, all built on publicly available information rather than classified sources. The main dashboard gives users a live stream of incoming articles tagged by region and category. There is also an interactive 3D globe where you can click on regions to see associated intelligence indicators and threat levels. Other views include a satellite orbit tracker showing real-time positions of reconnaissance and communication satellites, a signals intelligence summary screen, and a narrative engine that uses AI to detect coordinated information campaigns across sources. Behind the scenes, the platform stores everything in a MySQL or TiDB database. Crawl missions are configurable: administrators can schedule jobs targeting specific regions, topics, or source types, and manage them through a built-in content management panel. Access is role-based, with separate analyst and admin roles, and there is a waiting list workflow for new users requesting access. Setting it up requires Node.js, a compatible database, and several API keys defined in an environment file. These include keys for an AI language model service (used for article classification and narrative detection), an OAuth provider for user login, and an AIS vessel tracking API. The README covers the setup steps and environment variable reference in detail. A live version of the platform runs at redroom.live, operated by Owlink.ai. The code is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up the environment variables and API keys needed to run this Redroom instance.
Prompt 2
Explain how the RSS crawlers and sentiment classification pipeline work in this codebase.
Prompt 3
Help me configure a new crawl mission targeting a specific region and topic.
Prompt 4
Show me how the role-based access control between analyst and admin roles is implemented.

Frequently asked questions

What is redroom?

An open-source open-source-intelligence platform that crawls global news, scores sentiment and threat level, and shows the results on dashboards and a 3D globe.

What language is redroom written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MySQL.

What license does redroom use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is redroom to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is redroom for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.