Metadata-Version: 2.1
Name: aegis-node
Version: 0.2.1
Summary: Aegis WiFi Node Agent — connect a local USB WiFi adapter to the Aegis pentest platform
Author-email: Divolt <hello@divoltbtc.com>
License: Proprietary
Project-URL: Homepage, https://divoltbtc.com
Project-URL: Documentation, https://portal.aegis.divoltbtc.com
Keywords: pentest,wifi,wireless,security,aegis
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28

# Aegis WiFi Node Agent

Connect a local USB WiFi adapter to the [Aegis](https://divoltbtc.com) pentest platform for wireless network assessments.

## Install

```bash
pipx install aegis-node
```

If pipx is not available:

```bash
pip install --user aegis-node
```

## Quick start

```bash
# 1. Check system readiness
aegis-node preflight

# 2. Auto-install missing tools (requires sudo)
aegis-node preflight --install

# 3. Connect to Aegis (opens browser for authorization)
aegis-node connect
```

The `connect` command opens your browser to authorize the device.
Confirm the verification code matches your terminal, click **Authorize Device**, and the agent connects automatically.

## Options

```
aegis-node connect                        # browser auth (default server)
aegis-node connect --no-browser           # print URL instead of opening browser
aegis-node connect --server URL           # custom server URL
aegis-node preflight                      # check adapter + tools
aegis-node preflight --install            # auto-install missing tools
```

## Requirements

- Linux (Kali recommended) or WSL2
- Python 3.9+
- USB WiFi adapter with monitor mode support (e.g., WIFISKY WS-980WG, Alfa AWUS036ACM)
- aircrack-ng, nmap, hashcat, tcpdump (auto-installed via `preflight --install`)

## Supported adapters

| Adapter | Chipset | Monitor | Inject | Bands |
|---------|---------|---------|--------|-------|
| WIFISKY WS-980WG | RTL8187L | Yes | Yes | 2.4 GHz |
| Alfa AWUS036ACM | MT7612U | Yes | Yes | 2.4+5 GHz |
| Alfa AWUS036ACH | RTL8812AU | Yes | Yes | 2.4+5 GHz |
| Alfa AWUS036NHA | AR9271 | Yes | Yes | 2.4 GHz |
