# Humann3 will not run demo due to database issue

**URL:** <https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477>\
**Category:** HUMAnN\
**Created:** [August 10, 2021, 2:58pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477 "2021-08-10T14:58:21Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![Lindsey](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lindsey/32/1084_2.png) [@Lindsey](https://forum.biobakery.org/u/Lindsey)\
**Post date:** [August 10, 2021, 2:58pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/1 "2021-08-10T14:58:21Z")

</div>

As far as I can tell, it is trying to run with a database that does not exist.  
This is the output:

Error message returned from metaphlan :

Downloading MetaPhlAn database  
Please note due to the size this might take a few minutes

Downloading [http://cmprod1.cibio.unitn.it/biobakery3/metaphlan\_databases/mpa\_v30\_CHOCOPhlAn\_201901b.tar](http://cmprod1.cibio.unitn.it/biobakery3/metaphlan_databases/mpa_v30_CHOCOPhlAn_201901b.tar)

Warning: Unable to download [http://cmprod1.cibio.unitn.it/biobakery3/metaphlan\_databases/mpa\_v30\_CHOCOPhlAn\_201901b.tar](http://cmprod1.cibio.unitn.it/biobakery3/metaphlan_databases/mpa_v30_CHOCOPhlAn_201901b.tar)

Downloading [http://cmprod1.cibio.unitn.it/biobakery3/metaphlan\_databases/mpa\_v30\_CHOCOPhlAn\_201901b.md5](http://cmprod1.cibio.unitn.it/biobakery3/metaphlan_databases/mpa_v30_CHOCOPhlAn_201901b.md5)

Warning: Unable to download [http://cmprod1.cibio.unitn.it/biobakery3/metaphlan\_databases/mpa\_v30\_CHOCOPhlAn\_201901b.md5](http://cmprod1.cibio.unitn.it/biobakery3/metaphlan_databases/mpa_v30_CHOCOPhlAn_201901b.md5)  
File “miniconda3/envs/humann/lib/python3.7/site-packages/metaphlan/metaphlan\_databases/mpa\_v30\_CHOCOPhlAn\_201901b.md5” not found!  
File “/miniconda3/envs/humann/lib/python3.7/site-packages/metaphlan/metaphlan\_databases/mpa\_v30\_CHOCOPhlAn\_201901b.tar” not found!  
MD5 checksums not found, something went wrong!

I am trying to run the humann3 demo, I have the databases downloaded, the most current versions and as far as I can tell there is no mpa\_v30\_CHOCOPhlAn\_201901b. How do I fix this?

Thank you in advance for your help.

---

<div class="post-metadata">

**Author:** ![franzosa](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/franzosa/32/3511_2.png) [@franzosa](https://forum.biobakery.org/u/franzosa)\
**Post date:** [August 10, 2021, 4:33pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/2 "2021-08-10T16:33:27Z")

</div>

(FYI I have relocated this question from the HUMAnN category to the MetaPhlAn category as it appears more directly related to the latter’s setup.)

---

<div class="post-metadata">

**Author:** ![Lindsey](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lindsey/32/1084_2.png) [@Lindsey](https://forum.biobakery.org/u/Lindsey)\
**Post date:** [August 11, 2021, 2:42pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/4 "2021-08-11T14:42:23Z")

</div>

I am actually pretty sure the error is being caused by HUMAnN, particularly because of this line of code in the humann.py:

database\_files=os.listdir(config.protein\_database)  
valid\_format\_database\_files=[]  
for file in database\_files:  
if not config.metaphlan\_3p0\_db\_matching\_uniref in file:  
sys.exit("\n\nCRITICAL ERROR: The directory provided for the translated database contains files ( “+file+” )"+  
" that are not of the expected version. Please install the latest version"+  
" of the database: "+config.metaphlan\_3p0\_db\_matching\_uniref)

---

<div class="post-metadata">

**Author:** ![Lindsey](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lindsey/32/1084_2.png) [@Lindsey](https://forum.biobakery.org/u/Lindsey)\
**Post date:** [August 11, 2021, 2:45pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/5 "2021-08-11T14:45:44Z")

</div>

And this which is in the config.py:

# metaphlan options

metaphlan\_opts=[“-t”,“rel\_ab”]  
metaphlan\_version={  
“flag” : “–version”,  
“major” : 3,  
“minor” : 0,  
“line” : -1,  
“column” : 2}  
metaphlan\_3p0\_db\_version=“v30”  
metaphlan\_3p0\_db\_matching\_uniref=“201901b”

---

<div class="post-metadata">

**Author:** ![franzosa](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/franzosa/32/3511_2.png) [@franzosa](https://forum.biobakery.org/u/franzosa)\
**Post date:** [August 12, 2021, 3:45pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/6 "2021-08-12T15:45:56Z")

</div>

Apologies - you are right about this being caused by HUMAnN. I had missed the 201901 **b** in the URLs you initially provided. That database version is HUMAnN-specific (a HUMAnN-specific extension of the MetaPhlAn 201901 database), and so that’s likely why the download is failing. I will look into this - it’s not something that has come up before.

---

<div class="post-metadata">

**Author:** ![Lindsey](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lindsey/32/1084_2.png) [@Lindsey](https://forum.biobakery.org/u/Lindsey)\
**Post date:** [August 12, 2021, 4:17pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/7 "2021-08-12T16:17:07Z")

</div>

Thanks for looking into it. I think these people might be experiencing the same issue but posted in the wrong forum [Humann3.0.0 docker not accepting metaphlan database 201901b - Data resource - The bioBakery help forum](https://forum.biobakery.org/t/humann3-0-0-docker-not-accepting-metaphlan-database-201901b/2172).

---

<div class="post-metadata">

**Author:** ![franzosa](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/franzosa/32/3511_2.png) [@franzosa](https://forum.biobakery.org/u/franzosa)\
**Post date:** [August 16, 2021, 5:14pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/8 "2021-08-16T17:14:47Z")

</div>

Can you clarify what command you’re running when you see this error? It looks as though MetaPhlAn is being told to use an index named “201901b” (which does not exist). This should not be happening automatically, but it could happen if (e.g.) someone specified that index name when calling the software or in a configuration file.

You mentioned that this issue arose when running the demo. If you can clarify which demo you were running / adapting when performing this test, that would also be helpful (in case there’s something unclear in our documentation re: specifying databases).

---

<div class="post-metadata">

**Author:** ![Lindsey](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lindsey/32/1084_2.png) [@Lindsey](https://forum.biobakery.org/u/Lindsey)\
**Post date:** [August 16, 2021, 6:25pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/9 "2021-08-16T18:25:49Z")

</div>

This is the command I was using:  
humann --input lib/python3.7/site-packages/humann/tests/data/demo.fastq --output demo\_out --nucleotide-database /users/clairmontl/humanndb/ --metaphlan-options “–index mpa\_v296\_CHOCOPhlAn\_201901”

I also got the same error when running my own fasta files with this command:  
humann --input sample.fasta --output demo\_out --metaphlan-options “–index mpa\_v296\_CHOCOPhlAn\_201901”

---

<div class="post-metadata">

**Author:** ![franzosa](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/franzosa/32/3511_2.png) [@franzosa](https://forum.biobakery.org/u/franzosa)\
**Post date:** [August 16, 2021, 8:26pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/10 "2021-08-16T20:26:29Z")

</div>

You shouldn’t need to manually specify the MetaPhlAn index when running HUMAnN - MetaPhlAn will automatically fetch an appropriate index the first time it runs and then reuse it thereafter. Was there a specific reason for wanting the custom command?

---

<div class="post-metadata">

**Author:** ![Lindsey](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lindsey/32/1084_2.png) [@Lindsey](https://forum.biobakery.org/u/Lindsey)\
**Post date:** [August 17, 2021, 5:12pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/11 "2021-08-17T17:12:33Z")

</div>

Yes, I added the --index command after the same command without --index returned the error I reported above. I had read in the forums that specifying --index could overcome some metaphlan database issues in earlier program versions.

---

<div class="post-metadata">

**Author:** ![franzosa](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/franzosa/32/3511_2.png) [@franzosa](https://forum.biobakery.org/u/franzosa)\
**Post date:** [August 30, 2021, 9:42pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/12 "2021-08-30T21:42:01Z")

</div>

Sorry for the late reply here - did removing the `--index` flag solve your problem or are you still having difficulties with your analysis?

---

<div class="post-metadata">

**Author:** ![Lindsey](https://yyz1.discourse-cdn.com/flex027/user_avatar/forum.biobakery.org/lindsey/32/1084_2.png) [@Lindsey](https://forum.biobakery.org/u/Lindsey)\
**Post date:** [August 31, 2021, 12:43pm UTC](https://forum.biobakery.org/t/humann3-will-not-run-demo-due-to-database-issue/2477/13 "2021-08-31T12:43:45Z")

</div>

No it did not. None of the options I tried allowed me to run the program. I did get it to run but I had to make alterations to the humann.py and config.py scripts to do so.
