Crucix  by calesthio

Local intelligence terminal for global event monitoring

Created 3 months ago
10,309 stars

Top 5.1% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

Crucix is a self-contained intelligence terminal designed to aggregate and visualize data from 26 open-source intelligence (OSINT) feeds, including satellite imagery, flight tracking, economic indicators, and conflict data. It provides a unified, "Jarvis-style" dashboard and can integrate with LLMs for advanced analysis and alerts, targeting researchers, journalists, traders, and OSINT analysts who require real-time global insights without cloud dependencies or subscriptions.

How It Works

Crucix operates by querying 26 diverse OSINT sources in parallel every 15 minutes. It synthesizes this data into a self-contained dashboard and can optionally connect to LLM providers for enhanced alert evaluation and trade idea generation. The system prioritizes a zero-cloud, zero-telemetry approach, running entirely on the user's machine. Its design emphasizes parallel execution, graceful degradation for missing API keys, and standalone source modules for modularity.

Quick Start & Requirements

  • Primary install/run command: Clone the repo, run npm install, then npm run dev for the dashboard. Docker is also supported via docker compose up -d.
  • Non-default prerequisites: Node.js 22+ is required. discord.js is optional for full Discord bot functionality. API keys for certain data sources (e.g., FRED, FIRMS, EIA are recommended free keys; others like ACLED, AISSTREAM, ADSB are optional) and LLM provider API keys are optional. Telegram/Discord bot tokens are optional.
  • Estimated setup time: Initial sweep takes 30-60 seconds. Setup involves cloning, installing dependencies, and optionally configuring API keys.
  • Links: Project GitHub

Highlighted Details

  • Unified Dashboard: A "Jarvis-style" HUD displaying 7 marker types on a world map, live market data, risk gauges, OSINT feeds, news tickers, and a "Sweep Delta" panel showing changes since the last update.
  • Two-Way Bots: Integrates with Telegram and Discord as bots, allowing users to trigger manual sweeps, get briefs, check status, and manage alerts via chat commands.
  • LLM Integration: Supports Anthropic Claude, OpenAI, Google Gemini, and OpenAI Codex for AI-generated trade ideas and smarter alert evaluation, with a rule-based fallback.
  • Extensive Data Sources: Aggregates data from 26 sources across geopolitical, economic, environmental, and social domains, including satellite fire detection, flight tracking, radiation monitoring, conflict events, and market prices.
  • Zero Cloud/Telemetry: Designed for local execution, ensuring data privacy and no external dependencies beyond the user's machine.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels like Discord/Slack. It encourages contributions via pull requests and notes that project stars help visibility.

Licensing & Compatibility

  • License type: MIT License.
  • Compatibility notes: The MIT license generally permits commercial use and linking with closed-source projects without significant restrictions.

Limitations & Caveats

Some data sources require API keys for full functionality, though many core features operate without them. The full Discord bot functionality requires discord.js to be installed. A known issue exists where npm run dev can exit silently on some systems (e.g., Windows PowerShell), necessitating direct Node execution or the diag.mjs script for troubleshooting.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
2
Star History
294 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.