# No full uniref90 db in humann4

**URL:** <https://forum.biobakery.org/t/no-full-uniref90-db-in-humann4/8807>\
**Category:** HUMAnN\
**Created:** [February 28, 2026, 6:48am UTC](https://forum.biobakery.org/t/no-full-uniref90-db-in-humann4/8807 "2026-02-28T06:48:14Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![XiaoluLIU11](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/xiaoluliu11/32/3586_2.png) [@XiaoluLIU11](https://forum.biobakery.org/u/XiaoluLIU11)\
**Post date:** [February 28, 2026, 6:48am UTC](https://forum.biobakery.org/t/no-full-uniref90-db-in-humann4/8807/1 "2026-02-28T06:48:14Z")

</div>

I submitted a question on the forum:  
Currently using humann version 4.0.0a1. While downloading the database, I noticed the available databases are as follows:

HUMAnN Databases ( database : build = location )  
chocophlan : full = [http://huttenhower.sph.harvard.edu/humann\_data/chocophlan/chocophlan.v4\_alpha.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/chocophlan/chocophlan.v4_alpha.tar.gz)  
chocophlan : ec\_filtered = [http://huttenhower.sph.harvard.edu/humann\_data/chocophlan/chocophlan\_EC\_FILTERED.v4\_alpha.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/chocophlan/chocophlan_EC_FILTERED.v4_alpha.tar.gz)  
uniref : uniref90\_ec\_filtered\_diamond = [http://huttenhower.sph.harvard.edu/humann\_data/uniprot/uniref\_ec\_filtered/uniref90\_annotated\_v4\_alpha\_ec\_filtered.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_ec_filtered/uniref90_annotated_v4_alpha_ec_filtered.tar.gz)  
utility\_mapping : full = [http://huttenhower.sph.harvard.edu/humann\_data/full\_mapping\_v4\_alpha.tar.gz](http://huttenhower.sph.harvard.edu/humann_data/full_mapping_v4_alpha.tar.gz)

Among these, uniref only offers uniref90\_ec\_filtered\_diamond. I noticed the tutorial recommends downloading uniref90\_diamond, but it seems this is not valid for humann4.

Since the 2019 version is too old, but the current uniref90 is also a filtered version, is there a suitable full version of uniref90 for humann4?

---

<div class="post-metadata">

**Author:** ![XiaoluLIU11](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/xiaoluliu11/32/3586_2.png) [@XiaoluLIU11](https://forum.biobakery.org/u/XiaoluLIU11)\
**Post date:** [February 28, 2026, 7:24am UTC](https://forum.biobakery.org/t/no-full-uniref90-db-in-humann4/8807/2 "2026-02-28T07:24:16Z")

</div>

**Update on this issue:**

I later checked the HUMAnN 4.0.0.alpha.1 release notes and confirmed that there is indeed no full version of UniRef90 available yet, only the filtered version (uniref90\_ec\_filtered\_diamond). It seems we’ll need to wait for the official release to get the complete version.

**New issue encountered:**

When running humann, I’m getting the following error:

CRITICAL ERROR: Can not call software version for metaphlan

However, I’ve confirmed that metaphlan is working properly:

(biobakery) $ metaphlan -v  
MetaPhlAn version 4.2.4 (21 Oct 2025)  
Installed databases: mpa\_vJan25\_CHOCOPhlAnSGB\_202503

My environment details:

- Using a biobakery environment created with conda/mamba

- MetaPhlAn database installed in the default mamba environment location

- HUMAnN version: 4.0.0.alpha.1

- MetaPhlAn version: 4.2.4

Does anyone know what might be causing this “Can not call software version for metaphlan” error? Could this be a compatibility issue between HUMAnN 4.0.0.alpha.1 and the latest MetaPhlAn 4.2.4?

Looking at the release notes, HUMAnN 4.0.0.alpha.1 requires MetaPhlAn 4.0 and a specific database version (mpa\_vOct22\_CHOCOPhlAnSGB\_202403), but I have newer versions installed. Could this be the problem?

---

<div class="post-metadata">

**Author:** ![Longhao\_Jia](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/longhao_jia/32/3610_2.png) [@Longhao\_Jia](https://forum.biobakery.org/u/Longhao_Jia)\
**Post date:** [March 30, 2026, 2:11am UTC](https://forum.biobakery.org/t/no-full-uniref90-db-in-humann4/8807/3 "2026-03-30T02:11:16Z")

</div>

I get the same error. No full uniref90 db in humann4.

```auto
(HUMAnN4) [jialonghao@admin databases]$ humann_databases --download uniref uniref90_diamond HUMAnN4_database
ERROR: Please select an available build.
(HUMAnN4) [jialonghao@admin databases]$ humann_databases -help
usage: humann_databases [-h] [--available] [--download <database> <build> <install_location>] [--update-config {yes,no}]
                        [--database-location DATABASE_LOCATION]

HUMAnN Databases

options:
  -h, --help show this help message and exit
  --available print the available databases
  --download <database> <build> <install_location>
                        download the selected database to the install location
  --update-config {yes,no}
                        update the config file to set the new database as the default [DEFAULT: yes]
  --database-location DATABASE_LOCATION
                        location (local or remote) to pull the database
(HUMAnN4) [jialonghao@admin databases]$ humann_databases --available
HUMAnN Databases ( database : build = location )
chocophlan : full = http://huttenhower.sph.harvard.edu/humann_data/chocophlan/chocophlan.v4_alpha.tar.gz
chocophlan : ec_filtered = http://huttenhower.sph.harvard.edu/humann_data/chocophlan/chocophlan_EC_FILTERED.v4_alpha.tar.gz
uniref : uniref90_ec_filtered_diamond = http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_ec_filtered/uniref90_annotated_v4_alpha_ec_filtered.tar.gz
utility_mapping : full = http://huttenhower.sph.harvard.edu/humann_data/full_mapping_v4_alpha.tar.gz
(HUMAnN4) [jialonghao@admin databases]$ humann_databases --download uniref uniref90_ec_filtered_diamond HUMAnN4_database
Creating subdirectory to install database: /public/home/jialonghao/GMMdb/databases/HUMAnN4_database/uniref
Download URL: http://huttenhower.sph.harvard.edu/humann_data/uniprot/uniref_ec_filtered/uniref90_annotated_v4_alpha_ec_filtered.tar.gz
0.87 GB         
Extracting: /public/home/jialonghao/GMMdb/databases/HUMAnN4_database/uniref90_annotated_v4_alpha_ec_filtered.tar.gz

Database installed: /public/home/jialonghao/GMMdb/databases/HUMAnN4_database/uniref

HUMAnN configuration file updated: database_folders : protein = /public/home/jialonghao/GMMdb/databases/HUMAnN4_database/uniref

```
