Installing q2-classo

Conda Environment

Create a dedicated conda environment for q2-classo:

# Create and activate QIIME 2 environment
# Example for macOS (Intel) - see other options at:
# https://library.qiime2.org/quickstart/amplicon#id-3-install-the-base-distributions-conda-environment
conda env create \
  --name qiime2-amplicon-2025.4 \
  --file https://raw.githubusercontent.com/qiime2/distributions/refs/heads/dev/2025.4/amplicon/released/qiime2-amplicon-macos-latest-conda.yml

# Activate the environment
conda activate qiime2-amplicon-2025.4

# Clone and install q2-classo
git clone https://github.com/bio-datascience/q2-classo-latest.git
cd q2-classo-latest
python setup.py install
python -m pip install --no-cache-dir -r requirements.txt
pip install -e .

# Refresh QIIME 2 cache
qiime dev refresh-cache

Docker Installation

Docker image of q2-classo is available through Docker Hub:

# Pull the Docker image
docker pull ovlasovets/q2-classo:latest

# Run q2-classo container with volume mapping for data
docker run -it -v $(pwd):/data ovlasovets/q2-classo:latest

# Alternative: Run specific analysis with data directory
docker run -it -v /path/to/your/data:/data ovlasovets/q2-classo:latest qiime classo --help

Verification

To verify that q2-classo is correctly installed:

# Check that classo is available
qiime classo --help