crucix-intelligence-dashboard

$27

Docker:

cp .env.example .env

docker compose up -d

# sweep data persists in ./runs/ via volume mount

Requirements: Node.js 22+ (uses native fetch, top-level await, ESM modules)

**If npm run dev exits silently:**

node --trace-warnings server.mjs   # bypasses npm script runner (useful on Windows PowerShell)

node diag.mjs                       # diagnoses Node version, module imports, port availability

Environment Configuration ( .env )

# ── Core Free APIs (highly recommended) ──────────────────────────────────────

FRED_API_KEY=           # Federal Reserve economic data — fred.stlouisfed.org

FIRMS_MAP_KEY=          # NASA satellite fire detection — firms.modaps.eosdis.nasa.gov

EIA_API_KEY=            # US Energy Info Admin — eia.gov/opendata/register.php

# ── Optional Data Sources ─────────────────────────────────────────────────────

ACLED_EMAIL=            # Armed conflict data — acleddata.com/register

ACLED_PASSWORD=

AISSTREAM_API_KEY=      # Maritime vessel tracking — aisstream.io (free)

ADSB_API_KEY=           # Unfiltered flight tracking — RapidAPI (~$10/mo)

# ── LLM Provider (pick one) ───────────────────────────────────────────────────

LLM_PROVIDER=           # anthropic | openai | gemini | codex

LLM_API_KEY=            # not needed for codex (uses ~/.codex/auth.json)

# ── Telegram Bot ─────────────────────────────────────────────────────────────

TELEGRAM_BOT_TOKEN=     # from @BotFather

TELEGRAM_CHAT_ID=       # from @userinfobot

TELEGRAM_CHANNELS=      # optional: extra channel IDs beyond 17 built-in

TELEGRAM_POLL_INTERVAL= # ms between command polls, default 5000

# ── Discord Bot ───────────────────────────────────────────────────────────────

DISCORD_BOT_TOKEN=      # Discord Developer Portal → Bot → Token

DISCORD_CHANNEL_ID=     # right-click channel → Copy Channel ID

DISCORD_GUILD_ID=       # optional: instant slash command registration

DISCORD_WEBHOOK_URL=    # optional: alert-only mode, no discord.js needed

# ── Trading (optional) ────────────────────────────────────────────────────────

ALPACA_API_KEY=

ALPACA_SECRET_KEY=

Key Commands

Command

Description

npm run dev

Start dashboard with auto-reload

node server.mjs

Start directly (bypasses npm script runner)

node diag.mjs

Diagnose setup issues

docker compose up -d

Run in background with Docker

npx @openai/codex login

Authenticate Codex LLM via ChatGPT subscription

Telegram Bot Commands

Once TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID are set, the bot responds to:

Command

What It Does

/status

System health, last sweep time, source/LLM status

/sweep

Trigger a manual intelligence sweep immediately

/brief

Compact text summary: direction, key metrics, top OSINT

/portfolio

Portfolio status (requires Alpaca keys)

/alerts

Recent alert history with tier labels

/mute / /mute 2h

Silence alerts for 1h or custom duration

/unmute

Resume alerts

/help

List all commands

Discord Bot Commands

Install discord.js for full bot mode; otherwise Crucix auto-falls back to webhook-only:

npm install discord.js   # optional: enables slash commands + rich embeds

Slash commands available: /status, /sweep, /brief, /portfolio

Alert embeds are color-coded: 🔴 red = FLASH, 🟡 yellow = PRIORITY, 🔵 blue = ROUTINE.

Webhook-only mode (no discord.js, no slash commands):

DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN

LLM Provider Setup

Anthropic Claude

LLM_PROVIDER=anthropic

LLM_API_KEY=$ANTHROPIC_API_KEY

OpenAI

LLM_PROVIDER=openai

LLM_API_KEY=$OPENAI_API_KEY

Google Gemini

LLM_PROVIDER=gemini

LLM_API_KEY=$GEMINI_API_KEY

OpenAI Codex (ChatGPT subscription — no API key needed)

npx @openai/codex login   # authenticate once

LLM_PROVIDER=codex

# LLM_API_KEY not required

LLM failures are non-fatal — Crucix automatically falls back to rule-based alert evaluation without crashing the sweep cycle.

Architecture & Data Flow

