Argos Edge

Quick Start · Docs · Architecture · Configuration · Security

What is Argos?

Argos wraps the native SDR and network-analysis CLIs you already trust — hackrf_sweep, Kismet, gpsd, grgsm — behind a single Svelte 5 dashboard, streaming every tool to one operator view over WebSocket and SSE. It runs natively on an NVIDIA Jetson AGX Orin or a Raspberry Pi 5 in the field, so the whole RF and network picture lives in one place instead of a dozen terminals.

Quick Start

git clone https://github.com/christianpeirson/argos-edge.git
cd argos-edge
sudo bash scripts/ops/setup-host.sh   # installs host tools + services, generates .env
npm install
npm run dev

Open http://<host-ip>:5173 — you should see the tactical dashboard. For prerequisites and the production (systemd) deploy, see Installation.

[!WARNING] Argos integrates offensive, signals-intelligence, and electronic-warfare tooling intended for authorized training, research, and testing only. Transmitting on regulated spectrum and capturing third-party traffic are illegal without authorization. You are solely responsible for compliance with all applicable laws, radio licenses, and rules of engagement.

Capabilities

Concrete, not aspirational — each row is wired to real tools today.

Hardware Requirements

Installation

Prerequisites: Node >=22.11, git, and sudo on a fresh host.

Primary path — native host (Jetson AGX Orin / Ubuntu 22.04). Follow the canonical guide: docs/install/jetson-aarch64.md. In summary:

1. sudo bash scripts/ops/setup-host.sh — installs Node, Kismet, gpsd, udev rules, and the third-party tool containers; generates .env.
2. Configure .env (see Configuration).
3. npm run build, then deploy via systemd: sudo bash scripts/ops/install-services.sh and systemctl start argos-final.

Alternate path — Raspberry Pi 5 / Kali. See SETUP.md.

Docker is used only for third-party tools (OpenWebRX, NovaSDR, Bettercap). The Argos app itself runs natively on adapter-node (scripts/ops/prod-server.ts), not in a container.

Architecture

SDR / network hardware (HackRF, USRP, Wi-Fi, GPS)
  → native CLI tool wrappers (hackrf_sweep, Kismet, gpsd, grgsm)
  → Node server + SvelteKit (adapter-node, custom ws/upgrade handler)
  → real-time transport (WebSocket + SSE)
  → Svelte 5 dashboard (runes + IBM Carbon)

Built on: HackRF · Kismet · gpsd · gr-gsm · OpenWebRX · GNU Radio · MapLibre · Leaflet · TAK.

See ADR-0001 for the framework rationale and ADR-0006 for the IBM Carbon UI decision.

SDR Options

Configuration

Runtime configuration is via environment variables — copy .env.example to .env. All variables are validated at startup in src/lib/server/env.ts, and the setup script generates the required values on first run.

Gallery

Live status bar — WiFi / SDR / GPS / TAK status with MGRS grid and Zulu time

Documentation

• Getting started — Jetson install guide · SETUP.md
• Guides — Database · WebSocket/SSE · Deployment · MCP servers
• Operations — docs/operations/ (survey runbook, memory reliability)
• Architecture decisions — docs/adr/ (ADR 0001–0006)

Resources & Reference

• Jetson port notes — aarch64/Tegra specifics
• CI/CD pipeline spec — branch model, gates, and required checks
• Architecture Decision Records — the design-rationale log
• Lineage — Argos began as a Jetson/aarch64 port of Graveside2022/Argos; this repository is the active line of development.

Troubleshooting

Contributing

Contributions are welcome — see CONTRIBUTING.md for the branch model, the local npm run verify gate, and commit conventions. Issue and PR templates live in .github/.

Security

See SECURITY.md for private vulnerability reporting. Argos integrates offensive and signals-intelligence tooling intended for authorized training, research, and testing only — you are responsible for compliance with all applicable laws and authorizations.

License

Argos is released under the MIT License — see LICENSE.