Aggregate bioinformatics results across many samples into a single report
Find documentation and example reports at https://seqera.io/multiqc/
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. MultiQC can also easily parse data from custom scripts, if correctly formatted / configured - a feature called Custom Content.
More modules are being written all the time. Please suggest any ideas as a new issue (please include example log files).
Installation
You can install MultiQC using uv (no separate Python installation required):
uv tool install multiqc
Alternatively, install from PyPI using pip:
pip install multiqc
Or install using Conda from Bioconda (set up your channels first):
conda install multiqc
If you would like the development version from GitHub instead, you can install it with uv or pip:
uv tool install git+https://github.com/MultiQC/MultiQC.git
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 for details.
Usage
Once installed, you can use MultiQC by navigating to your analysis directory (or a parent directory) and running the tool:
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.
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
PMID: 27312411
@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 for any of these, including example reports where possible. Pull-requests for fixes and additions are very welcome. Please see the contributing notes for more information about how the process works.
MultiQC has extensive documentation describing how to write new modules, plugins and templates.
If in doubt, feel free to get in touch with the author directly: @ewels (phil.ewels@seqera.io)
Contributors
MultiQC is developed and maintained by Phil Ewels (@ewels) at Seqera Labs. It was originally written at the National Genomics Infrastructure, part of SciLifeLab in Sweden.
A huge thank you to all code contributors - there are a lot of you! See the Contributors Graph for details.
MultiQC is released under the GPL v3 or later licence.
Release files for multiqc 1.35
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| multiqc-1.35.tar.gz | 5.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| multiqc-1.35-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:11.2 MB
Release files / multiqc-1.35.tar.gz
| Download URL | multiqc-1.35.tar.gz |
|---|---|
| Size | 5.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5a4aa6480e6def2f9c0af2893358bf7ec5c304d606ecf613cd25ddcd0e244e77
|
|
BLAKE2b-256 checksum How to use checksums |
afa290e1b19ee65ec2619a4ff1767deefe32ba16c87f1363864778bd97ee5800
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / multiqc-1.35-py3-none-any.whl
| Download URL | multiqc-1.35-py3-none-any.whl |
|---|---|
| Size | 5.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
818ad8aa75572f13be55b66c0bafd7877c1e119a0903e004855ec04385a94dc6
|
|
BLAKE2b-256 checksum How to use checksums |
ae85ea19a97a83eddf81ab645d44ea219211e65961c60a93c1a62e8751efe2ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
