Installation

Requirements

driftmux is a Python project that orchestrates external security tools. Depending on the features you want to use, you may need:

Python 3.10 or newer;
Nmap;
Nuclei if profile fast or deep is selected, not used in default passive;
Plecost, if WordPress checks are enabled;
internet access for vulnerability enrichment backends such as NVD.

Install from source

Clone the repository:

git clone https://github.com/aidaph/driftmux.git
cd driftmux

Create a virtual environment:

python -m venv .venv
source .venv/bin/activate

Install the project in editable mode:

pip install -e .

Check that the CLI is available:

driftmux --help

Install Nmap

On Debian/Ubuntu systems:

sudo apt update
sudo apt install nmap

Check the installation:

nmap --version

Install Nuclei

Install Nuclei following the official ProjectDiscovery installation method for your platform, then verify:

nuclei -version

If Nuclei is not installed or not available in PATH, driftmux will still run the rest of the pipeline and report the Nuclei error in the final result.

Optional: OS detection

Nmap OS detection usually requires elevated privileges:

sudo nmap -sS -O -Pn example.org

In driftmux, OS detection should be treated as an optional capability because it can be noisier than basic service discovery.