Aegis WiFi Node Agent
Connect a local USB WiFi adapter to the Aegis pentest platform for wireless network assessments.
Install
pipx install aegis-node
If pipx is not available:
pip install --user aegis-node
Quick start
# 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 |
Metadata
Release files for aegis-node 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aegis_node-0.2.1.tar.gz | 36.0 kB | Without provenance | Details for aegis_node-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aegis_node-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for aegis_node-0.2.1-py3-none-any.whl |
Total release size: 72.6 kB
Release files / aegis_node-0.2.1.tar.gz
| Download URL | aegis_node-0.2.1.tar.gz |
|---|---|
| Size | 36.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eedee0b81f824bda69f75152b9126bc618437ecbc95816251478a9fd7b81388c
|
|
BLAKE2b-256 checksum How to use checksums |
646f9785d32d5a998d63f17dfbef3e559d2816944004026fcf314ec9f79d4829
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.17
|
Release files / aegis_node-0.2.1-py3-none-any.whl
| Download URL | aegis_node-0.2.1-py3-none-any.whl |
|---|---|
| Size | 36.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
02fd629685a6a7004b75d46e900d26cfec471a6b294c35a7a2862c0b68ce4f4b
|
|
BLAKE2b-256 checksum How to use checksums |
8657f39bade88180a076f46e84fdc6d3967b1b7bbda7de8819db84c5240dcd9d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.17
|
Security for aegis-node 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.