Skip to content

Welcome to Krewlyzer

Krewlyzer logo

Krewlyzer is a robust, user-friendly command-line toolkit for extracting a wide range of biological features from cell-free DNA (cfDNA) sequencing data. It is designed for cancer genomics, liquid biopsy research, and clinical bioinformatics, providing high-performance, reproducible feature extraction from BAM files.

Krewlyzer draws inspiration from cfDNAFE and implements state-of-the-art methods for fragmentation, motif, and methylation analysis, all in a modern Pythonic interface with rich parallelization and logging.

Key Features

  • Motif Analysis: End motifs, breakpoint motifs, and diversity scores.
  • Fragment Size Analysis: Coverage (FSC), Ratios (FSR), and Distributions (FSD).
  • Nucleosome Positioning: Windowed Protection Scores (WPS).
  • Tissue of Origin: Orientation-aware Fragmentation (OCF).
  • Methylation: Fragment-level methylation patterns (UXM).
  • Mutant Analysis: Mutant vs. Wild-type fragment size comparison (mFSD).

System Requirements

  • Linux or macOS (tested on Ubuntu 20.04, macOS 12+)
  • Python 3.8+
  • ≥16GB RAM recommended for large BAM files
  • Docker (optional, for easiest setup)

Installation

docker pull ghcr.io/msk-access/krewlyzer:latest
# Example usage:
docker run --rm -v $PWD:/data ghcr.io/msk-access/krewlyzer:latest run-all /data/sample.bam --reference /data/hg19.fa --output /data/output_dir

With uv / pip

uv venv .venv
source .venv/bin/activate
uv pip install krewlyzer
Or install from source: 
git clone https://github.com/msk-access/krewlyzer.git
cd krewlyzer
uv pip install .