# MultiQC
**Repository Path**: trusted-list/MultiQC
## Basic Information
- **Project Name**: MultiQC
- **Description**: Aggregate results from bioinformatics analyses across many samples into a single report.
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: https://seqera.io/multiqc/
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-08-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
### Aggregate bioinformatics results across many samples into a single report
##### Find [documentation](https://docs.seqera.io/multiqc) and [example reports](https://seqera.io/multiqc/#reports) at [https://seqera.io/multiqc/](https://seqera.io/multiqc/)
[](https://pypi.python.org/pypi/multiqc/)
[](https://bioconda.github.io/recipes/multiqc/README.html)
[](http://dx.doi.org/10.1093/bioinformatics/btw354)
---
MultiQC is a tool to create a single report with interactive plots for multiple bioinformatics analyses across many samples.
Reports are generated by scanning given directories for recognised log files.
These are parsed and a single HTML report is generated summarising the statistics
for all logs found. MultiQC reports can describe multiple analysis steps and
large numbers of samples within a single plot, and multiple analysis tools making
it ideal for routine fast quality control.
A very large number of Bioinformatics tools are supported by MultiQC. Please see the MultiQC website for a [complete list](https://docs.seqera.io/multiqc/modules/).
MultiQC can also easily parse data from custom scripts, if correctly formatted / configured - a feature called [Custom Content](https://docs.seqera.io/multiqc/custom_content).
More modules are being written all the time. Please suggest any ideas as a new
[issue](https://github.com/MultiQC/MultiQC/issues) _(please include example log files)_.
## Installation
You can install MultiQC using [uv](https://docs.astral.sh/uv/) (no separate Python installation required):
```bash
uv tool install multiqc
```
Alternatively, install from [PyPI](https://pypi.python.org/pypi/multiqc/) using `pip`:
```bash
pip install multiqc
```
Or install using [Conda](http://anaconda.org/)
from [Bioconda](https://bioconda.github.io/) ([set up your channels](https://bioconda.github.io/#usage) first):
```bash
conda install multiqc
```
If you would like the development version from GitHub instead, you can install it with `uv` or `pip`:
```bash
uv tool install git+https://github.com/MultiQC/MultiQC.git
```
```bash
pip install --upgrade --force-reinstall git+https://github.com/MultiQC/MultiQC.git
```
MultiQC is also available via Docker and Singularity images, Galaxy wrappers, and
many more distribution methods.
See [the documentation](https://docs.seqera.io/multiqc/getting_started/installation/) for details.
## Usage
Once installed, you can use MultiQC by navigating to your analysis directory
(or a parent directory) and running the tool:
```bash
multiqc .
```
That's it! MultiQC will scan the specified directory (`.` is the current dir)
and produce a report detailing whatever it finds.
The report is created in `multiqc_report.html` by default. Tab-delimited data
files are also created in `multiqc_data/`, containing extra information.
These can be easily inspected using Excel (use `--data-format` to get `yaml`
or `json` instead).
For more detailed instructions, run `multiqc -h` or see the
[documentation](https://docs.seqera.io/multiqc/getting_started/running_multiqc).
## Configuration
To customise your reports, MultiQC reads from a YAML config file. See the [configuration docs](https://docs.seqera.io/multiqc/getting_started/config) for the full list of options and search paths.
You can build a config file visually in your browser with the [MultiQC Configuration Wizard](https://seqera.io/multiqc_config_wizard). It has every option as a form field, with live YAML editor and schema validation as you type.
## Citation
Please consider citing MultiQC if you use it in your analysis.
> **MultiQC: Summarize analysis results for multiple tools and samples in a single report.** _Philip Ewels, Måns Magnusson, Sverker Lundin and Max Käller_
> Bioinformatics (2016)
> doi: [10.1093/bioinformatics/btw354](http://dx.doi.org/10.1093/bioinformatics/btw354)
> PMID: [27312411](http://www.ncbi.nlm.nih.gov/pubmed/27312411)
```BibTeX
@article{doi:10.1093/bioinformatics/btw354,
author = {Ewels, Philip and Magnusson, Måns and Lundin, Sverker and Käller, Max},
title = {MultiQC: summarize analysis results for multiple tools and samples in a single report},
journal = {Bioinformatics},
volume = {32},
number = {19},
pages = {3047},
year = {2016},
doi = {10.1093/bioinformatics/btw354},
URL = { + http://dx.doi.org/10.1093/bioinformatics/btw354},
eprint = {/oup/backfile/Content_public/Journal/bioinformatics/32/19/10.1093_bioinformatics_btw354/3/btw354.pdf}
}
```
## Contributions & Support
Contributions and suggestions for new features are welcome, as are bug reports!
Please create a new [issue](https://github.com/MultiQC/MultiQC/issues) for any
of these, including example reports where possible.
Pull-requests for fixes and additions are very welcome.
Please see the [contributing notes](https://github.com/MultiQC/MultiQC/blob/main/.github/CONTRIBUTING.md) for more information about how the process works.
MultiQC has extensive [documentation](https://docs.seqera.io/multiqc/development)
describing how to write new modules, plugins and templates.
If in doubt, feel free to get in touch with the author directly:
[@ewels](https://github.com/ewels) (phil.ewels@seqera.io)
### Contributors
MultiQC is developed and maintained by Phil Ewels ([@ewels](https://github.com/ewels)) at [Seqera Labs](https://seqera.io/).
It was originally written at the [National Genomics Infrastructure](https://ngisweden.scilifelab.se/), part of [SciLifeLab](https://www.scilifelab.se/) in Sweden.
A huge thank you to all code contributors - there are a lot of you!
See the [Contributors Graph](https://github.com/MultiQC/MultiQC/graphs/contributors) for details.
MultiQC is released under the GPL v3 or later licence.
