A QIIME 2 plugin developed by Colin Wood ([email protected]). 🔌
Important: This package should be considered alpha software¶
Because the underlying qSIP2 package is relatively new and only cursory user testing & validation of this software has been performed, the package should be considered experimental.
Installation instructions¶
Install Prerequisites¶
Miniconda provides the conda environment and package manager, and is currently the only supported way to install QIIME 2.
Follow the instructions for downloading and installing Miniconda.
After installing Miniconda and opening a new terminal, make sure you’re running the latest version of conda:
conda update condaInstall development version of q2-qsip2¶
Next, you need to get into the top-level q2-qsip2 directory.
You can achieve this by cloning the repository, for example with the command:
git clone https://github.com/caporaso-lab/q2-qsip2Once you have the directory on your computer, change (cd) into it.
If you’re in a conda environment, deactivate it by running conda deactivate.
Then, run:
conda env create -n q2-qsip2-dev --file ./environments/q2-qsip2-qiime2-amplicon-2026.1.ymlAfter this completes, activate the new environment you created by running:
conda activate q2-qsip2-devFinally, run:
make installTesting and using the most recent development version of q2-qsip2¶
After completing the install steps above, confirm that everything is working as expected by running:
make testYou should get a report that tests were run, and you should see that all tests passed and none failed. It’s usually ok if some warnings are reported.
If all of the tests pass, you’re ready to use the plugin.
Start by making QIIME 2’s command line interface aware of q2-qsip2 by running:
qiime dev refresh-cacheYou should then see the plugin in the list of available plugins if you run:
qiime infoYou should be able to review the help text by running:
qiime qsip2 --helpAccessing the usage tutorial¶
You can find instructions for performing an example analysis with q2-qsip2 in the tutorial. The data files that you’ll need to run that tutorial can be downloaded from the directory containing the tutorial.
Have fun! 😎
About¶
The q2-qsip2 Python package was created from template.
To learn how to use QIIME 2, refer to the QIIME 2 User Documentation.
To learn QIIME 2 plugin development, refer to Developing with QIIME 2.
q2-qsip2 is a QIIME 2 community plugin.
More information on development and support for community plugins can be found here.
If you need help with a community plugin, first refer to the project website.
If that page doesn’t provide information on how to get help, or you need additional help, head to the Community Plugins category on the QIIME 2 Forum where the QIIME 2 developers will do their best to help you.
- Links
- Documentation
- Source Code
- Stars
- 1
- Last Commit
- dbedb02
- Available Distros
- 2026.1
- 2026.1/amplicon