{"id":48936690,"url":"https://github.com/0xhav0c/argus","last_synced_at":"2026-04-18T13:00:50.074Z","repository":{"id":350952508,"uuid":"1208166601","full_name":"0xhav0c/ARGUS","owner":"0xhav0c","description":"Real-time global OSINT \u0026 intelligence dashboard — 3D globe visualization, multi-domain threat feeds, AI analysis, flight/vessel/satellite tracking. Built with Electron + React + CesiumJS.","archived":false,"fork":false,"pushed_at":"2026-04-17T10:53:41.000Z","size":1442,"stargazers_count":9,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T12:37:08.613Z","etag":null,"topics":["3d-globe","cesiumjs","cybersecurity","desktop-app","electron","geospatial","osint","react","real-time","sqlite","threat-intelligence","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xhav0c.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-11T22:58:26.000Z","updated_at":"2026-04-17T10:53:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/0xhav0c/ARGUS","commit_stats":null,"previous_names":["0xhav0c/argus"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/0xhav0c/ARGUS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xhav0c%2FARGUS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xhav0c%2FARGUS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xhav0c%2FARGUS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xhav0c%2FARGUS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xhav0c","download_url":"https://codeload.github.com/0xhav0c/ARGUS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xhav0c%2FARGUS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31969772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-globe","cesiumjs","cybersecurity","desktop-app","electron","geospatial","osint","react","real-time","sqlite","threat-intelligence","typescript"],"created_at":"2026-04-17T12:01:41.273Z","updated_at":"2026-04-18T13:00:49.979Z","avatar_url":"https://github.com/0xhav0c.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/icon.png\" width=\"120\" alt=\"ARGUS Logo\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eARGUS\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eReal-time Global OSINT \u0026 Intelligence Dashboard\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e •\n  \u003ca href=\"#architecture\"\u003eArchitecture\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/0xhav0c/ARGUS?style=flat-square\" alt=\"License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/0xhav0c/ARGUS?style=flat-square\" alt=\"Release\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue?style=flat-square\" alt=\"Platform\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/electron-41-blue?style=flat-square\" alt=\"Electron\" /\u003e\n\u003c/p\u003e\n\n---\n\n## About\n\nARGUS is a desktop intelligence platform that aggregates, classifies, and visualizes global incidents in real time on an interactive 3D globe. It pulls data from dozens of open-source feeds (RSS, APIs, scrapers) and presents a unified operational picture for security analysts, researchers, and OSINT practitioners.\n\nThis is a **hobby/passion project** built to explore and push the boundaries of what's possible with **Electron, React, and CesiumJS**. The goal was to learn modern desktop app development end-to-end — from multi-process IPC architecture and SQLite-backed offline caching to real-time 3D globe rendering and AI-powered analysis pipelines. It's not a commercial product; it's a playground for experimentation, learning, and building something genuinely useful for the OSINT community.\n\nNamed after the hundred-eyed giant of Greek mythology — _Argus Panoptes_, the all-seeing guardian.\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/screenshots/default-index.png\" width=\"100%\" alt=\"Globe Dashboard\" /\u003e\n  \u003cbr/\u003e\u003cem\u003e3D Globe — Real-time incident visualization with multi-layer overlays\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📸 More Screenshots\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n| Dashboard Widgets | Incident Details |\n|:-:|:-:|\n| \u003cimg src=\"docs/screenshots/dashboards.png\" width=\"100%\" alt=\"Dashboard Widgets\" /\u003e | \u003cimg src=\"docs/screenshots/incident-info.png\" width=\"100%\" alt=\"Incident Details\" /\u003e |\n| *Threat score, timeline analysis, entity tracking* | *Detailed incident view with geolocation \u0026 entities* |\n\n| Analysis \u0026 Operations | Alerts System |\n|:-:|:-:|\n| \u003cimg src=\"docs/screenshots/analysis.png\" width=\"100%\" alt=\"Analysis\" /\u003e | \u003cimg src=\"docs/screenshots/alerts.png\" width=\"100%\" alt=\"Alerts\" /\u003e |\n| *Advanced search, bookmarks, and threat analysis* | *Smart alert rules with geofence \u0026 keyword triggers* |\n\n| AI Summary | Media \u0026 Live TV |\n|:-:|:-:|\n| \u003cimg src=\"docs/screenshots/ai-summary.png\" width=\"100%\" alt=\"AI Summary\" /\u003e | \u003cimg src=\"docs/screenshots/media-tv-grid.png\" width=\"100%\" alt=\"Media TV Grid\" /\u003e |\n| *AI-powered daily briefings and incident summaries* | *Multi-channel live TV grid with volume controls* |\n\n| Settings |\n|:-:|\n| \u003cimg src=\"docs/screenshots/settings.png\" width=\"100%\" alt=\"Settings\" /\u003e |\n| *Feeds, API keys, layers, alerts, and appearance configuration* |\n\n\u003c/details\u003e\n\n## Features\n\n### Core Intelligence\n- **3D Globe Visualization** — CesiumJS-powered interactive globe with real-time incident markers, heatmaps, and animated arcs\n- **Multi-Domain Feeds** — Aggregates CONFLICT, CYBER, INTEL, and FINANCE incidents from 50+ open-source feeds\n- **AI-Powered Analysis** — Summarization, entity extraction, and daily briefings via Ollama, OpenAI, or custom endpoints\n- **Smart Alert System** — Rule-based alerts with deduplication, geofence triggers, and desktop notifications\n\n### Tracking \u0026 Monitoring\n- **Flight Tracking** — Real-time aircraft positions via OpenSky Network with military aircraft filtering\n- **Vessel Tracking** — Maritime vessel positions with route visualization\n- **Satellite Tracking** — Active satellite positions via CelesTrak TLE data\n- **Earthquake Monitoring** — USGS real-time earthquake data with magnitude filtering\n- **Natural Disaster Alerts** — GDACS integration for floods, storms, and volcanic activity\n\n### Security Intelligence\n- **Cyber Threat Feeds** — Real-time CVEs, ransomware tracking, APT group monitoring\n- **Dark Web Monitoring** — Alert aggregation from dark web sources\n- **IoC Extraction** — Automatic extraction of IPs, domains, hashes, and URLs from text\n- **SIGINT/RF Events** — Signal intelligence and radio frequency event monitoring\n- **Sanctions Screening** — Real-time sanctions list checking\n\n### Analysis Tools\n- **Operations Console** — Advanced search, bookmarks, threads, and annotation management\n- **Anomaly Detection** — Statistical anomaly detection with cascade alert system\n- **Predictive Risk Scoring** — ML-based risk predictions by region and domain\n- **Entity Relationship Graphs** — Interactive force-directed entity network visualization\n- **Finance Dashboard** — Forex, crypto, commodities, and stock market tracking\n\n### Platform Features\n- **Offline-First Architecture** — SQLite-backed local cache, works without internet\n- **Multi-Window Support** — Detach panels to secondary monitors\n- **Companion Server** — WebSocket server for mobile companion app\n- **Multi-Language** — English and Turkish UI (extensible)\n- **Configurable Layers** — Toggle 20+ data overlay layers independently\n- **TTS Alerts** — Text-to-speech for critical notifications\n\n## Installation\n\n### Download Pre-built Binaries\n\nDownload the latest release for your platform from the [Releases](https://github.com/0xhav0c/ARGUS/releases) page:\n\n| Platform | Format |\n|----------|--------|\n| Windows  | `.exe` (NSIS installer) |\n| macOS    | `.dmg` |\n| Linux    | `.AppImage` |\n\n### Build from Source\n\n#### Prerequisites\n\n- [Node.js](https://nodejs.org/) \u003e= 18.x\n- [Git](https://git-scm.com/)\n- Python 3.x (for native module compilation)\n- C++ build tools (for `better-sqlite3`)\n  - **Windows**: `npm install -g windows-build-tools` or Visual Studio Build Tools\n  - **macOS**: `xcode-select --install`\n  - **Linux**: `sudo apt install build-essential python3`\n\n#### Steps\n\n```bash\n# Clone the repository\ngit clone https://github.com/0xhav0c/ARGUS.git\ncd ARGUS\n\n# Install dependencies\nnpm install\n\n# Copy Cesium static assets\nnpm run setup-cesium\n\n# Start in development mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Package for distribution\nnpm run dist\n```\n\n## Development\n\n```bash\nnpm run dev          # Start with hot-reload\nnpm run build        # Production build\nnpm run lint         # Run ESLint\nnpm run lint:fix     # Fix linting issues\nnpm run typecheck    # TypeScript type checking\nnpm run test         # Run tests\nnpm run test:watch   # Run tests in watch mode\n```\n\n### Project Structure\n\n```\nsrc/\n├── main/                   # Electron main process\n│   ├── index.ts            # App entry, IPC handlers, service init\n│   ├── database/           # SQLite schema \u0026 cache manager\n│   ├── ipc/                # IPC handler modules\n│   └── services/           # Backend services\n│       ├── feed-aggregator.ts      # RSS/API feed aggregation\n│       ├── tracking-service.ts     # Flight, vessel, earthquake tracking\n│       ├── ai-service.ts           # AI provider abstraction\n│       ├── cyber-threat-service.ts # CVE, ransomware feeds\n│       ├── anomaly-engine.ts       # Statistical anomaly detection\n│       └── ...                     # 20+ specialized services\n├── preload/                # Electron preload (context bridge)\n├── renderer/               # React frontend\n│   ├── components/\n│   │   ├── layout/         # AppShell, TopBar, StatusBar\n│   │   ├── globe/          # CesiumGlobe, overlays, tracking layers\n│   │   ├── pages/          # Operations, SecurityIntel, Media, Log\n│   │   ├── panels/         # IncidentDetail, Finance, EntityGraph\n│   │   └── dashboard/      # Dashboard widgets \u0026 settings\n│   ├── hooks/              # React hooks (useIncidents, useGlobeCamera)\n│   ├── stores/             # Zustand state management (15+ stores)\n│   ├── i18n/               # Internationalization (en, tr)\n│   └── data/               # Static data (countries, TV channels)\n└── shared/                 # Shared types between main \u0026 renderer\n```\n\n## Architecture\n\n```\n┌──────────────────────────────────────────────────┐\n│                  Electron Main                    │\n│  ┌────────────┐  ┌────────────┐  ┌────────────┐ │\n│  │   Feed     │  │  Tracking  │  │    AI      │ │\n│  │ Aggregator │  │  Services  │  │  Service   │ │\n│  └─────┬──────┘  └─────┬──────┘  └─────┬──────┘ │\n│        │               │               │         │\n│  ┌─────┴───────────────┴───────────────┴──────┐  │\n│  │              IPC Bridge                     │  │\n│  └─────────────────┬───────────────────────────┘  │\n└────────────────────┼──────────────────────────────┘\n                     │\n┌────────────────────┼──────────────────────────────┐\n│  Electron Renderer │                              │\n│  ┌─────────────────┴───────────────────────────┐  │\n│  │            Zustand Stores                    │  │\n│  │  incidents │ filters │ layers │ alerts │ ... │  │\n│  └──────┬─────────┬──────────┬────────┬────────┘  │\n│         │         │          │        │           │\n│  ┌──────┴─────────┴──────────┴────────┴────────┐  │\n│  │           React Components                   │  │\n│  │  Globe │ Dashboard │ Panels │ Operations     │  │\n│  └──────────────────────────────────────────────┘  │\n└───────────────────────────────────────────────────┘\n```\n\n### Tech Stack\n\n| Layer | Technology |\n|-------|-----------|\n| Framework | Electron 41 |\n| Frontend | React 19, TypeScript 6 |\n| State | Zustand 5 |\n| 3D Globe | CesiumJS |\n| Database | SQLite (better-sqlite3) |\n| Build | electron-vite, Vite 7 |\n| Styling | Tailwind CSS 4 + inline styles |\n| i18n | i18next |\n| Testing | Vitest |\n\n### API Keys (Optional)\n\nARGUS works without any API keys using public feeds. For enhanced data, configure keys in **Settings \u003e API Keys**:\n\n| Service | Purpose |\n|---------|---------|\n| OpenSky Network | Authenticated flight tracking (higher rate limits) |\n| Shodan | Internet device search |\n| AbuseIPDB | IP reputation checking |\n| VirusTotal | Malware/URL scanning |\n| OpenAI | AI-powered analysis (alternative to Ollama) |\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute.\n\n## License\n\nThis project is licensed under the **GNU Affero General Public License v3.0** — see the [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\nARGUS is an OSINT tool designed for legitimate security research and situational awareness. All data is sourced from publicly available feeds and APIs. Users are responsible for complying with applicable laws and the terms of service of upstream data providers.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ccode\u003eelectron\u003c/code\u003e · \u003ccode\u003ereact\u003c/code\u003e · \u003ccode\u003etypescript\u003c/code\u003e · \u003ccode\u003ecesiumjs\u003c/code\u003e · \u003ccode\u003eosint\u003c/code\u003e · \u003ccode\u003ecybersecurity\u003c/code\u003e · \u003ccode\u003ethreat-intelligence\u003c/code\u003e · \u003ccode\u003edesktop-app\u003c/code\u003e · \u003ccode\u003esqlite\u003c/code\u003e · \u003ccode\u003ezustand\u003c/code\u003e · \u003ccode\u003evite\u003c/code\u003e · \u003ccode\u003e3d-globe\u003c/code\u003e · \u003ccode\u003ereal-time\u003c/code\u003e · \u003ccode\u003eflight-tracking\u003c/code\u003e · \u003ccode\u003egeospatial\u003c/code\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eBuilt with ⚡ by \u003ca href=\"https://github.com/0xhav0c\"\u003e0xhav0c\u003c/a\u003e\u003c/sub\u003e\n\u003c/p\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xhav0c%2Fargus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xhav0c%2Fargus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xhav0c%2Fargus/lists"}