Argos
Cyberpunk-themed tactical communications interface for SDR, WiFi scanning, and TAK integration - TypeScript + SvelteKit + Vite + Tailwind CSS
Argos -- SDR & Network Analysis Console
Real-time spectrum analysis, WiFi intelligence, GPS tracking, and tactical mapping on a Raspberry Pi.
Hardware
- Raspberry Pi 5 (8GB RAM recommended, 64GB+ SD card)
- USB 3.0 powered hub (required -- the Pi cannot power all devices alone)
- HackRF One
- Alfa AWUS036AXML WiFi adapter
- USB GPS dongle (BU-353S4 or similar)
- Kali Linux installed on the Pi
Install
git clone https://github.com/Graveside2022/Argos.git
cd Argos
sudo bash scripts/setup-host.sh
This installs Docker, Portainer, builds container images, configures GPS, and sets up auto-start on boot. Run it once.
Deploy
- Open https://<your-pi-ip>:9443 in a browser (Portainer)
- Create an admin account on first login
- Go to Stacks > Add Stack, name it
argos - Paste the contents of
docker/docker-compose.portainer-dev.yml - Click Deploy the stack
Open Argos
Go to http://<your-pi-ip>:5173
Hardware Setup
Plug the Alfa adapter, HackRF, and GPS dongle into the powered USB hub, then connect the hub to the Pi. Argos detects hardware automatically. GPS needs 1--2 minutes for a first fix outdoors.
After Reboot
Everything starts automatically. Just open http://<your-pi-ip>:5173.
Troubleshooting
| Problem | Fix |
|---|---|
| No GPS fix | Go outside, wait 2 minutes |
| Page is blank | Check Portainer -- are containers running? |
| Alfa not detected | Unplug and replug the USB hub |
| HackRF not detected | Run hackrf_info on the Pi terminal |
| Port conflict | Run sudo lsof -i :5173 to find what's using it |
Development
See SETUP.md for development environment, commands, and project structure.
License
MIT
