What happened
Metagenomic analyses can be performed at multiple analytical levels, including read-based, assembly-based, and genome-resolved approaches, each capturing complementary biological information while introducing distinct analytical biases and trade-offs. However, existing workflows are commonly optimized for a single analytical strategy, making it difficult to integrate these complementary representations within a unified, reproducible framework. Here we present Geomosaic, a modular framework that integrates complementary analytical representations of metagenomic data, from reads to genomes, within a single scalable, customizable, and reproducible workflow. Built on a graph-based architecture implemented in Snakemake, Geomosaic enables users to construct complete end-to-end workflows or execute individual analytical modules while selecting among interchangeable software packages. The framework supports read preprocessing, quality control, taxonomic and functional profiling, assembly, genome reconstruction, genome-resolved annotation, custom HMM-based analyses, and automated downstream result aggregation. Automatic generation of execution scripts, modular workflows, and multiple analysis entry points make Geomosaic accessible to researchers approaching metagenomic analyses for the first time, while providing the flexibility and control required by expert users. Native support for HPC environments enables efficient analysis of datasets ranging from individual projects to large-scale metagenomic surveys. Rather than treating read-, assembly-, and genome-resolved metagenomics as alternative analytical strategies, Geomosaic integrates them as complementary representations of the same biological system, allowing users to move seamlessly between community-wide patterns and organism-resolved functional interpretation. By combining workflow flexibility, computational reproducibility, standardized analysis-ready outputs, and extensive documentation, Geomosaic provides a unified platform for environmental metagenomic analyses and facilitates reproducible downstream ecological and evolutionary investigations.