Real-time accessible phylogenetics for every highly sampled virus

Abstract

The scale of viral genome sequencing has outpaced the phylogenetic tools traditionally used to analyze it, as highlighted by the COVID-19 pandemic. We present viral_usher, a unified framework for scalable viral phylogenetics built on UShER. viral_usher is a containerized command-line tool that constructs mutation-annotated trees directly from public sequence repositories with minimal user input, building phylogenies of tens of thousands of genomes in minutes. Applying it across the International Nucleotide Sequence Database Collaboration, we assembled viral_usher_trees, a repository of 446 phylogenies spanning 163 well-sequenced viral species, rebuilt automatically monthly as new genomes are deposited. We extended Taxonium from a tree viewer into a web platform supporting in-browser phylogenetic placement and de novo tree construction, so that users can upload sequences and contextualize them within global phylogenies without local computational infrastructure. Because every tree is built by the same procedure, the repository enables comparative analyses across the breadth of viral diversity. We demonstrate the utility of this resource by asking what factors shape viral mutation spectra. We found that replication machinery, captured as Baltimore class, explains 46% of the variance across 162 viral genomes, while host taxon and envelope status together explain under 5%. These resources provide an extensible platform for real-time genomic epidemiology and for comparative evolutionary analysis across viral pathogens. Resources and code are freely available at https://taxonium.org/, https://github.com/lilymaryam/spectrum_analysis, https://github.com/AngieHinrichs/viral_usher_trees, and https://github.com/AngieHinrichs/viral_usher.