Each 15-minute sweep cycle:

• Parallel fetch — all 27 sources queried simultaneously (~30–60s)

• Synthesis — raw data normalized into dashboard format

• Delta computation — what changed, escalated, or de-escalated vs. previous run

• LLM analysis — 5–8 trade ideas generated (or rule-based fallback)

• Alert evaluation — FLASH / PRIORITY / ROUTINE tiering with semantic dedup

• Push — SSE update to all connected browsers + Telegram/Discord if configured

• Persistence — sweep written to ./runs/ directory

Dashboard Features

• 3D WebGL globe (Globe.gl) with atmosphere, star field, rotation + flat map toggle

• 9 marker types: fires, aircraft, radiation, maritime chokepoints, SDR receivers, OSINT events, health alerts, geolocated news, conflict events

• Animated 3D flight arcs between air traffic hotspots

• Region filters: World, Americas, Europe, Middle East, Asia Pacific, Africa

• Live markets: indexes, crypto, energy, commodities (Yahoo Finance, no key needed)

• Risk gauges: VIX, high-yield spread, supply chain pressure index

• OSINT feed: 17 built-in Telegram intelligence channels

• Sweep Delta panel: live diff of what changed this cycle

• Nuclear watch: Safecast + EPA RadNet radiation readings

• Space watch: CelesTrak satellite tracking — ISS, Starlink, military constellations

Common Patterns

Minimal Setup (no API keys)

# Works out of the box — sources without keys still populate:

# Yahoo Finance markets, CelesTrak satellites, GDELT news, RSS feeds,

# OpenSky flight tracking (public tier), Safecast radiation

npm run dev

Maximum Free Coverage

# Register all three free keys (~3 minutes total):

FRED_API_KEY=       # fred.stlouisfed.org — 60 sec signup

FIRMS_MAP_KEY=      # firms.modaps.eosdis.nasa.gov — 60 sec signup

EIA_API_KEY=        # eia.gov/opendata/register.php — 60 sec signup

Telegram Alerts Only (no LLM)

TELEGRAM_BOT_TOKEN=your_token_from_botfather

TELEGRAM_CHAT_ID=your_chat_id_from_userinfobot

# LLM_PROVIDER intentionally omitted — rule-based alerts still fire

Full Stack with LLM + Both Bots

FRED_API_KEY=...

FIRMS_MAP_KEY=...

EIA_API_KEY=...

LLM_PROVIDER=anthropic

LLM_API_KEY=...

TELEGRAM_BOT_TOKEN=...

TELEGRAM_CHAT_ID=...

DISCORD_BOT_TOKEN=...

DISCORD_CHANNEL_ID=...

DISCORD_GUILD_ID=...   # for instant slash command registration

Adding Extra Telegram OSINT Channels

# Comma-separated channel IDs beyond the 17 built-in channels

TELEGRAM_CHANNELS=-1001234567890,-1009876543210

Troubleshooting

Dashboard empty after startup:

Normal — the first sweep takes 30–60 seconds to query all 27 sources. Wait for it to complete before expecting data.

**npm run dev exits silently (especially Windows PowerShell):**

node --trace-warnings server.mjs

# or run the diagnostic tool:

node diag.mjs

Port already in use:

# Default port is 3117 — check if something else is using it:

lsof -i :3117        # macOS/Linux

netstat -ano | findstr :3117   # Windows

Telegram bot not receiving commands:

• Verify TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID are both set

• Confirm the chat ID is your personal chat, not a group (use @userinfobot)

• Default poll interval is 5000ms — set TELEGRAM_POLL_INTERVAL=2000 for faster response

Discord slash commands not appearing:

• Set DISCORD_GUILD_ID for instant registration (vs. up to 1 hour for global)

• Ensure the bot invite URL includes both bot and applications.commands scopes

• Check Message Content Intent is enabled in the Developer Portal

LLM errors crashing sweeps:

They won't — LLM failures are caught and the sweep continues with rule-based fallback. Check logs for the specific provider error (invalid key, rate limit, etc.).

ACLED conflict data missing:

ACLED uses OAuth2 with email/password — both ACLED_EMAIL and ACLED_PASSWORD must be set together.

Sweep data persistence:

All runs are saved to ./runs/. In Docker, this is volume-mounted so data survives container restarts.