# Sparrow Wifi

> Auth/lab ref: Linux Wi-Fi and Bluetooth analyzer with GPS, remote agent, JSON API, and SDR integrations including HackRF One and Ubertooth.

- Skill: `aeondave/sparrow-wifi` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aeondave/sparrow-wifi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aeondave/sparrow-wifi/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: GPL-3.0
- Author: AeonDave (https://skillmd.com/u/aeondave)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aeondave/sparrow-wifi

---


# Sparrow-WiFi

Integrated Wi‑Fi / Bluetooth / SDR analysis platform for Linux with optional remote agent and HackRF/Ubertooth workflows.

## Why Use Sparrow-WiFi

Choose Sparrow when you need one platform for:
- Wi‑Fi scanning plus Bluetooth awareness
- source hunting / telemetry workflows
- spectrum overlays with HackRF One or Ubertooth One
- remote scanning via a JSON REST agent
- mobile, Pi, drone, or rover-mounted sensors

## Quick Start

```bash
# install deps (common Linux/Kali/Debian path)
git clone https://github.com/ghostop14/sparrow-wifi
cd sparrow-wifi
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# run desktop app
sudo venv/bin/python3 ./sparrow-wifi.py
```

## Core Modes

| Component | Use |
|---|---|
| `sparrow-wifi.py` | Desktop GUI for Wi‑Fi/BT/spectrum awareness |
| `sparrowwifiagent.py` | Headless HTTP agent for remote sensors |
| `sparrow-droneid` | Drone RemoteID Wi‑Fi/BLE detection workflow |
| `sparrow-elastic.py` | Optional Elasticsearch / OpenSearch bridge |

## Hardware-Aware Use Cases

### Standard adapter only
- Wi‑Fi scanning
- BLE advertisement scanning
- GPS-assisted mapping

### With HackRF One
- 2.4 GHz and 5 GHz spectral overlays
- broader RF awareness alongside Wi‑Fi scans

### With Ubertooth One
- 2.4 GHz spectrum and deeper Bluetooth visibility

## Remote Agent Workflow

```bash
sudo ./sparrowwifiagent.py
# default API port 8020
```

Example API calls:

```bash
curl http://sensor:8020/wireless/interfaces
curl http://sensor:8020/wireless/networks/wlan0
curl http://sensor:8020/bluetooth/discoverystarta
curl http://sensor:8020/bluetooth/discoverystatus
```

## Why It Belongs in Wireless

Sparrow fills the gap not covered by the current category:
- Bluetooth-first workflows
- HackRF/Ubertooth-assisted spectrum analysis
- remote/headless wireless sensor deployment
- JSON/API-friendly automation

## Relationship to Other Skills

| Skill | Best use |
|---|---|
| `kismet` | Passive WIDS / long-running passive RF logging |
| `aircrack-ng` | Focused Linux monitor-mode capture and cracking workflows |
| `bluez` | Core Bluetooth CLI operations |
| `sparrow-wifi` | Combined Wi‑Fi/Bluetooth/SDR awareness with APIs and sensors |

## Resources

| File | When to load |
|---|---|
| `references/hackrf-bluetooth-agent-workflows.md` | For HackRF One, Bluetooth, remote agent, API, and hardware-selection workflows |