microeco

An R package for downstream analysis of microbiome omics data

CRAN CRAN

Background

The increasing volume and complexity of microbiome omics data pose a challenge for the downstream data analysis. Therefore, we developed the R microeco package (abbreviated and pronounced as [miːkəu]).

Main Features

Install microeco in R

Install microeco package from CRAN. If you do not already have R/RStudio installed, please first install R and RStudio. Open RStudio -> Tools -> Global Options -> Packages, select the appropriate mirror in Primary CRAN repository.

install.packages("microeco")

Or install the latest development version from Github.

# If devtools package is not installed, first install it
install.packages("devtools")
devtools::install_github("ChiLiubio/microeco")

MecoToolkit: Interactive Microbiome Analysis App

The MecoToolkit app has been released for interactive microbiome data analysis on the local computer (https://mecotoolkit.com/). Install the app to access all its features, along with other microbiome analysis methods not covered in microeco package. No package/resource configuration is required.

Tutorial

A detailed online tutorial (https://chiliubio.github.io/microeco_tutorial/) is provided with the package. For offline use, the tutorial can also be downloaded and opened locally (https://github.com/ChiLiubio/microeco_tutorial/releases). To view these links in an R session, run ?microeco. Please use a class name to search for its help document (e.g., ?microtable) rather than searching for individual functions therein. Before creating a new issue in the Issues, please read the guideline (https://chiliubio.github.io/microeco_tutorial/notes.html#github-issues). To create a basic microtable object directly from outputs of other tools/platforms (e.g. QIIME2, HUMAnN, Kraken2 and phyloseq), please use the file2meco package (https://github.com/ChiLiubio/file2meco). To help users familiarize themselves with the package using multi-omics data, we also provide a systematic protocol (https://github.com/ChiLiubio/microeco_protocol_v1).

Citation

Chi Liu, Xiangzhen Li, Felipe R. P. Mansoldo, Tong Chen, Fanzheng Meng, Ruixiang Tang, Siyu Zhou, Qinghua Yang, Ruixin Shao & Minjie Yao. microeco 2: A comprehensive R package for downstream analysis of microbiome omics data. iMeta, 2026, 5: e70132. https://doi.org/10.1002/imt2.70132

Chi Liu, Felipe R. P. Mansoldo, Hankang Li, Alane Beatriz Vermelho, Raymond Jianxiong Zeng, Xiangzhen Li & Minjie Yao. A workflow for statistical analysis and visualization of microbiome omics data using the R microeco package. Nature Protocols, 2026, 21: 1300–1324. https://doi.org/10.1038/s41596-025-01239-4

Chi Liu, Yaoming Cui, Xiangzhen Li & Minjie Yao. microeco: an R package for data mining in microbial community ecology. FEMS Microbiology Ecology, 2021, 97(2): fiaa255. https://doi.org/10.1093/femsec/fiaa255

Contributing

We welcome any contribution, including but not limited to code, idea and tutorial. Please report errors and questions on Github Issues. Any contribution via Pull requests will be appreciated. By participating in this project you agree to abide by the terms outlined in the Contributor Code of Conduct.