# \[Preview\] QIIME 2 2026.4 breaking changes & environment files

**URL:** <https://forum.qiime2.org/t/preview-qiime-2-2026-4-breaking-changes-environment-files/33942>\
**Category:** Developer Announcements\
**Tags:** breaking-changes, preview, environment-files\
**Created:** [January 30, 2026, 10:25am UTC](https://forum.qiime2.org/t/preview-qiime-2-2026-4-breaking-changes-environment-files/33942 "2026-01-30T10:25:02Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![lizgehret](https://forum.qiime2.org/user_avatar/forum.qiime2.org/lizgehret/32/17128_2.png) [@lizgehret](https://forum.qiime2.org/u/lizgehret)\
**Post date:** [January 30, 2026, 10:25am UTC](https://forum.qiime2.org/t/preview-qiime-2-2026-4-breaking-changes-environment-files/33942/1 "2026-01-30T10:25:03Z")

</div>

## Environment files for 2026.4 have been released! Please see the [official announcement](https://forum.qiime2.org/t/qiime-2-2026-4-environment-files/34077) for more details.

> **See original content of post**
>
> # **❗ Important ❗**
> 
> **The following is an early developer preview of all interface & API changes expected in 2026.4, as well as a list of our targeted environment file updates.**
> 
> Changes will be added up until **February 27th** (for tiny & amplicon distros); we will post a formal announcement for our developer community shortly thereafter with finalized details.
> 
> * * *
> 
> **Interface Changes 📺**
> 
> * * *
> 
> **Plugin API Changes 🔌**
> 
> * * *
> 
> **Environment File Changes 🗃**
> 
> **TINY**
> 
> - biom-format=2.1.17
> - h5py=3.15.1
> - hdf5=1.14.6
> - networkx=3.6.1
> - numpy=2.4.2
> - pandas=2.3.3
> - parsl=2026.2.23
> - python=3.12
> - r-base=4.5.2
> - r-reticulate=1.45.0
> - scikit-bio=0.7.2
> - scikit-learn=1.7.1
> - scipy=1.17.1
> - tzlocal=5.3.1
> - unifrac-binaries=1.5.1
> - unifrac=1.5.1
> 
> **AMPLICON** (_plus all changes from tiny_)
> 
> - blast=2.17.0
> - fastp=1.0.1
> - matplotlib=3.10.8
> - ncbi-datasets-pyclient=18.18.0
> - patsy=1.0.2
> - pillow=12.1.1
> - r-vegan=2.7\_3
> - rpy2=3.6.4
> - samtools=1.22.1
> - seaborn=0.13.2
> - sepp=4.5.6
> - statsmodels=0.14.6
> - tqdm=4.67.3
> 
> **MOSHPIT** (_plus all changes from tiny_\*)  
> \*_ **NOTE** _: _The required r-base version for these updates led to a downgrade from 4.5.2 (used in tiny and amplicon) to 4.4.2. The only overlapping plugin affected in both amplicon and moshpit is q2-quality-control (via decontam). The decontam versions from both r-base releases were reviewed and showed no breaking changes, bugs, or meaningful behavioral differences, so usage of q2-quality-control should remain consistent between amplicon and moshpit._
> 
> - bigscape=2.0.2
> - biopython=1.86
> - bowtie2=2.5.5
> - das\_tool=1.1.7
> - eggnog-mapper=2.1.12
> - entrezpy=2.1.3
> - matplotlib=3.9.1
> - metabat2=2.18
> - multiqc=1.33
> - ncbi-datasets-pyclient=18.18.0
> - pyarrow=16.1.0
> - pysam=0.23.3
> - r-base=4.4.2
> - samtools=1.22.1
> - seaborn=0.13.2
> - semibin=2.2.0
> - sepp=4.5.6
> - spades=4.2.0
> - tqdm=4.67.3
> - vamb=5.0.4
> 
> **PATHOGENOME** (_plus all changes from tiny_)
> 
> - genomad=1.11.2
> - matplotlib=3.10.8
> - prodigal=2.6.3
> - pyarrow=16.1.0
> - seaborn=0.13.2
> - screed=1.0.4
> - spades=4.2.0
> - tqdm=4.67.3

---

<div class="post-metadata">

**Author:** ![colinbrislawn](https://forum.qiime2.org/user_avatar/forum.qiime2.org/colinbrislawn/32/6221_2.png) [@colinbrislawn](https://forum.qiime2.org/u/colinbrislawn)\
**Post date:** [March 19, 2026, 2:14pm UTC](https://forum.qiime2.org/t/preview-qiime-2-2026-4-breaking-changes-environment-files/33942/10 "2026-03-19T14:14:48Z")

</div>

Installing on WSL:

```css
(base) biouser@home-PC:~$ conda env create -n qiime2-amplicon-2026.4 -f https://raw.githubusercontent.com/qiime2/distributions/refs/heads/dev/2026.4/amplicon/passed/qiime2-amplicon-linux-64-conda.yml

Channels:
 - conda-forge
 - bioconda
 - https://packages.qiime2.org/qiime2/2026.4/amplicon/passed
Platform: linux-64
Collecting package metadata (repodata.json): done
Solving environment: done

Downloading and Extracting Packages:
                                                                                                                                                                                        
Preparing transaction: done                                                                                                                                                             
Verifying transaction: done                                                                                                                                                             
Executing transaction: done
                                                                                                                              
ERROR conda.core.link:_execute(1033): An error occurred while installing package 'conda-forge::openmpi-4.1.6-hc5af2df_101'.                                                             
Rolling back transaction: done                                                                                                                                                          
                                                                                                                                                                                        
LinkError: post-link script failed for package conda-forge::openmpi-4.1.6-hc5af2df_101                                                                                                  
location of failed script: /home/biouser/miniconda3/envs/qiime2-amplicon-2026.4/bin/.openmpi-post-link.sh                                                                               
==> script messages <==                                                                                                                                                                 
<None>                                                                                                                                                                                  
==> script output <==                                                                                                                                                                   
stdout:                                                                                                                                                                                 
stderr:                                                                                                                                                                                 
return code: 1                                 

```

I went to check `/home/biouser/miniconda3/envs/qiime2-amplicon-2026.4/bin/.openmpi-post-link.sh` but it was removed during the rollback.

Looks like others have got this error before. I'm using an older WSL:

```css
(base) biouser@home-PC:~$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 20.04.6 LTS
Release: 20.04
Codename: focal

```

---

<div class="post-metadata">

**Author:** ![lizgehret](https://forum.qiime2.org/user_avatar/forum.qiime2.org/lizgehret/32/17128_2.png) [@lizgehret](https://forum.qiime2.org/u/lizgehret)\
**Post date:** [March 19, 2026, 2:34pm UTC](https://forum.qiime2.org/t/preview-qiime-2-2026-4-breaking-changes-environment-files/33942/12 "2026-03-19T14:34:42Z")

</div>

Hey @colinbrislawn,

I'm not entirely sure what the issue is here, but it looks like it's similar to what others have run into on osx with the latest version of conda. Try downgrading to conda 25.11.1 to see if this fixes the issue. That being said, these development environments are still in flux - so this may also be a transient issue that will be resolved with the final dependency updates/etc that I'm currently working on.

---

<div class="post-metadata">

**Author:** ![colinbrislawn](https://forum.qiime2.org/user_avatar/forum.qiime2.org/colinbrislawn/32/6221_2.png) [@colinbrislawn](https://forum.qiime2.org/u/colinbrislawn)\
**Post date:** [March 19, 2026, 3:21pm UTC](https://forum.qiime2.org/t/preview-qiime-2-2026-4-breaking-changes-environment-files/33942/13 "2026-03-19T15:21:57Z")

</div>

Yes, installing conda 25.11 fixed it!  
I saw those other threads, but forgot about them until I was back on Linux!  
Thank you for your time, Liz. Feel free to split this thread, if that's helpful.