Phalanx: An Open‑Source Autonomous Pentesting Assistant for Kali Linux

Polyglot Harness Architecture

Phalanx implements a “Polyglot Harness” that coordinates and schedules scripts written in different languages (e.g., Python, Bash). This removes the limitation of single‑language libraries and lets users integrate vulnerability checks developed in any language.

Highly Automated Penetration Workflow

The automation loop consists of three core Python modules:

phalanx_planner.py – analyses target information and dynamically plans attack paths.

phalanx_engine.py – carries out scans and executes tasks automatically.

phalanx_reporting.py – generates penetration logs and result reports without manual documentation.

Integration and Extensibility

Key helper modules provide rapid integration with existing Kali tools:

phalanx_tools.py – wrappers for tools such as Nmap and Metasploit, enabling direct invocation from Phalanx.

phalanx_interactive.py – supports manual intervention and interactive mode, allowing a switch between fully automated and semi‑automatic execution for complex logical vulnerabilities.

Kali Linux Ecosystem Support

Optimized for Kali, Phalanx can call Linux kernel features and the pre‑installed security environment. A simple run.sh script together with docker-compose files provides rapid configuration and reduces environment‑setup complexity.

Traceability and Auditing

During execution Phalanx creates a soul.md file and a detailed log directory ( .phalanx/). This “digital trace” model enables back‑tracking of attack steps, compliance auditing, and teaching use cases.

Project Status

The project is at version 3.2 and remains actively developed, although some documentation is still being refined.

Repository: https://github.com/webxos/phalanx