npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

crucix

v2.52.4

Published

Local intelligence engine - 73 OSINT adapters, live dashboard, bounded requests, optional local or cloud AI.

Readme

Crucix

Your own intelligence terminal. 73 sources. One command. Local processing.

Node.js 22+ License: AGPL v3 Dependencies Sources npm Docker

Crucix Dashboard

| Boot Sequence | World Map | |:---:|:---:| | Boot | Map |

| 3D Globe View | |:---:| | Globe |

Fork: this repository is a fork of calesthio/Crucix. This fork's releases, audit and installation instructions are in this README and the documentation pages.

Showcase site: an animated, bilingual (HU/EN) presentation of what Crucix does lives in docs/site — open docs/site/index.html in a browser, no build step.

Crucix pulls satellite fire detection, flight tracking (including military air activity and orbits), radiation and wind at nuclear sites, cyclones and launches, earthquakes and disasters, economic indicators, live market prices, conflict data, sanctions lists, cyber and internet signals and social sentiment from 73 open-source intelligence sources — in parallel, every 15 minutes — and renders everything on a single Jarvis-style dashboard with a 3D globe and a flat map. On top of the raw feeds it keeps a searchable event history, a country risk index, an alert engine and a replayable sweep archive.

Hook it up to an LLM and it becomes a two-way intelligence assistant — pushing multi-tier alerts to Telegram and Discord when something meaningful changes, responding to commands like /brief, /ask and /risk from your phone, and generating actionable trade ideas grounded in real cross-domain data. Your own analyst that watches the world while you sleep.

The server and data run on your machine. Settings and feed overrides live in %USERPROFILE%\.crucix / ~/.crucix (or CRUCIX_HOME). External feeds need network access; browser map/font libraries are pinned local assets. Cloud AI and paid APIs are optional. The app has no built-in telemetry. Start with npx crucix or node server.mjs.

Documentation

The README is the short version. Core documentation is provided in English:

| English Documentation | Description | |---|---| | Setup & Configuration Guide | Interactive setup wizard, Telegram/Discord notifications, LLM setup, and free API keys | | Features by release | What each version added: alert engine, country risk, record inspector, sweep archive, map layers, new sources | | Configuration | API keys, Telegram and Discord bots, the LLM layer, environment variables, npm scripts | | Data sources | All 73 sources by tier, with keys, licences and limits | | HTTP API | The JSON API: routes, parameters, errors, CORS, recipes | | Embedding | Show Crucix or a status widget on your own site (iframe) | | Architecture | The sweep cycle, components and design principles | | Troubleshooting | Start-up and data problems | | Changelog · Contributing · Security | Project updates, contribution guidelines and security policy |

Non-English Documentation / Nemzetközi és magyar nyelvű dokumentáció

Specialized operational guides, architecture audits, and regional research catalogs written in Hungarian are organized in this dedicated section:

| Dokumentum / Document | Leírás / Description | Nyelv / Language | |---|---|---| | Beállítási és Telepítési Útmutató | Interaktív beállító varázsló, Telegram és Discord értesítések, LLM és ingyenes API kulcsok | Magyar (HU) | | Üzemeltetési útmutató (Operations) | Helyi hálózat (LAN), Docker, helyi nyelvi modellek, megbízhatóság és napi üzemeltetés | Magyar (HU) | | Világméretű RSS-katalógus | 195 ország, 539 médium RSS és keresési lefedettségének technikai jegyzéke | Magyar (HU) | | Interaktív bemutató oldal (Showcase) | Kétnyelvű animált prezentáció és vizuális bemutató böngészőben | Magyar (HU) / Angol (EN) | | PR felülvizsgálati audit (2026-10-10) | Upstream PR-ek és hibajavítások szisztematikus összehasonlító auditja | Magyar (HU) | | Teljes architektúra audit (2026-10-01) | Biztonsági, stabilitási és forrásintegrációs mélyelemzés | Magyar (HU) | | Elérhető források és licencek elemzése | 71 OSINT adatforrás jogi és technikai korlátainak elemzése | Magyar (HU) |

