Build A Local Intelligence Assistant With LLMs – Crucix

Crucix is a free, self-hosted open-source intelligence dashboard that aggregates 26 real-time public data feeds into a single browser-based interface.

It pulls satellite fire detections, live flight tracking, radiation monitoring, armed conflict events, economic indicators, market prices, sanctions data, and social sentiment, all updated every 15 minutes, all running on your own machine.

Pair it with an LLM, and it acts as a two-way intelligence assistant. It pushes tiered alerts to Telegram or Discord when conditions shift, responds to commands like /brief and /sweep from your phone, and generates trade ideas grounded in live cross-domain data.

Features

• Generates a Jarvis-style HUD with a D3 world map displaying 7 marker types: fire detections, air traffic, radiation sites, maritime chokepoints, SDR receivers, OSINT events, and health alerts.
• Queries all 26 sources in parallel and completes each sweep in approximately 30 seconds.
• Displays live market prices for SPY, QQQ, BTC, Gold, WTI, VIX, and 9 additional tickers via Yahoo Finance.
• Tracks risk gauges for VIX, high-yield spread, and the NY Fed Global Supply Chain Pressure Index.
• Aggregates English-language posts from 17 curated OSINT and conflict Telegram channels into a live feed.
• Delivers a merged news ticker from RSS, GDELT headlines, and Telegram posts with auto-scroll.
• Computes a sweep delta after each cycle that surfaces new signals, escalations, and de-escalations with severity scores.
• Correlates signals across satellite, economic, conflict, and social domains into a cross-source intelligence panel.
• Monitors real-time radiation readings from Safecast citizen-science sensors and EPA RadNet government stations.
• Supports six region filters (World, Americas, Europe, Middle East, Asia Pacific, Africa) with smooth map zoom.
• Sends multi-tier alerts (FLASH, PRIORITY, ROUTINE) to Telegram and Discord with semantic deduplication.
• Accepts two-way commands from Telegram and Discord bots.
• Generates AI trade ideas from an optional LLM layer supporting Anthropic Claude, OpenAI, Google Gemini, and OpenAI Codex.
• Falls back to a deterministic rule-based engine for alert evaluation when no LLM is configured.

Use Cases

• Monitor global conflict zones using merged satellite fire data and social media sentiment.
• Track supply chain disruptions through maritime vessel tracking and economic indicator updates.
• Generate quantitative trade ideas based on real-time commodity prices and geopolitical events.
• Receive instant Telegram alerts upon radiation level spikes near monitored nuclear facilities.
• Analyze military aircraft movements alongside breaking news reports in specific geographic regions.
• Correlate market movements with geopolitical events by viewing Yahoo Finance prices alongside OSINT feeds and conflict data.

Data Sources

Tier 1: Core OSINT & Geopolitical (11)

Tier 2: Economic & Financial (7)

Tier 3: Weather, Environment, Tech, Social, SIGINT (7)

Tier 4: Space & Satellites (1)

Tier 5: Live Market Data (1)

How to Use It

Quick Start (Local Installation)

git clone https://github.com/calesthio/Crucix.git
cd Crucix
npm install
cp .env.example .env

Edit the .env file to add your API keys (optional but recommended for full data). Then start the server:

npm run dev

The dashboard opens at http://localhost:3117. The first sweep takes 30–60 seconds to query all sources. After that, it auto-refreshes every 15 minutes.

If npm run dev exits silently, run Node directly to see errors:

node --trace-warnings server.mjs

Or run the diagnostic script:

node diag.mjs

Docker Setup

git clone https://github.com/calesthio/Crucix.git
cd Crucix
cp .env.example .env
# Add your API keys to .env
docker compose up -d

The dashboard runs at http://localhost:3117. Sweep data persists in ./runs/ via volume mount.

Required API Keys (Free, Recommended)

Optional API Keys

LLM Provider Configuration (Optional)

Set LLM_PROVIDER in .env to one of these values:

For Codex, run npx @openai/codex login to authenticate via your ChatGPT subscription.

Telegram Bot Setup

The bot responds to these commands from your configured chat ID:

Discord Bot Setup

Install the Discord dependency:

npm install discord.js

The bot supports these slash commands:

Alerts appear as rich embeds with color-coded sidebars: red for FLASH, yellow for PRIORITY, blue for ROUTINE.

Environment Variables Reference

npm Scripts

API Endpoints (When Running)

Pros

• Runs entirely locally with no cloud dependencies or subscription fees.
• Updates every 15 minutes automatically with parallel queries to all sources.
• Works with zero API keys out of the box for 18+ sources.
• Includes both Telegram and Discord integrations with two-way command support.
• Provides delta tracking so you see exactly what changed between sweeps.
• Each source module runs standalone for easy testing and debugging.

Cons

• Initial setup requires Node.js 22+ and some comfort with the command line.
• The three most valuable free keys (FRED, FIRMS, EIA) require separate registration.
• Military flight tracking via ADS-B Exchange requires a paid RapidAPI subscription.

Related Resources

• CelesTrak: The source for satellite tracking data used in Crucix.
• GDELT Project: The global news event database that powers the conflict monitoring.
• Safecast: The citizen-science radiation monitoring network integrated into the dashboard.
• NASA FIRMS: The satellite fire detection system that provides thermal anomaly data.
• FRED Economic Data: The Federal Reserve database supplying 22 economic indicators.
• Node.js Official Site: Download the required runtime environment for the server.
• Docker Documentation: Learn containerization basics for the alternative setup method.
• Discord Developer Portal: Create bot tokens for the notification system.
• Federal Reserve Economic Data: Register for a free API key to access economic indicators.

FAQs

Q: What happens if I don’t add any API keys?
A: Crucix still runs and pulls data from the 18+ sources that require no authentication. Sources that need keys return structured errors, and the rest of the sweep continues normally.

Q: Can I run this on a Raspberry Pi or low-power server?
A: Yes. The tool has minimal dependencies (just Express) and runs fine on low-power hardware. The Docker image makes deployment straightforward.

Q: How do I add more Telegram channels to monitor?
A: Add them to the TELEGRAM_CHANNELS variable in your .env file as a comma-separated list of channel IDs. The bot will include them in its monitoring.

Q: Does Crucix send my data anywhere?
A: No. There’s no telemetry, no cloud sync, and no external calls except to the 27 data sources you configure. Everything stays on your machine in the ./runs/ directory.

Q: Why does the dashboard show empty panels on first start?
A: The first sweep takes 30–60 seconds to query all sources in parallel. The dashboard populates automatically once the sweep completes. Check the terminal for progress logs.

Q: Can I use this for trading?
A: The dashboard includes Yahoo Finance data and economic indicators. It’s not financial advice, but the data is there if you want to correlate events with markets.

Q: What’s the difference between the Telegram bot and Discord integration?
A: Both provide alerts and respond to commands. Telegram uses a simple text interface. Discord supports rich embeds with color-coded alerts and native slash commands. You can run both simultaneously or just one.