ampliQC 🧬
ampliQC is a context-aware Quality Control (QC) engine specialized for Amplicon Sequencing Data (16S, 18S, ITS, and functional marker genes) across both Short-Read (Illumina / MGI / Element) and Long-Read (PacBio HiFi / Oxford Nanopore) platforms.
Unlike generic QC tools like FastQC or Falco—which evaluate amplicon reads against genome sequencing assumptions and trigger false warnings for high duplication rates or initial primer nucleotide composition—ampliQC evaluates sequencing quality within the biological and technical context of amplicon libraries.
Key Features
- 🎯 Amplicon-Aware Biological Evaluation:
- 16S / 18S / ITS & Custom Target Profiling: Detects target regions (V1-V3, V3-V4, V4, V9, ITS1, ITS2, or Full-Length ~1.5kb).
- Primer Detection & Trimming Status: Scans 5' and 3' ends for degenerate PCR primers (IUPAC codes) and assesses trimming state.
- Context-Aware Duplication Rate: Distinguishes expected biological locus amplification from library bottleneck errors.
- Conserved Base Bias vs Body Composition: Separates expected primer binding site bias from target sequence quality drops.
- Short vs Long-Read Profiling: Supports Illumina (150-300bp) and PacBio HiFi / ONT Full-Length amplicons.
- ✂️ Automatic Trimming & DADA2 Parameters:
- Generates ready-to-copy Cutadapt and Chopper CLI commands.
- Calculates optimal DADA2 / QIIME 2 truncation lengths based on Phred quality decay and amplicon target overlap.
- 🚀 Multi-Sample Parallel Batch Processing:
- Process an entire directory of FASTQ files in parallel via
ampliqc run-batch. - Generates consolidated Multi-Sample TSV summary matrices and native MultiQC JSON files (
_ampliqc_mqc.json).
- Process an entire directory of FASTQ files in parallel via
- 🛠️ Custom Primer Database Support:
- Load custom lab primer panels via
--primer-db custom_primers.yamlor default~/.config/ampliqc/primers.yaml.
- Load custom lab primer panels via
Installation
pip install -e .
Quick Start
# Analyze a 16S amplicon dataset (Paired-End Illumina V3-V4)
ampliqc run -1 sample_R1.fastq.gz -2 sample_R2.fastq.gz --context amplicon_16s -o qc_output/
# Analyze a Full-Length 16S dataset (PacBio HiFi / Oxford Nanopore Long-Read)
ampliqc run -1 sample_longreads.fastq.gz --context auto -o qc_output/
# Run multi-sample batch QC across a directory in parallel (4 threads)
ampliqc run-batch -i /path/to/fastq_dir/ -o batch_qc_output/ -t 4
# Specify custom forward and reverse primers or custom YAML database
ampliqc run -1 sample.fastq.gz --primer-f GTGYCAGCMGCCGCGGTAA --primer-r GGACTACNVGGGTWTCTAAT -o qc_output/
ampliqc run -1 sample.fastq.gz --primer-db lab_primers.yaml -o qc_output/
Metadata
Release files for ampliqc 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ampliqc-0.1.1.tar.gz | 33.6 kB | Without provenance | Details for ampliqc-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ampliqc-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for ampliqc-0.1.1-py3-none-any.whl |
Total release size: 67.3 kB
Release files / ampliqc-0.1.1.tar.gz
| Download URL | ampliqc-0.1.1.tar.gz |
|---|---|
| Size | 33.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dd04581892d535c3889258c6e02a781b8da3ebc35d56bbc2c69dadc8dc351b75
|
|
BLAKE2b-256 checksum How to use checksums |
f14e7be4150fd91f26c3b8f8796e9dd90052b5019909df380a3e566e1388e1c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Release files / ampliqc-0.1.1-py3-none-any.whl
| Download URL | ampliqc-0.1.1-py3-none-any.whl |
|---|---|
| Size | 33.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d81594f9fb923bbe7ecfd233c4b2171eab8cd72e7cf054d6c2850c2290034bb1
|
|
BLAKE2b-256 checksum How to use checksums |
8b724f51dba717e7b513433b5f8c1606b3af3c53449ad0641e94627ea325ce45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.12
|
Security for ampliqc 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.