UniCoracle: automated hierarchical feature selection via bottom-up propagation and top-down skimming using the UniCorP algorithm and the Coracle machine-learning framework.

summaryIdentifying meaningful associations between microbial communities and measured physiological or environmental variables becomes increasingly complex and computationally demanding given the continuous growth of microbiome datasets. The Coracle machine learning (ML) framework was recently developed to address this issue by integrating multiple data transformations, feature selection techniques, and ML models to yield condensed lists of features that align to target variables of interest. Further, we recently developed the UniCorP feature aggregation algorithm to identify uniquely correlated features (UNICORNs) based on the UniCor metric that iteratively enrich each taxonomic level in an automated bottom-up approach. Here we present UniCoracle, a fully automated analytical framework that integrates UniCorP's bottom-up propagation approach with a subsequent and newly developed top-down skimming (TDS) strategy, implemented with the Coracle ML framework. This combined approach leverages the inherent taxonomic structure of microbiome community data (e.g., ASVs derived from 16S rRNA gene amplicon sequencing data) to maintain predictive stability, reduce computational runtime, and identify biologically meaningful taxonomic associations. We compare the original, non-hierarchical Coracle with the TDS Coracle method and the UniCoracle approach. Evaluations across the tested datasets show that UniCoracle achieves competitive or improved predictive performance relative to both Coracle's multi-step and the TDS-based Coracle implementations and demonstrate UniCoracle's improvements in predictive accuracy over both methods. UniCoracle provides full control over feature set size and runtime, offering a streamlined and user-friendly framework for biological hypothesis generation. It identifies features (e.g., bacterial taxa) at the lowest (most specific) hierarchical level (e.g., ASV or species within a taxonomic hierarchy) that are associated with continuous target variables. AVAILABILITY: UniCoracle is freely accessible via a dedicated web server at micportal.org. The source code is open source and available on GitHub at github.com/SebastianStaab/UniCoracle.git and Zenodo at https://doi.org/10.5281/zenodo.19050205.