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