Skip to content

Installation

QLens requires Python 3.10 or newer.

Linux and macOS

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
pip install -e ".[docs,dev]"

Enable AI and the local NUR bridge:

pip install -e ".[docs,dev,ai,server]"

Windows PowerShell

py -3.10 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -e ".[docs,dev,ai,server]"

Verify

qlens --version
qlens doctor
qlens validate

Source execution fallback

When editable installation is unavailable in an offline environment:

PYTHONPATH=src python -m qlens --version
PYTHONPATH=src python -m qlens doctor

PowerShell:

$env:PYTHONPATH = "src"
python -m qlens --version