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:
Newer release available (1.0.4)

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.2.tar.gz (164.0 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.2-py3-none-any.whl (172.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zipstrain-1.0.2.tar.gz
  • Upload date:
  • Size: 164.0 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.2.tar.gz
Algorithm Hash digest
SHA256 942bdf76f72c0e4783b8b51720d2e49b603a653ac4291ed8fc6289ae196c3dfd
MD5 0fbae7f76936a4e130ee5b26687f8408
BLAKE2b-256 526adf1fb11fbd7cb1d6f7f5178a323af8bb01736b5465b3f87df48519507a32

See more details on using hashes here.

Provenance

The following attestation bundles were made for zipstrain-1.0.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: zipstrain-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 172.2 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 10640225483779c3c2fa7de6c2bb08bde416620caa081fb6485b8064687bcadb
MD5 2866e20a07a6280110b661771f07d96a
BLAKE2b-256 8ad7325978b2d8e002f9e95a7e316bf1e303d36ba24aac56d13299c09a81202c

See more details on using hashes here.

Provenance

The following attestation bundles were made for zipstrain-1.0.2-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

1.0.4

2 files

1.0.3

2 files

This release

1.0.2 This release

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