seqspec is a machine-readable YAML file format for genomic library sequence and structure. It was inspired by and builds off of the Teichmann Lab Single Cell Genomics Library Structure by Xi Chen.

Genomic library structure depends on both the assay and sequencer (and kit) used to generate and bind the assay-specific construct to the sequencing adapters to generate a sequencing library. Therefore, a seqspec is specific to both a genomics assay and sequencer.

A list of seqspec examples for multiple assays and sequencers can be found on this website. Each spec.yaml describes the 5'->3' "Final library structure" for the assay and sequencer. Sequence specification files can be formatted with the seqspec command line tool.

# release
pip install seqspec

# development
pip install git+https://github.com/IGVF/seqspec.git

# verify install
seqspec --help

Documentation:

• Learn about seqspec : docs/DOCUMENTATION.md
• Write a seqspec : docs/TUTORIAL.md
• Contribute a seqspec : docs/CONTRIBUTING.md
• The seqspec specification : docs/SPECIFICATION.md
• YouTube video that introduces seqspec
• bioRxiv preprint that describes seqspec