genoio

genoio reads VCF/BCF, PLINK1, PLINK2, and BGEN genotype sources into Python matrices. The public API is Python; the file readers are Rust. This pairing keeps the interface simple while moving parsing and matrix construction into compiled, efficient code.

It is built for downstream genetics tools that need stable matrix contracts: samples on rows, variants on columns, and metadata aligned to returned matrices, blocks, or regions.

Install

To install the most recent release:

pip install genoio

Or the latest:

pip install git+https://github.com/mancusolab/genoio.git

Documentation

For complete documentation and examples, see the documentation site.

Quick Example

import genoio

ds = genoio.pfile("data/chr22_hg38")
samples = ds.samples()
y = load_phenotype_vector(samples["iid"])
C = load_covariates(samples["iid"])

for X, variants in ds.iter_blocks(10_000, return_variants=True):
    # X has shape (samples, variants_in_this_block).
    # `y` and `C` must be aligned to the rows described by `samples`.
    association_scan(X, y, C, variants=variants)

Use read(...) for one matrix, iter_blocks(...) for streaming scans, and iter_regions(...) for interval-based workflows.

License

MIT. See LICENSE.

Notes

genoio was developed by members of the Mancuso Lab with assistance from Codex, following the practices described in the scientific-software-playbook and coding-skills repositories.

Project links

Data verified by PyPI on Jul 2, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.4.1)

1 maintainer

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

Credits

Author: Mancuso Lab

GitHub Statistics

Data verified by PyPI on Jul 2, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python >=3.11

Provides Extra

dev docs

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

genoio-0.3.0.tar.gz (193.8 kB view details)

Uploaded Source

Built Distributions

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

genoio-0.3.0-cp314-cp314-manylinux_2_34_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.34+ x86-64

genoio-0.3.0-cp314-cp314-macosx_11_0_arm64.whl (4.4 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

genoio-0.3.0-cp313-cp313-manylinux_2_34_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.34+ x86-64

genoio-0.3.0-cp313-cp313-macosx_11_0_arm64.whl (4.4 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

genoio-0.3.0-cp312-cp312-manylinux_2_34_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.34+ x86-64

genoio-0.3.0-cp312-cp312-macosx_11_0_arm64.whl (4.4 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

genoio-0.3.0-cp311-cp311-manylinux_2_34_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.34+ x86-64

genoio-0.3.0-cp311-cp311-macosx_11_0_arm64.whl (4.4 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

File details

Details for the file genoio-0.3.0.tar.gz.

File metadata

  • Download URL: genoio-0.3.0.tar.gz
  • Upload date:
  • Size: 193.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for genoio-0.3.0.tar.gz
Algorithm Hash digest
SHA256 34454f114f9afcde03b15845907f1e5887d87fa479a44b875722c247568e2b24
MD5 51eba13913491f39637b2562a2c036c8
BLAKE2b-256 97c2f183f421a1c35d047567e908487980d660b93a76a636f826a502cedeaf1a

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0.tar.gz:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp314-cp314-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 eb9a2b7f9a00878f1a623a9a919a63e812c55cb4f8d7e0aacf8b9e987177133e
MD5 1e25afd46bb052077aaec04ba09513d9
BLAKE2b-256 42f3eff362656ee1c33eb8abe46d1013ee6c99fde5e13a1fec88ba311f61e04c

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp314-cp314-manylinux_2_34_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e199ef8f8f71255937eb2bb36f070b07add33a191c329d70e9caed753ce81e0e
MD5 0d1447b7d7b39a29a9f45f47c60447cd
BLAKE2b-256 234bbe8d61f89c469f152f4670ba3ffbe3ab570f46321dad859ad3ea1b63ba49

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp314-cp314-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp313-cp313-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 85ece5ab265cdd8340d5f553bec7327b8500d64eb2be89fa17596f989405d7f0
MD5 8f05e459bd3e9a396ed036f5cc1c2657
BLAKE2b-256 43cb789bfed6c5f3dc14234f78fc00af4bf06a80f24b1d41b525f97da5843f72

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp313-cp313-manylinux_2_34_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7be7177b03f6e0c15e934dc23289231d8675748876b17ad5ca7b67eaf52a68b7
MD5 4f79292f5d1f15bcf6ece3f802e56b41
BLAKE2b-256 c8207f05686344602fac57c991c4aecd8445887c16d7a13509a85f8f2e2d0a24

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp312-cp312-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 9e9e62347ac6c90641125ff4d0201b7393678e7314c49295b840750bc32c1429
MD5 29d2994bbdaa2a95ddcc9a83887288a5
BLAKE2b-256 714e11466e7f8490c77d1c1ab5e5cf76506eee08a7a1766ec39940e35f091bd2

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp312-cp312-manylinux_2_34_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a2d2784cd6c8a7d484608e98ded8a81b0af58d3dba9bf0b52a9d64ca2fad016a
MD5 1d3412eeef47488be665c80dc086aca8
BLAKE2b-256 ddc133be6fe828478173fb57701a1bf4aadb11d1b43de4034879f253ac814186

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp311-cp311-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp311-cp311-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 18fb09abbc02b35cd91fd61372cc9dc3cad544f99cf7e15dd190172bc74b521d
MD5 655bc937a86023c4b66f1aee83457c18
BLAKE2b-256 7da9714202c4e3134fee517ae5b3a32cb4df09ba97442b51ff1af05353bfec19

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp311-cp311-manylinux_2_34_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

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

File details

Details for the file genoio-0.3.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.3.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1f5a8ee3c01d9ad346606eae1c9021387b658311d6be4a57b33bbe8c50de907b
MD5 774d80f239b6a559198f1e94379efb46
BLAKE2b-256 7a005d6d1c4924920a80c09ed90b076a106558dddb13784e2efeff253dc0fc87

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.3.0-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

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

Release history Release notifications | RSS feed

0.4.1

9 files

0.4.0

9 files

This release

0.3.0 This release

9 files

0.2.0

9 files

0.1.0

9 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