Skip to main content

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.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aegis-node 0.6.0
File Size Uploaded Provenance Actions
aegis_node-0.6.0.tar.gz 45.0 kB Without provenance Details for aegis_node-0.6.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aegis-node 0.6.0
File Interpreter ABI Platform Actions
aegis_node-0.6.0-py3-none-any.whl Python 3 none any Details for aegis_node-0.6.0-py3-none-any.whl

Total release size: 90.9 kB

Release files / aegis_node-0.6.0.tar.gz

Download URL aegis_node-0.6.0.tar.gz
Size 45.0 kB
Tags Source
SHA-256 checksum
How to use checksums
ba2da6bbe2af6185aa1f0c06c179b3e7c1dc0824d04b55910ac80848e8d54298
BLAKE2b-256 checksum
How to use checksums
509e525c1633fc8fd1eb8294aeeb7fd49bbf3ebaa3a36ed1bb0b09d0e9ad4935
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.6.0-py3-none-any.whl

Download URL aegis_node-0.6.0-py3-none-any.whl
Size 45.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7b3f3dcdb10078a01843891250b1366a4e3876bb79a81bdb2e776042e6eb7113
BLAKE2b-256 checksum
How to use checksums
345d28606e33e6cfc5d84716576761e87a3ff38e789cce6e324675c4b4b0c66f
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.6.0

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page