Installation Guide

System Requirements

We strongly recommend using a virtual environment.

Install the latest stable release:

pip install ChameleonIQ

Clone and install in development mode:

git clone https://github.com/EdAlita/ChameleonIQ.git
cd ChameleonIQ
pip install -e .

For development with additional tools:

pip install -e ".[dev]"

Check available commands, all of them begin with chameleoniq_:

chameleoniq_quant --help

Run the test suite (dev installs):

pytest tests/

If you encounter import errors:

pip install --upgrade --force-reinstall ChameleonIQ

Using venv:

python -m venv chameleon_env
source chameleon_env/bin/activate  # On Windows: chameleon_env\Scripts\activate
pip install ChameleonIQ

Using conda:

conda create -n chameleon python=3.11
conda activate chameleon
pip install ChameleonIQ

Installed commands include both the short and branded names: