Version Compatibility

Reference examples tested with: CRISPResso2 2.2+, pandas 2.2+

Before using code patterns, verify installed versions match. If versions differ:

• Python:

  pip show <package>

  then

  help(module.function)

  to check signatures
• CLI:

  <tool> --version

  then

  <tool> --help

  to confirm flags

If code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.

Base Editing Analysis

"Analyze my base editing outcomes" → Quantify base editing efficiency, bystander edits, and indel frequencies from amplicon sequencing data for CBE, ABE, and prime editing experiments.

• CLI:

  CRISPResso --fastq_r1 reads.fq --amplicon_seq ATGC --base_editor_output

CRISPResso2 for Base Editing

Goal: Quantify base editing efficiency and bystander edits from amplicon sequencing.

Approach: Run CRISPResso with --base_editor_output and the expected edited amplicon sequence to measure target base conversion, bystander edits, and indel frequencies.

# Analyze base editing with expected outcome
CRISPResso --fastq_r1 reads.fq.gz \
    --amplicon_seq ATGCGATCGATCGATCGATCGATCG \
    --guide_seq TCGATCGATCGATCGAT \
    --expected_hdr_amplicon_seq ATGCGATCGATCGTTCGATCGATCG \
    --base_editor_output \
    -o results/

Key Metrics

Metric	Description
Editing efficiency	% reads with target base change
Bystander edits	Unintended edits in editing window
Indel frequency	Insertions/deletions (should be low)
Purity	Target edit without bystanders

Base Editor Types

Cytosine Base Editors (CBE)

# C->T conversion (or G->A on opposite strand)
CRISPResso --fastq_r1 reads.fq.gz \
    --amplicon_seq $AMPLICON \
    --guide_seq $GUIDE \
    --base_editor_output \
    --conversion_nuc_from C \
    --conversion_nuc_to T

Adenine Base Editors (ABE)

# A->G conversion (or T->C on opposite strand)
CRISPResso --fastq_r1 reads.fq.gz \
    --amplicon_seq $AMPLICON \
    --guide_seq $GUIDE \
    --base_editor_output \
    --conversion_nuc_from A \
    --conversion_nuc_to G

Prime Editing Analysis

# Prime editing with pegRNA
CRISPResso --fastq_r1 reads.fq.gz \
    --amplicon_seq $AMPLICON \
    --guide_seq $SPACER \
    --expected_hdr_amplicon_seq $EDITED_AMPLICON \
    --prime_editing_pegRNA_extension_seq $EXTENSION \
    -o prime_edit_results/

Editing Window Analysis

import pandas as pd

# Load CRISPResso quantification
quant = pd.read_csv('CRISPResso_output/Quantification_window_nucleotide_percentage_table.txt',
                    sep='\t')

# Calculate per-position editing
editing_window = quant[(quant['Position'] >= -5) & (quant['Position'] <= 5)]

Quality Thresholds

• Editing efficiency: >30% considered good for most applications
• Indel rate: <5% ideal for base editors
• Bystander rate: depends on application; <10% often acceptable

Related Skills

• crispr-screens/crispresso-editing - General editing QC
• crispr-screens/library-design - Guide design considerations
• variant-calling/vcf-basics - Downstream variant analysis