Skip to content
naulon

No retraction, correction or concern found when last checked on Oct 18, 2026.

IQ-TREE 3: phylogenomic inference software using complex evolutionary models

Thomas K F Wong, Nhan Ly-Trong, Huaiyan Ren and 13 more

Molecular Biology and Evolution · 2026 · CC BY

doi:10.1093/molbev/msag117

Abstract

IQ-TREE (https://iqtree.github.io/) is a widely used open-source software tool for efficiently inferring phylogenetic trees under maximum likelihood. Here, we present IQ-TREE version 3, the third major release of the software. IQ-TREE 3 significantly extends version 2 with new features, including mixture models as an alternative to partitioned models, gene and site concordance factors to quantify discordance between genomic regions, integration with phylogenomic divergence time estimation, and a fully featured sequence simulator. The IQ-TREE 3 source code is available at https://github.com/iqtree/iqtree3.

Full text

From PubMed Central, U.S. National Library of Medicine, as current on Oct 19, 2026. Paragraph numbers are ours, so an answer can point at one.

Introduction

IQ-TREE is a popular open-source software package for phylogenetic and phylogenomic analysis using a likelihood framework. IQ-TREE has been used by thousands of researchers and practitioners to understand evolution and biodiversity across many species and time scales. These studies range from inferring ancient relationships within Bacteria, Archaea, and eukaryotes; to more recent divergences among plants, animals, birds, gum trees, and primates; and even viral divergences such as SARS-CoV-2 virus. The two major releases of IQ-TREE have been cited more than 44,000 times (Google Scholar; 17th March 2026) and downloaded more than 1.3 million times (combined data from the GitHub repository and Bioconda package). IQ-TREE is also an integral component of many open-source biomedical applications such as CIPRES, GTDB, QIIME2, OrthoFinder, Nextstrain, Galaxy, PhyloSuite, TBtools, and Get_PhyloMarkers.

Since the release of IQ-TREE version 2 in 2020, we have substantially expanded its capabilities, allowing users to perform data analyses under additional models and scenarios. Here, we introduce IQ-TREE version 3 and highlight its key developments, including mixture models, concordance factors, sequence simulation, protein model estimation, divergence time estimation, and pathogen tree inference.

Mixture models

Phylogenetic analyses are often conducted with partitioned models, which assign different substitution models to different a priori defined groups of sites to account for heterogeneous evolutionary processes along genomes and/or within genes (e.g. among codon positions). Partitioned models are available in RAxML, RAxML-NG, and IQ-TREE 2; and tools like PartitionFinder can merge partitions to reduce over-parameterization.

IQ-TREE 2 implemented mixture models, which assume a user-defined number (k) of substitution models (or classes), like partition models. However, unlike partition models, users do not need to specify how to partition the data in mixture models. Rather, model-based probabilities of sites are conditional upon classes, and each site has a certain probability (or weight) of belonging to each class. The site likelihood is calculated as the weighted average of the conditional probabilities, giving the marginal probability of the site pattern. Models of rate heterogeneity among sites based on a Gamma distribution or free-rates are versions of mixture models. Mixture models in IQ-TREE 2 have been used to address many deep phylogenetic questions (e.g.; ). In particular, such models help to avoid artefacts such as long-branch attraction, which can be exacerbated with simpler models.

IQ-TREE 3 substantially improves the IQ-TREE 2 implementation by automatically determining the number of classes (k) and the substitution models for each class via the MixtureFinder algorithm for DNA data. In this way, the usage of DNA mixture models is now even simpler than partitioned models because no partition file is needed. This also removes user-subjectivity in determining the initial partitioning scheme, although it does come at the cost of additional computational resources: the amount of time and memory required by mixture models increases linearly with k. For protein data, in addition to profile mixtures and structure-based mixture models available in version 2, IQ-TREE 3 allows users to estimate amino-acid exchangeability matrices under complex profile mixture models, the so-called GTRpmix model. Notably, IQ-TREE 3 can also relax the assumption of a single tree common to many phylogenetic analyses by using the Mixtures Across Sites and Trees (MAST) model, which generalizes the General Heterogeneous evolution On a Single Topology (GHOST) mixture model of branch lengths. The MAST model can be useful to examine controversies between competing phylogenetic hypotheses and to pinpoint which sites in an alignment are best explained by which topologies; currently, it requires a user-provided set of input tree topologies.

Concordance factors

While the MAST model can summarize the contributions of a limited set of alternative tree topologies, IQ-TREE 3 also allows users to summarize discordance on all branches of a reference tree (e.g. an estimate of the species tree). We previously introduced methods to calculate two measures, called the gene concordance factor (gCF) and the site concordance factor (sCF), which quantify the level of concordance between each branch of the reference tree and the genes/loci (for the gCF) and sites (for the sCF). As the original sCF is based on parsimony and can be affected by homoplasy (similarities due to processes other than common ancestry) and taxon sampling, we introduced a likelihood-based version of the sCF that partially overcomes these issues. All of these methods and related summary statistics are available in IQ-TREE 3.

Sequence simulations

Sequence simulations are used in many scenarios, such as evaluating new methods, testing hypotheses with parametric bootstrap, performing approximate Bayesian computation, and generating training and testing data to help with the development of machine learning applications (, but see ). However, existing tools like Seq-Gen, Dawg, and INDELible lack support for mixture and other complex models. IQ-TREE 3 implements a built-in alignment simulator called AliSim to take advantage of all advanced models available in IQ-TREE. To optimize speed, AliSim provides two different algorithms, one to simulate sequences of low divergence and another for high divergence, and can adaptively determine which algorithm to use. AliSim substantially outperforms Seq-Gen, Dawg, and INDELible in terms of both runtimes and memory usage. We also provided a high-performance version, AliSim-HPC, which can parallelize the simulations over multicore CPUs and multinode clusters.

New protein models

Protein data have been used to address many phylogenetic questions, especially at deep time scales. In many cases, analyses rely on empirical protein models like JTT, WAG, and LG, which were estimated from large collections of alignments spanning many clades on the tree of life. The scale of modern phylogenomic datasets and powerful computers present an opportunity to estimate models tailored specifically to individual clades. To facilitate this, IQ-TREE 3 provides a new maximum likelihood tool called QMaker to estimate a protein substitution matrix for a user-provided set of protein alignments and introduces a general matrix Q.pfam and a series of new clade-specific matrices—Q.bird, Q.insect, Q.mammal, Q.plant, Q.yeast—derived from large empirical datasets. These matrices will be useful for phylogenetic analyses of these and related clades. IQ-TREE 3 also provides an extension of QMaker for nonreversible models and a series of corresponding nonreversible Q matrices, as well as two new matrices, EAL (Eukaryotes and Archaea) and ELM (Eukaryotes), to be used with profile mixture models. The nonreversible matrices allow IQ-TREE 3 to reconstruct rooted trees without the requirement of an outgroup (e.g.; ), as well as to infer the confidence of the placement of the root via the rootstrap.

Pandemic-scale phylogenetics

IQ-TREE 3 integrates CMAPLE, an ultra-fast method for inferring trees with millions of closely related sequences, such as those produced by global SARS-CoV-2 (the virus that caused the COVID-19 pandemic) sequencing efforts. This enables IQ-TREE 3 to perform functions that are useful in tracking large pathogen outbreaks, such as online sample placement. Additionally, IQ-TREE 3 introduces a dedicated “--pathogen” option for dynamically selecting between the CMAPLE and IQ-TREE search algorithms to optimize runtime based on sequence divergence: CMAPLE is selected for highly similar sequences, and IQ-TREE is selected for more distantly related sequences.

Moreover, IQ-TREE 3 and CMAPLE implement subtree pruning and regrafting tree assessment (SPRTA), a fast and appropriate approach for assessing phylogenetic uncertainty in genomic epidemiology. SPRTA can be invoked via the “--sprta” option.

Time tree estimation

IQ-TREE 3 provides two facilities for divergence time estimation. The first is the Least Squares Dating method, LSD2, which is suitable for dating very large phylogenies with tip date information, such as viral phylogenies. The second is the new IQ2MC workflow to facilitate Bayesian divergence time estimation with MCMCTree. In the IQ2MC workflow, IQ-TREE 3 is used to compute the gradient vector and Hessian matrix of the branch lengths on a fixed tree topology, which are then used for fast approximate Bayesian MCMC sampling with MCMCTree. IQ-TREE dramatically speeds up the precalculation steps needed by MCMCTree, particularly for large phylogenomic datasets, and allows the use of the wide range of IQ-TREE's complex substitution models (such as mixture models), which were previously unavailable for time tree inference, and which are essential for dating ancient phylogenies.

Other advances

Finally, IQ-TREE 3 also includes a reimplementation of fast distance-based methods such as Neighbor-Joining via the DecentTree library. It also includes a Python interface through piqtree, an open-source Python package that exposes IQ-TREE's phylogenetic inference engine as a library of Python functions, thus facilitating interactive analyses in environments such as Jupyter notebooks and simplifying the development of custom phylogenetic workflows.

Conclusions

IQ-TREE version 3 presents a joint collaborative effort among researchers from across the globe, which substantially extends version 2. Particularly, we would like to advocate for the use of mixture models instead of only using partition models, especially as the single-model assumption within a locus is often violated. In addition, if the single-tree assumption common to concatenation approaches is violated, then users should employ the MAST model and/or interrogate their data by examining concordance factors.

We strive to continuously support the user community. Every new feature is accompanied by a tutorial and the manual is frequently updated at https://iqtree.github.io/doc/. User questions, issue reports, and feature requests can be submitted at the GitHub repository.

References 75

  1. 1.
  2. 2.

    Baños H et al GTRpmix: a linked general time-reversible model for profile mixture models. Mol Biol Evol. 2024:41:msae174..

    Not in our library10.1093/molbev/msae174

  3. 3.

    Bolyen E et al Reproducible, interactive, scalable and extensible microbiome data science using QIIME 2. Nat Biotechnol. 2019:37:852–857..

    Not in our library10.1038/s41587-019-0209-9

  4. 4.

    Burki F et al Untangling the early diversification of eukaryotes: a phylogenomic study of the evolutionary origins of Centrohelida, Haptophyta and Cryptista. Proc Biol Sci. 2016:283:20152802..

    Not in our library10.1098/rspb.2015.2802

  5. 5.

    Cartwright RA. DNA assembly with gaps (Dawg): simulating sequence evolution. Bioinformatics. 2005:21:iii31–iii38..

    Not in our library10.1093/bioinformatics/bti1200

  6. 6.

    Chen C et al TBtools-II: a “one for all, all for one” bioinformatics platform for biological big-data mining. Mol Plant. 2023:16:1733–1742..

    Not in our library10.1016/j.molp.2023.09.010

  7. 7.

    Crisp MD et al Perianth evolution and implications for generic delimitation in the eucalypts (Myrtaceae), including the description of the new genus, Blakella. J Syst Evol. 2024:62:942–962..

    Not in our library10.1111/jse.13047

  8. 8.

    Crotty SM et al GHOST: recovering historical signal from heterotachously evolved sequence alignments. Syst Biol. 2020:69:249–264..

    Not in our library10.1093/sysbio/syz051

  9. 9.

    Csilléry K, Blum MGB, Gaggiotti OE, François O. Approximate Bayesian computation (ABC) in practice. Trends Ecol Evol. 2010:25:410–418..

    Not in our library10.1016/j.tree.2010.04.001

  10. 10.

    Dang CC et al NQMaker: estimating time nonreversible amino acid substitution models. Syst Biol. 2022:71:1110–1123..

    Not in our library10.1093/sysbio/syac007

  11. 11.

    De Maio N et al Maximum likelihood pandemic-scale phylogenetics. Nat Genet. 2023:55:746–752..

    Not in our library10.1038/s41588-023-01368-0

  12. 12.

    De Maio N, Ly-Trong N, Martin S, Minh BQ, Goldman N. Assessing phylogenetic confidence at pandemic scales. Nature. 2025:647:472–478..

    Not in our library10.1038/s41586-025-09567-x

  13. 13.

    Demotte P et al 2025. IQ2MC: A new framework to infer phylogenetic time trees using IQ-TREE 3 and MCMCTree with mixture models. EcoEvoRxiv [Internet]..

    Not in our library10.32942/x2cd2x

  14. 14.
  15. 15.

    dos Reis M, Yang Z. Approximate likelihood calculation on a phylogeny for Bayesian estimation of divergence times. Mol Biol Evol. 2011:28:2161–2172..

    Not in our library10.1093/molbev/msr045

  16. 16.
  17. 17.
  18. 18.

    Felsenstein J. Cases in which parsimony or compatibility methods will be positively misleading. Syst Biol. 1978:27:401–410..

    Not in our library10.1093/sysbio/27.4.401

  19. 19.

    Fletcher W, Yang Z. INDELible: a flexible simulator of biological sequence evolution. Mol Biol Evol. 2009:26:1879–1888..

    Not in our library10.1093/molbev/msp098

  20. 20.
  21. 21.

    Giacomelli M et al CAT-posterior mean site frequencies improves phylogenetic modeling under maximum likelihood and resolves Tardigrada as the sister of Arthropoda plus Onychophora. Genome Biol Evol. 2025:17:evae273..

    Not in our library10.1093/gbe/evae273

  22. 22.

    Hadfield J et al Nextstrain: real-time tracking of pathogen evolution. Bioinformatics. 2018:34:4121–4123..

    Not in our library10.1093/bioinformatics/bty407

  23. 23.

    Holmes EC et al The origins of SARS-CoV-2: a critical review. Cell. 2021:184:4848–4856..

    Not in our library10.1016/j.cell.2021.08.017

  24. 24.

    Jarvis ED et al Whole-genome analyses resolve early branches in the tree of life of modern birds. Science. 2014:346:1320–1331..

    Not in our library10.1126/science.1253451

  25. 25.

    Jones DT, Taylor WR, Thornton JM. The rapid generation of mutation data matrices from protein sequences. Comput Appl Biosci. 1992:8:275–282..

    Not in our library10.1093/bioinformatics/8.3.275

  26. 26.

    Kalyaanamoorthy S, Minh BQ, Wong TKF, von Haeseler A, Jermiin LS. ModelFinder: fast model selection for accurate phylogenetic estimates. Nat Methods. 2017:14:587–589..

    Not in our library10.1038/nmeth.4285

  27. 27.

    Kozlov AM, Darriba D, Flouri T, Morel B, Stamatakis A. RAxML-NG: a fast, scalable and user-friendly tool for maximum likelihood phylogenetic inference. Bioinformatics. 2019:35:4453–4455..

    Not in our library10.1093/bioinformatics/btz305

  28. 28.

    Lanfear R, Frandsen PB, Wright AM, Senfeld T, Calcott B. PartitionFinder 2: new methods for selecting partitioned models of evolution for molecular and morphological phylogenetic analyses. Mol Biol Evol. 2017:34:772–773..

    Not in our library10.1093/molbev/msw260

  29. 29.

    Lanfear R, Hahn MW. The meaning and measure of concordance factors in phylogenomics. Mol Biol Evol. 2024:41:msae214..

    Not in our library10.1093/molbev/msae214

  30. 30.

    Le SQ, Gascuel O. An improved general amino acid replacement matrix. Mol Biol Evol. 2008:25:1307–1320..

    Not in our library10.1093/molbev/msn067

  31. 31.

    Le SQ, Lartillot N, Gascuel O. Phylogenetic mixture models for proteins. Philos Trans R Soc Lond B Biol Sci. 2008:363:3965–3976..

    Not in our library10.1098/rstb.2008.0180

  32. 32.

    Leuchtenberger AF et al Distinguishing Felsenstein zone from Farris zone using neural networks. Mol Biol Evol. 2020:37:3632–3641..

    Not in our library10.1093/molbev/msaa164

  33. 33.

    Ly-Trong N, Barca GMJ, Minh BQ. AliSim-HPC: parallel sequence simulator for phylogenetics. Bioinformatics. 2023:39:btad540..

    Not in our library10.1093/bioinformatics/btad540

  34. 34.

    Ly-Trong N, Bielow C, De Maio N, Minh BQ. CMAPLE: efficient phylogenetic inference in the pandemic era. Mol Biol Evol. 2024:41:msae134..

    Not in our library10.1093/molbev/msae134

  35. 35.

    Ly-Trong N, Naser-Khdour S, Lanfear R, Minh BQ. AliSim: a fast and versatile phylogenetic sequence simulator for the genomic era. Mol Biol Evol. 2022:39:msac092..

    Not in our library10.1093/molbev/msac092

  36. 36.

    McArthur RN et al Piqtree: a python package for seamless phylogenetic inference with IQ-TREE. Mol Biol Evol. 2026:43:msag061..

    Not in our library10.1093/molbev/msag061

  37. 37.

    McBroome J et al A daily-updated database and tools for comprehensive SARS-CoV-2 mutation-annotated trees. Mol Biol Evol. 2021:38:5819–5824..

    Not in our library10.1093/molbev/msab264

  38. 38.

    Miller MA, Pfeiffer W, Schwartz T. Creating the CIPRES science gateway for inference of large phylogenetic trees. In: 2010 Gateway computing environments workshop (GCE). IEEE; 2010, p. 1–8..

    Not in our library10.1109/gce.2010.5676129

  39. 39.
  40. 40.

    Minh BQ, Dang CC, Vinh LS, Lanfear R. QMaker: fast and accurate method to estimate empirical models of protein evolution. Syst Biol. 2021:70:1046–1060..

    Not in our library10.1093/sysbio/syab010

  41. 41.
  42. 42.

    Misof B et al Phylogenomics resolves the timing and pattern of insect evolution. Science. 2014:346:763–767..

    Not in our library10.1126/science.1257570

  43. 43.

    Mo YK, Lanfear R, Hahn MW, Minh BQ. Updated site concordance factors minimize effects of homoplasy and taxon sampling. Bioinformatics. 2023:39:btac741..

    Not in our library10.1093/bioinformatics/btac741

  44. 44.

    Naser-Khdour S, Quang Minh B, Lanfear R. Assessing confidence in root placement on phylogenies: an empirical study using nonreversible models for mammals. Syst Biol. 2022:71:959–972..

    Not in our library10.1093/sysbio/syab067

  45. 45.

    Nguyen L-T, Schmidt HA, von Haeseler A, Minh BQ. IQ-TREE: a fast and effective stochastic algorithm for estimating maximum-likelihood phylogenies. Mol Biol Evol. 2015:32:268–274..

    Not in our library10.1093/molbev/msu300

  46. 46.

    Parks DH et al A standardized bacterial taxonomy based on genome phylogeny substantially revises the tree of life. Nat Biotechnol. 2018:36:996–1004..

    Not in our library10.1038/nbt.4229

  47. 47.
  48. 48.

    Puttick MN et al The interrelationships of land plants and the nature of the ancestral embryophyte. Curr Biol. 2018:28:733–745.e2..

    Not in our library10.1016/j.cub.2018.01.063

  49. 49.

    Rambaut A et al A dynamic nomenclature proposal for SARS-CoV-2 lineages to assist genomic epidemiology. Nat Microbiol. 2020:5:1403–1407..

    Not in our library10.1038/s41564-020-0770-5

  50. 50.

    Rambaut A, Grassly NC. Seq-Gen: an application for the Monte Carlo simulation of DNA sequence evolution along phylogenetic trees. Comput Appl Biosci. 1997:13:235–238..

    Not in our library10.1093/bioinformatics/13.3.235

  51. 51.

    Ran J-H, Shen T-T, Wang M-M, Wang X-Q. Phylogenomics resolves the deep phylogeny of seed plants and indicates partial convergent or homoplastic evolution between Gnetales and angiosperms. Proc Biol Sci. 2018:285:20181012..

    Not in our library10.1098/rspb.2018.1012

  52. 52.

    Redmond AK, McLysaght A. Evidence for sponges as sister to all other animals from partitioned phylogenomics with mixture models and recoding. Nat Commun. 2021:12:1783..

    Not in our library10.1038/s41467-021-22074-7

  53. 53.

    Ren H, Wong TKF, Minh BQ, Lanfear R. MixtureFinder: estimating DNA mixture models for phylogenetic analyses. Mol Biol Evol. 2025:42:msae264..

    Not in our library10.1093/molbev/msae264

  54. 54.

    Saitou N, Nei M. The neighbor-joining method: a new method for reconstructing phylogenetic trees. Mol Biol Evol. 1987:4:406–425..

    Not in our library10.1093/oxfordjournals.molbev.a040454

  55. 55.

    Shen X-X et al Tempo and mode of genome evolution in the budding yeast subphylum. Cell. 2018:175:1533–1545.e20..

    Not in our library10.1016/j.cell.2018.10.023

  56. 56.

    Smith ML, Hahn MW. Phylogenetic inference using generative adversarial networks. Bioinformatics. 2023:39:btad543..

    Not in our library10.1093/bioinformatics/btad543

  57. 57.

    Soubrier J et al The influence of rate heterogeneity among sites on the time dependence of molecular rates. Mol Biol Evol. 2012:29:3345–3358..

    Not in our library10.1093/molbev/mss140

  58. 58.

    Stamatakis A. RAxML version 8: a tool for phylogenetic analysis and post-analysis of large phylogenies. Bioinformatics. 2014:30:1312–1313..

    Not in our library10.1093/bioinformatics/btu033

  59. 59.
  60. 60.
  61. 61.

    Trost J et al Simulations of sequence evolution: How (Un)realistic they are and why. Mol Biol Evol. 2024:41:msad277..

    Not in our library10.1093/molbev/msad277

  62. 62.
  63. 63.
  64. 64.

    Wang H-C, Li K, Susko E, Roger AJ. A class frequency mixture model that adjusts for site-specific amino acid frequencies and improves inference of protein phylogeny. BMC Evol Biol. 2008:8:331..

    Not in our library10.1186/1471-2148-8-331

  65. 65.

    Wang H-C, Minh BQ, Susko E, Roger AJ. Modeling site heterogeneity with posterior mean site frequency profiles accelerates accurate phylogenomic estimation. Syst Biol. 2018:67:216–235..

    Not in our library10.1093/sysbio/syx068

  66. 66.

    Wang S, Luo H. Dating the bacterial tree of life based on ancient symbiosis. Syst Biol. 2025:74:639–655..

    Not in our library10.1093/sysbio/syae071

  67. 67.

    Wang W et al DecentTree: scalable neighbour-joining for the genomic era. Bioinformatics. 2023:39:btad536..

    Not in our library10.1093/bioinformatics/btad536

  68. 68.

    Wehbi S et al Order of amino acid recruitment into the genetic code resolved by last universal common ancestor's protein domains. Proc Natl Acad Sci U S A. 2024:121:e2410311121..

    Not in our library10.1073/pnas.2410311121

  69. 69.

    Whelan S, Goldman N. A general empirical model of protein evolution derived from multiple protein families using a maximum-likelihood approach. Mol Biol Evol. 2001:18:691–699..

    Not in our library10.1093/oxfordjournals.molbev.a003851

  70. 70.

    Williamson K et al A robustly rooted tree of eukaryotes reveals their excavate ancestry. Nature. 2025:640:974–981..

    Not in our library10.1038/s41586-025-08709-5

  71. 71.

    Wong TKF et al MAST: phylogenetic inference with mixtures across sites and trees. Syst Biol. 2024:73:375–391..

    Not in our library10.1093/sysbio/syae008

  72. 72.

    Wu S, Edwards S, Liu L. Genome-scale DNA sequence data and the evolutionary history of placental mammals. Data Brief. 2018:18:1972–1975..

    Not in our library10.1016/j.dib.2018.04.094

  73. 73.

    Xiang C-Y et al Using PhyloSuite for molecular phylogeny and tree-based analyses. Imeta. 2023:2:e87..

    Not in our library10.1002/imt2.87

  74. 74.

    Yang Z. Maximum likelihood phylogenetic estimation from DNA sequences with variable rates over sites: approximate methods. J Mol Evol. 1994:39:306–314..

    Not in our library10.1007/bf00160154

  75. 75.

    Zhang D et al PhyloSuite: an integrated and scalable desktop platform for streamlined molecular sequence data management and evolutionary phylogenetics studies. Mol Ecol Resour. 2020:20:348–355..

    Not in our library10.1111/1755-0998.13096

Cited by papers we hold 1

Reads

Read by people on this page

None yet.

Checked or read by AI through naulon

None yet.

A person counts once a day per paper. We keep no cookie and no address: a reader is a hash that changes every day. Any month under five reads shows no number.

Are you an author?

Is this your paper?

Claim it to add your note and be paid when agents cite it. Free.