QIIME 2 2022.2 is now available!

The QIIME 2 2022.2 release is now available! Thanks to everyone involved for their hard work!

As a reminder, our next planned QIIME 2 release is scheduled for April, 2022 (QIIME 2 2022.4), but please stay tuned for updates.

Check out the QIIME 2 2022.2 docs for details on installing the latest QIIME 2 release, as well as tutorials and other resources. Get in touch on the QIIME 2 Forum if you run into any issues!

Virtual machine builds will be available sometime this week (except for q2galaxy, its docker container is already published) - watch this topic thread for an update!

New Documentation:

This release is timed with the release of several QIIME 2 documentation projects that provide new ways to learn QIIME 2 now, and a glimpse into where we're headed with QIIME 2 documentation in the future.

Additional features:

  • QIIME 2 Framework
    • @ChrisKeefe made a handful of improvements/tweaks to Usage :hammer_and_wrench:
    • @ebolyen fixed an inconsistency in the view_type parameter of Usage.import_from_format, both string and classes are accepted as arguments now :2nd_place_medal:
    • Artifact API has now been renamed to the Python3 API :amphora::arrow_right::snake:
  • q2cli
    • @ebolyen fixed a bug in the Usage driver which resulted in a namespace collision :lady_beetle:
    • @ebolyen fixed an issue where the incorrect usage variable was returned for Usage.view_as_metadata :cockroach:
  • q2galaxy
    • When installing q2galaxy via the pre-built docker image, the conda environment is now already included. This results in a larger base image, but makes it far less likely that installation will fail. As a result, the first job will no longer take in excess of 40 minutes to complete :champagne::tada::confetti_ball::bento:
    • @ebolyen added a new Usage driver to automatically generate RST instructions for use within Galaxy tools and documentation :capital_abcd:
    • @ebolyen fixed an issue with string sanitization in the generated tools. (Unusual characters like ; would be silently converted, breaking functionality.) :cry::smiley:
    • @ebolyen added a new template function to provide an automatically nested and alphabetized tool_conf.xml file. See q2galaxy template tool-conf --help :nesting_dolls:
  • q2-sample-classifier
    • @misialq added cross-validation to KNN sample classification based on distance matrices :motorway:
  • q2-dada2
  • q2-longitudinal
    • @ebolyen added support for automatically quoting formula terms in linear-mixed-effects. Now column names like my-category will be quoted as Q('my-category') instead of raising an error. :crossed_swords:
  • q2-mystery-stew
    • @ebolyen added more sophisticated metadata interactions. Now tests include Usage.view_as_metadata and Usage.merge_metadata :stew:

Happy QIIMEing! :snowflake: :snowboarder:


Docker images for q2galaxy are available now. See installation instructions and video.

1 Like

Hi folks! The moment you've been waiting for has arrived! :partying_face: QIIME 2 virtual machines are now available! :computer: :fireworks:


Minor update:

A few OS-X dependencies were moved around and resulted in conda no longer resolving packages on OS-X. We've update the environment files to reflect the new dependencies and everything seems to be working as expected now. We've also re-solved the dependencies on linux as well to keep things consistent.

If you've been having issues installing this release on OS-X, delete your current environment file (qiime2-2022.2-py38-osx-conda.yml) and start the installation over by downloading the (now-updated) environment file.

If you have not had this issue, then no worries, there's nothing particularly notable about the dependency updates, and we are not aware of any related bugs impacting QIIME 2. This means you don't need to do anything if you already have a working install.

For the curious, here's how the dependencies were updated.


Hi guys, I am having some problems trying to update my VirtualBox to the qiime 2022.2.

When downloading the qiime 2022.2 image following the link "https://data.qiime2.org/distro/core/2022.2" (as recommended at "https://s3-us-west-2.amazonaws.com/qiime2-data/distro/core/virtualbox-images.txt"), I get all I would need to install the previous image, the downloaded file´s name is "QIIME 2 Core - 2021.11 (1638916567)". Maybe an amazon issue? is there any other way to obtain the qiime 2022.2 image for VirtualBox?

Thank you for making all these tools available for all =)
Best regards.

1 Like


We have a patch for the release that we are finishing up this week, as soon as all of the files are ready for it, I will build a new Vbox image and let you know when it is ready!

1 Like


Just to be clear, there is nothing you were doing wrong, the Virtual Box image that is available is the wrong one, but we will be uploading the correct one soon!

1 Like

Thanks a million @Keegan-Evans !
Best of lucks.