Crucix Intelligence Dashboard

1---2name: crucix-intelligence-dashboard3description: Personal intelligence agent that aggregates 27 OSINT data sources into a self-hosted Jarvis-style dashboard with Telegram/Discord bots, LLM analysis, and real-time alerts.4triggers:5  - set up Crucix intelligence dashboard6  - add OSINT monitoring with Crucix7  - configure Crucix alerts and bots8  - integrate LLM with Crucix intelligence9  - watch multiple data sources for changes10  - set up self-hosted intelligence terminal11  - configure Crucix Telegram or Discord bot12  - add real-time world monitoring dashboard13---14 15# Crucix Intelligence Dashboard16 17> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.18 19Crucix is a self-hosted intelligence terminal that pulls from 27 open-source data feeds (satellite fire detection, flight tracking, radiation monitoring, conflict data, market prices, maritime AIS, economic indicators, and more) every 15 minutes, renders everything on a WebGL globe dashboard, and optionally pushes alerts to Telegram/Discord with LLM-enhanced analysis.20 21---22 23## Installation24 25```bash26git clone https://github.com/calesthio/Crucix.git27cd crucix28npm install          # installs Express (only hard dependency)29cp .env.example .env # then edit .env with your API keys30npm run dev          # dashboard at http://localhost:311731```32 33**Docker:**34```bash35cp .env.example .env36docker compose up -d37# sweep data persists in ./runs/ via volume mount38```39 40**Requirements:** Node.js 22+ (uses native `fetch`, top-level `await`, ESM modules)41 42**If `npm run dev` exits silently:**43```bash44node --trace-warnings server.mjs   # bypasses npm script runner (useful on Windows PowerShell)45node diag.mjs                       # diagnoses Node version, module imports, port availability46```47 48---49 50## Environment Configuration (`.env`)51 52```dotenv53# ── Core Free APIs (highly recommended) ──────────────────────────────────────54FRED_API_KEY=           # Federal Reserve economic data — fred.stlouisfed.org55FIRMS_MAP_KEY=          # NASA satellite fire detection — firms.modaps.eosdis.nasa.gov56EIA_API_KEY=            # US Energy Info Admin — eia.gov/opendata/register.php57 58# ── Optional Data Sources ─────────────────────────────────────────────────────59ACLED_EMAIL=            # Armed conflict data — acleddata.com/register60ACLED_PASSWORD=61AISSTREAM_API_KEY=      # Maritime vessel tracking — aisstream.io (free)62ADSB_API_KEY=           # Unfiltered flight tracking — RapidAPI (~$10/mo)63 64# ── LLM Provider (pick one) ───────────────────────────────────────────────────65LLM_PROVIDER=           # anthropic | openai | gemini | codex66LLM_API_KEY=            # not needed for codex (uses ~/.codex/auth.json)67 68# ── Telegram Bot ─────────────────────────────────────────────────────────────69TELEGRAM_BOT_TOKEN=     # from @BotFather70TELEGRAM_CHAT_ID=       # from @userinfobot71TELEGRAM_CHANNELS=      # optional: extra channel IDs beyond 17 built-in72TELEGRAM_POLL_INTERVAL= # ms between command polls, default 500073 74# ── Discord Bot ───────────────────────────────────────────────────────────────75DISCORD_BOT_TOKEN=      # Discord Developer Portal → Bot → Token76DISCORD_CHANNEL_ID=     # right-click channel → Copy Channel ID77DISCORD_GUILD_ID=       # optional: instant slash command registration78DISCORD_WEBHOOK_URL=    # optional: alert-only mode, no discord.js needed79 80# ── Trading (optional) ────────────────────────────────────────────────────────81ALPACA_API_KEY=82ALPACA_SECRET_KEY=83```84 85---86 87## Key Commands88 89| Command | Description |90|---|---|91| `npm run dev` | Start dashboard with auto-reload |92| `node server.mjs` | Start directly (bypasses npm script runner) |93| `node diag.mjs` | Diagnose setup issues |94| `docker compose up -d` | Run in background with Docker |95| `npx @openai/codex login` | Authenticate Codex LLM via ChatGPT subscription |96 97---98 99## Telegram Bot Commands100 101Once `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID` are set, the bot responds to:102 103| Command | What It Does |104|---|---|105| `/status` | System health, last sweep time, source/LLM status |106| `/sweep` | Trigger a manual intelligence sweep immediately |107| `/brief` | Compact text summary: direction, key metrics, top OSINT |108| `/portfolio` | Portfolio status (requires Alpaca keys) |109| `/alerts` | Recent alert history with tier labels |110| `/mute` / `/mute 2h` | Silence alerts for 1h or custom duration |111| `/unmute` | Resume alerts |112| `/help` | List all commands |113 114---115 116## Discord Bot Commands117 118Install `discord.js` for full bot mode; otherwise Crucix auto-falls back to webhook-only:119 120```bash121npm install discord.js   # optional: enables slash commands + rich embeds122```123 124Slash commands available: `/status`, `/sweep`, `/brief`, `/portfolio`125 126Alert embeds are color-coded: 🔴 red = FLASH, 🟡 yellow = PRIORITY, 🔵 blue = ROUTINE.127 128**Webhook-only mode** (no `discord.js`, no slash commands):129```dotenv130DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN131```132 133---134 135## LLM Provider Setup136 137### Anthropic Claude138```dotenv139LLM_PROVIDER=anthropic140LLM_API_KEY=$ANTHROPIC_API_KEY141```142 143### OpenAI144```dotenv145LLM_PROVIDER=openai146LLM_API_KEY=$OPENAI_API_KEY147```148 149### Google Gemini150```dotenv151LLM_PROVIDER=gemini152LLM_API_KEY=$GEMINI_API_KEY153```154 155### OpenAI Codex (ChatGPT subscription — no API key needed)156```bash157npx @openai/codex login   # authenticate once158```159```dotenv160LLM_PROVIDER=codex161# LLM_API_KEY not required162```163 164LLM failures are non-fatal — Crucix automatically falls back to rule-based alert evaluation without crashing the sweep cycle.165 166---167 168## Architecture & Data Flow169 170Each 15-minute sweep cycle:1711. **Parallel fetch** — all 27 sources queried simultaneously (~30–60s)1722. **Synthesis** — raw data normalized into dashboard format1733. **Delta computation** — what changed, escalated, or de-escalated vs. previous run1744. **LLM analysis** — 5–8 trade ideas generated (or rule-based fallback)1755. **Alert evaluation** — FLASH / PRIORITY / ROUTINE tiering with semantic dedup1766. **Push** — SSE update to all connected browsers + Telegram/Discord if configured1777. **Persistence** — sweep written to `./runs/` directory178 179---180 181## Dashboard Features182 183- **3D WebGL globe** (Globe.gl) with atmosphere, star field, rotation + flat map toggle184- **9 marker types**: fires, aircraft, radiation, maritime chokepoints, SDR receivers, OSINT events, health alerts, geolocated news, conflict events185- **Animated 3D flight arcs** between air traffic hotspots186- **Region filters**: World, Americas, Europe, Middle East, Asia Pacific, Africa187- **Live markets**: indexes, crypto, energy, commodities (Yahoo Finance, no key needed)188- **Risk gauges**: VIX, high-yield spread, supply chain pressure index189- **OSINT feed**: 17 built-in Telegram intelligence channels190- **Sweep Delta panel**: live diff of what changed this cycle191- **Nuclear watch**: Safecast + EPA RadNet radiation readings192- **Space watch**: CelesTrak satellite tracking — ISS, Starlink, military constellations193 194---195 196## Common Patterns197 198### Minimal Setup (no API keys)199```bash200# Works out of the box — sources without keys still populate:201# Yahoo Finance markets, CelesTrak satellites, GDELT news, RSS feeds,202# OpenSky flight tracking (public tier), Safecast radiation203npm run dev204```205 206### Maximum Free Coverage207```dotenv208# Register all three free keys (~3 minutes total):209FRED_API_KEY=       # fred.stlouisfed.org — 60 sec signup210FIRMS_MAP_KEY=      # firms.modaps.eosdis.nasa.gov — 60 sec signup211EIA_API_KEY=        # eia.gov/opendata/register.php — 60 sec signup212```213 214### Telegram Alerts Only (no LLM)215```dotenv216TELEGRAM_BOT_TOKEN=your_token_from_botfather217TELEGRAM_CHAT_ID=your_chat_id_from_userinfobot218# LLM_PROVIDER intentionally omitted — rule-based alerts still fire219```220 221### Full Stack with LLM + Both Bots222```dotenv223FRED_API_KEY=...224FIRMS_MAP_KEY=...225EIA_API_KEY=...226LLM_PROVIDER=anthropic227LLM_API_KEY=...228TELEGRAM_BOT_TOKEN=...229TELEGRAM_CHAT_ID=...230DISCORD_BOT_TOKEN=...231DISCORD_CHANNEL_ID=...232DISCORD_GUILD_ID=...   # for instant slash command registration233```234 235### Adding Extra Telegram OSINT Channels236```dotenv237# Comma-separated channel IDs beyond the 17 built-in channels238TELEGRAM_CHANNELS=-1001234567890,-1009876543210239```240 241---242 243## Troubleshooting244 245**Dashboard empty after startup:**246Normal — the first sweep takes 30–60 seconds to query all 27 sources. Wait for it to complete before expecting data.247 248**`npm run dev` exits silently (especially Windows PowerShell):**249```bash250node --trace-warnings server.mjs251# or run the diagnostic tool:252node diag.mjs253```254 255**Port already in use:**256```bash257# Default port is 3117 — check if something else is using it:258lsof -i :3117        # macOS/Linux259netstat -ano | findstr :3117   # Windows260```261 262**Telegram bot not receiving commands:**263- Verify `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID` are both set264- Confirm the chat ID is your personal chat, not a group (use @userinfobot)265- Default poll interval is 5000ms — set `TELEGRAM_POLL_INTERVAL=2000` for faster response266 267**Discord slash commands not appearing:**268- Set `DISCORD_GUILD_ID` for instant registration (vs. up to 1 hour for global)269- Ensure the bot invite URL includes both `bot` and `applications.commands` scopes270- Check **Message Content Intent** is enabled in the Developer Portal271 272**LLM errors crashing sweeps:**273They 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.).274 275**ACLED conflict data missing:**276ACLED uses OAuth2 with email/password — both `ACLED_EMAIL` and `ACLED_PASSWORD` must be set together.277 278**Sweep data persistence:**279All runs are saved to `./runs/`. In Docker, this is volume-mounted so data survives container restarts.