Use it from your own code: every panel is backed by a JSON route, so scripts, bots and other sites can read the same data (curl http://localhost:3117/api/alerts/summary). See the HTTP API and embedding guides.


Token / Asset Warning

[!WARNING] Crucix has not launched any official token, coin, NFT, airdrop, presale, or other blockchain-based asset. Any token or digital asset using the Crucix name, logo, or branding is not affiliated with or endorsed by Crucix. Do not buy it, promote it, connect a wallet to claim it, sign transactions, or send funds based on third-party posts, DMs, or websites.


Why This Exists

Most of the world's real-time intelligence — satellite imagery, radiation levels, conflict events, economic indicators, flight tracking, maritime activity — is publicly available. It's just scattered across dozens of government APIs, research institutions, and open data feeds that nobody has time to check individually.

Crucix brings it all into one place. Not behind a paywall, not locked in an enterprise platform, not requiring a security clearance. Just open data, aggregated and cross-correlated on your own machine, updated every 15 minutes.

It was built for anyone who wants to understand what's actually happening in the world right now — researchers, journalists, traders, OSINT analysts, or just curious people who believe access to information shouldn't depend on your budget.


Quick Start

# Windows: standalone exe from GitHub Releases (no Node)
irm https://github.com/arlinamid/Crucix/releases/latest/download/install.ps1 | iex
# Linux / macOS
curl -fsSL https://github.com/arlinamid/Crucix/releases/latest/download/install.sh | sh
# From npm: Node + runtime source, first run opens the setup wizard
npx crucix
npm install -g crucix

Then:

crucix --version
crucix install          # ~/.crucix (.env and runs/)
crucix                  # dashboard; wizard if no .env yet

npm run install:local (from a git checkout) builds the exe yourself. Check which one PATH hits with crucix --version.

Settings the wizard and Settings → News feeds save go to %USERPROFILE%\.crucix on Windows or ~/.crucix on Linux/macOS. Set CRUCIX_HOME to choose another folder, or CRUCIX_ENV_FILE to name the .env itself.

From a git checkout (development):

git clone https://github.com/arlinamid/Crucix.git
cd Crucix
npm ci
npm run dev             # dashboard at http://localhost:3117
npm run cli -- -b       # briefing in the terminal, no browser

If npm run dev fails silently (exits with no output), run Node directly instead:

node --trace-warnings server.mjs

This bypasses npm's script runner, which can swallow errors on some systems (particularly PowerShell on Windows). You can also run node diag.mjs to diagnose the exact issue — it checks your Node version, tests each module import individually, and verifies port availability. See Troubleshooting for more.

The dashboard opens automatically at http://localhost:3117 and immediately begins its first intelligence sweep. This initial sweep queries all 73 sources in parallel and typically takes 30–60 seconds — the dashboard will appear empty until the sweep completes and pushes the first data update. After that, it auto-refreshes every 15 minutes via SSE (Server-Sent Events). No manual page refresh needed.

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

Docker

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

Dashboard at http://localhost:3117. Sweep data persists in ./runs/ via volume mount. Includes a health check endpoint.

Access and privacy (v2.1)

The native server and Docker published port default to localhost. For LAN access, set HOST=0.0.0.0 for native Node, or BIND_ADDRESS=0.0.0.0 for Compose. Set both AUTH_USER and AUTH_PASSWORD to protect the dashboard, JSON APIs and event stream. A partial credential configuration fails at startup. Use an HTTPS reverse proxy when exposing password-protected access beyond the local machine; HTTP Basic authentication does not encrypt credentials. /healthz exposes only a minimal health status without authentication.

PUBLIC_URL controls dashboard links in bot messages. NO_AUTO_OPEN=1 disables automatic browser launch. PORT accepts integers from 1 to 65535. The event stream has heartbeats and a configurable MAX_SSE_CLIENTS limit.

Public Telegram preview collection is disabled by default. Set TELEGRAM_OSINT_ENABLED=true to enable it. The OSINT source never reads private messages or control-bot updates; TELEGRAM_BOT_TOKEN is used only for alerts and commands. Discord commands are restricted to the configured channel and guild. Sweep/mute/unmute require Manage Server/Administrator permission or membership in DISCORD_ALLOWED_USER_IDS.

To read the API or show the dashboard on another website, set CORS_ORIGINS and/or EMBED_ORIGINS (both off by default; see HTTP API and Embedding).

The container runs as UID 1000. On Linux, prepare the bind-mounted directory with mkdir -p runs && sudo chown 1000:1000 runs before starting Compose. Keep existing sweep files and adjust their ownership if necessary. The container checks /healthz using the configured port.

Run npm run check and npm test before submitting changes. See the bilingual changelog and the audit plan.


What You Get

Live Dashboard

A self-contained Jarvis-style HUD with:

  • 3D WebGL globe (Globe.gl) with atmosphere glow, star field, and smooth rotation — plus a classic flat map toggle
  • Shared layer controls across both views (22 layers): fire, air, radiation, maritime references, SDR, OSINT, health, inferred news, conflict, internet outages, weather, earthquakes, natural events, space stations, GNSS interference, cyclone forecast tracks and cones, orbital launches and (off by default) oil and gas pipelines, military bases, mapped military areas, data centres and dams. Located live records take the colour of their layer
  • Globe basemap button — night lights or the daily NASA GIBS satellite image of yesterday; the © button lists the credits and licences of what is on screen
  • Global air traffic — every aircraft OpenSky sees, grouped by zoom with a mini map of each group (heading, altitude, callsign, route), origin–destination arcs of the busiest airport pairs, icons for emergency squawks and military-pattern callsigns, and a switch to show every aircraft
  • 14 Geopolitical Region filters & Country selector — 14 regions (World, Americas, North America, Latin America, Europe, Eastern Europe, Middle East, Africa, Asia Pacific, Central Asia, South Asia, East Asia, Southeast Asia, Oceania) plus an interactive country dropdown showing active story counts (e.g. [UA] Ukraine (8)) with targeted zoom
  • Live market data — indexes, world indexes, equities, FX crosses, crypto, energy and commodities. Yahoo needs no key; optional FMP_API_KEY and FINNHUB_API_KEY take priority. The FX base is CRUCIX_BASE_CURRENCY (default USD) or the dashboard dropdown
  • Risk gauges — VIX, high-yield spread, supply chain pressure index
  • OSINT feed — English-language posts from 17 Telegram intelligence channels (expandable)
  • News ticker & World RSS catalog — merged RSS + GDELT headlines + Telegram posts, auto-scrolling with newest-first ordering and diversity capping. Supported by a 539-feed world RSS catalog covering 195 countries. Settings → News feeds switches groups on or off, adds your own RSS and imports OPML; choices live in the profile feeds.json
  • Command Line Interface (CLI) & Headless Collector — query briefing, markets, risk, earthquakes, thermal hotspots, and news directly in the terminal via npm run cli (works with the server or standalone/offline via --no-server, plus npm run daemon for headless server and npm run collector for recurring terminal data harvesting)
  • Sweep delta — live panel showing what changed since last sweep (new signals, escalations, de-escalations with severity)
  • Cross-source signals — correlated intelligence across satellite, economic, conflict, and social domains
  • Nuclear watch — recent (72 h) radiation readings from Safecast, shown with their age, the modelled current wind at each site (Open-Meteo; not a dispersion forecast), plus EPA RadNet when reachable
  • Space watch — CelesTrak satellite tracking: recent launches, ISS, military constellations, Starlink/OneWeb counts; Launch Library 2 launches of the next 14 days and the last 7 on the map
  • Leverageable ideas — AI-generated trade ideas (with LLM) or signal-correlated ideas (without)
  • Intelligence layer on top — record inspector, searchable history and exports, alert engine, domain lenses, sweep replay, country risk index with cited briefings and a source-health matrix (see Features by release and the HTTP API)
  • Three languages — the dashboard and the rule-based ideas and briefings follow CRUCIX_LANG (en, hu, fr)

Performance Modes

The VISUALS FULL / VISUALS LITE button in the top bar only changes rendering behavior - it does not remove data sources or reduce sweep coverage.

When you switch to VISUALS LITE, the dashboard:

  • Disables decorative background effects such as the radial/grid overlays and scanlines
  • Removes expensive blur/backdrop-filter effects on panels and overlays
  • Stops non-essential animations like the logo ring blink, conflict rings, and corridor flow effects
  • Disables globe auto-rotation and turns off animated flight-arc dashes
  • Converts the horizontal news ticker and OSINT stream into static, scrollable lists instead of continuously animated marquees

Mobile-specific behavior:

  • On mobile, VISUALS LITE also forces the dashboard into flat map mode if you are currently on the globe
  • Future mobile loads will continue to start flat while low-perf mode is enabled

The preference is saved in browser local storage, so the UI will remember your last setting.

Auto-Refresh

The server runs a sweep cycle every 15 minutes (configurable). Each cycle:

  1. Queries all 73 sources in parallel (~30s)
  2. Synthesizes raw data into dashboard format
  3. Computes delta from previous run (what changed, escalated, de-escalated) — visible in the Sweep Delta panel on the dashboard
  4. Generates LLM trade ideas (if configured)
  5. Evaluates breaking news alerts — multi-tier (FLASH / PRIORITY / ROUTINE) with semantic dedup. Sends to Telegram and/or Discord if configured. Works with LLM evaluation or falls back to rule-based alerting when LLM is unavailable.
  6. Evaluates the alert engine rules: alerts for the dashboard and, if configured, ntfy/webhook (Telegram/Discord by opt-in)
  7. Pushes update to all connected browsers via SSE

Alerts, bots and the LLM layer

Alerts reach you on the dashboard, and optionally in Telegram, Discord, ntfy or a webhook; with an LLM key Crucix also writes trade ideas and cited briefings. Telegram and Discord alerts include source links and a “why it matters” line. The bots are two-way (/status, /brief, /ask, /risk, /sweep, /mute, …). /ask reads only the latest sweep. All of it is off until you set the matching keys: see Configuration.


Screenshots

The docs/ folder contains dashboard screenshots referenced by this README:

| File | Description | |------|-------------| | docs/dashboard.png | Full dashboard — hero image at the top of this README | | docs/boot.png | Cinematic boot sequence animation | | docs/map.png | D3 world map with marker types and flight arcs | | docs/globe.png | 3D WebGL globe view with atmosphere glow and markers |

The current set was taken from a real sweep on 2026-10-08 (v2.30.4; English UI, 1945×1233). To update them: run the dashboard (for screenshots, with the bots, the LLM and the alert channels left empty), wait for a sweep to complete, then use your browser's DevTools (F12 → Ctrl+Shift+P → "Capture full size screenshot") or a tool like LICEcap for GIFs.


Contributing

Found a bug or want to add another source? PRs welcome. Each source is a standalone module in apis/sources/ — export a briefing() function that returns structured data and add it to the orchestrator in apis/briefing.mjs. A "current public data" source (provider time, freshness policy, record inspector rows) also needs a freshness policy (apis/utils/freshness.mjs), a domain lens (lib/domains.mjs and its browser copy), fact captions in locales/*.json and the registry tests; see CONTRIBUTING.md and the release notes of a recent source (for example v2.27.0).

If you find this useful, a star helps others find it too.

For contribution guidelines, review expectations, and source-add rules, see CONTRIBUTING.md. For security reports, see SECURITY.md.


License

AGPL-3.0