ZipStrain

Fast strain-level metagenomics in three commands: map reads to BAMs, profile them into per-position nucleotide-count tables, and compare samples by ANI to tell whether they share a strain.

Documentation:

Install

Conda is the easiest path — it brings in samtools and the map aligners too:

conda create -n zipstrain -c conda-forge -c bioconda \
  python=3.12 zipstrain bowtie2 samtools sylph

Or with pip (into a fresh virtual environment):

pip install zipstrain

Matrix-store comparison dependencies (compare --method matrix):

pip install "zipstrain[matrix]"

Notes:

  • With pip, install samtools separately (profiling needs it); zipstrain map additionally needs bowtie2 and sylph (and prodigal for --predict-genes).

  • On Apple Silicon, use a native osx-arm64 Conda so dependencies install natively; the standard torch wheel uses the MPS backend.

  • Linux CUDA installs should replace Torch with the matching CUDA wheel from PyTorch:

    pip install "zipstrain[matrix]"
pip install --upgrade torch --index-url https://download.pytorch.org/whl/cu124

See the installation guide for full details.

Verify

zipstrain --version
zipstrain test

Cite

If you use ZipStrain in your research, please cite the preprint:

Ghadermazi P, Emerson JB, Olm MR. 2026. ZipStrain Enables Rapid and Precise Strain-Resolved Metagenomics. bioRxiv. DOI: 10.64898/2026.05.20.726564

GitHub citation metadata is provided in CITATION.cff:

License

ZipStrain is distributed under the MIT License.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Parsa6626 from gravatar.com Parsa6626

Credits

Author: ParsaGhadermazi

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Provides Extra

matrix test

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zipstrain-1.0.4.tar.gz (167.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zipstrain-1.0.4-py3-none-any.whl (175.5 kB view details)

Uploaded Python 3

File details

Details for the file zipstrain-1.0.4.tar.gz.

File metadata

  • Download URL: zipstrain-1.0.4.tar.gz
  • Upload date:
  • Size: 167.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for zipstrain-1.0.4.tar.gz
Algorithm Hash digest
SHA256 48fe44c215756c50b7b6df73e3d55a493fa279b1c639747d8c5a076a7dd6863b
MD5 a6e912c84fdcdd23d81956dbcdf1ef4b
BLAKE2b-256 9bc27974e20a612c2e79b2cf483f96934563b3438c2332121bf51f935d3d6e59

See more details on using hashes here.

Provenance

The following attestation bundles were made for zipstrain-1.0.4.tar.gz:

Publisher: pypi-publish.yml on OlmLab/ZipStrain

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zipstrain-1.0.4-py3-none-any.whl.

File metadata

  • Download URL: zipstrain-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 175.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for zipstrain-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 12db629ca3e054b407ab05fc242e071cd1a882c6b5190d87d28a680342d4e4e6
MD5 733b81091027fdcb4f66fdf21fca840c
BLAKE2b-256 78438d800f64de886b4868057446996ec8a81a8e372e20562b57dafa22575bf8

See more details on using hashes here.

Provenance

The following attestation bundles were made for zipstrain-1.0.4-py3-none-any.whl:

Publisher: pypi-publish.yml on OlmLab/ZipStrain

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.0.4 This release

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.11.3

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.21

2 files

0.9.20

2 files

0.9.19

2 files

0.9.18

2 files

0.9.17

2 files

0.9.16

2 files

0.9.15

2 files

0.9.14

2 files

0.9.11

2 files

0.9.10

2 files

0.9.9

2 files

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.3

2 files

0.9.1

2 files

0.9.0

2 files

0.8.7

2 files

0.8.5

2 files

0.8.4

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.8

2 files

0.7.7

2 files

0.7.6

2 files

0.7.5

2 files

0.7.4

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.0

2 files

0.5.17

2 files

0.5.16

2 files

0.5.15

2 files

0.5.14

2 files

0.5.13

2 files

0.5.12

2 files

0.5.11

2 files

0.5.10

2 files

0.5.9

2 files

0.5.8

2 files

0.5.7

2 files

0.5.6

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5

2 files

0.4.23

2 files

0.4.22

2 files

0.4.21

2 files

0.4.20

2 files

0.4.19

2 files

0.4.18

2 files

0.4.17

2 files

0.4.16

2 files

0.4.15

2 files

0.4.14

2 files

0.4.13

2 files

0.4.12

2 files

0.4.11

2 files

0.4.10

2 files

0.4.9

2 files

0.4.8

2 files

0.4.7

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.21

2 files

0.2.20

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page