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"])

with ds.iter_blocks(10_000, return_variants=True) as blocks:
    for X, variants in blocks:
        # 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.

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.4.0.tar.gz (264.7 kB view details)

Uploaded Jul 30, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

genoio-0.4.0-cp314-cp314-manylinux_2_34_x86_64.whl (5.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.14manylinux: glibc 2.34+ x86-64

genoio-0.4.0-cp314-cp314-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.14macOS 11.0+ ARM64

genoio-0.4.0-cp313-cp313-manylinux_2_34_x86_64.whl (5.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.13manylinux: glibc 2.34+ x86-64

genoio-0.4.0-cp313-cp313-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.13macOS 11.0+ ARM64

genoio-0.4.0-cp312-cp312-manylinux_2_34_x86_64.whl (5.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.12manylinux: glibc 2.34+ x86-64

genoio-0.4.0-cp312-cp312-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.12macOS 11.0+ ARM64

genoio-0.4.0-cp311-cp311-manylinux_2_34_x86_64.whl (5.1 MB view details)

Uploaded Jul 30, 2026 CPython 3.11manylinux: glibc 2.34+ x86-64

genoio-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded Jul 30, 2026 CPython 3.11macOS 11.0+ ARM64

File details

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

File metadata

Download URL: genoio-0.4.0.tar.gz
Upload date: Jul 30, 2026
Size: 264.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`050086d53637911d2cbfbc70b13804b5deadb7b159c711389bc8975794848269`
MD5	`b84c677adb00f2ce0a4db8a2e90d9e00`
BLAKE2b-256	`8c7a5b955983d13f395e35d84f6114fc3a56ab3ac7396e4c6937edabaa2f5dc8`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0.tar.gz
- Subject digest: 050086d53637911d2cbfbc70b13804b5deadb7b159c711389bc8975794848269
- Sigstore transparency entry: 2296180569
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp314-cp314-manylinux_2_34_x86_64.whl
Upload date: Jul 30, 2026
Size: 5.1 MB
Tags: CPython 3.14, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp314-cp314-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`a69b2066640524c6160c49309f5efaa5946303c3ebe07a93c2b762276fc4c5af`
MD5	`54d07fa971c6451bb7577810951facb4`
BLAKE2b-256	`7a8f8233491142595743e3dd39e1ca5b41e18ee76356cba5718109133c13f6c3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp314-cp314-manylinux_2_34_x86_64.whl
- Subject digest: a69b2066640524c6160c49309f5efaa5946303c3ebe07a93c2b762276fc4c5af
- Sigstore transparency entry: 2296180972
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp314-cp314-macosx_11_0_arm64.whl
Upload date: Jul 30, 2026
Size: 4.3 MB
Tags: CPython 3.14, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp314-cp314-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`92711aa4b92c6176cc39c6ed92209aa92ad7e47ef11ba8ac08d5d734c5542ab6`
MD5	`ac85ad6e239007be514ed4c9b8bb748d`
BLAKE2b-256	`20818863d6d3355728b788fd47b6075303041feaff46abb0818ecc9ebdb03af4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp314-cp314-macosx_11_0_arm64.whl
- Subject digest: 92711aa4b92c6176cc39c6ed92209aa92ad7e47ef11ba8ac08d5d734c5542ab6
- Sigstore transparency entry: 2296180705
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp313-cp313-manylinux_2_34_x86_64.whl
Upload date: Jul 30, 2026
Size: 5.1 MB
Tags: CPython 3.13, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp313-cp313-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`e0d641b60d6c70046effc3fa6525e3ba01080e0b57f10506b6c6693bd72dfe73`
MD5	`dedcb8a5e964ad72f2631d5ca9b12c98`
BLAKE2b-256	`3d45856def076bbe5b4d68463e48d4e7d902940ab63b1d5e6a13f0f21fd23561`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp313-cp313-manylinux_2_34_x86_64.whl
- Subject digest: e0d641b60d6c70046effc3fa6525e3ba01080e0b57f10506b6c6693bd72dfe73
- Sigstore transparency entry: 2296181164
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp313-cp313-macosx_11_0_arm64.whl
Upload date: Jul 30, 2026
Size: 4.3 MB
Tags: CPython 3.13, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`12e92aa8ae9a087ba6055a1744ce66b6a4643435c32ce133b7157ea0222a0541`
MD5	`d353f7ecb1f229e7d4811db609d6dfc4`
BLAKE2b-256	`8e52ad6767b3a5cec4d55d0ac218ba525034b5e4ef2677be55ac03e4d5c45de7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp313-cp313-macosx_11_0_arm64.whl
- Subject digest: 12e92aa8ae9a087ba6055a1744ce66b6a4643435c32ce133b7157ea0222a0541
- Sigstore transparency entry: 2296180895
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp312-cp312-manylinux_2_34_x86_64.whl
Upload date: Jul 30, 2026
Size: 5.1 MB
Tags: CPython 3.12, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`bb9e3795d7dbc79db64ad12ef08e3f773c5005554957c0e88ed60a0dfd3b27fc`
MD5	`7de5204095f8494805989a620989de2f`
BLAKE2b-256	`5c74bcbc5a1a640e7138e105e0ea44650daa73eb8ffdc9368dfa3437bd857507`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp312-cp312-manylinux_2_34_x86_64.whl
- Subject digest: bb9e3795d7dbc79db64ad12ef08e3f773c5005554957c0e88ed60a0dfd3b27fc
- Sigstore transparency entry: 2296181108
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp312-cp312-macosx_11_0_arm64.whl
Upload date: Jul 30, 2026
Size: 4.3 MB
Tags: CPython 3.12, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`90ccabee2371a2ddb39207af14ac55e4c22c3f59050a0c85dfdcba113d61176b`
MD5	`4d3a001dc22f4badcaebcd04c2fbcb87`
BLAKE2b-256	`a7145a2618a2beecb1404b180f0e385201c2e181d59bc7688980c087cfd8a4f1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp312-cp312-macosx_11_0_arm64.whl
- Subject digest: 90ccabee2371a2ddb39207af14ac55e4c22c3f59050a0c85dfdcba113d61176b
- Sigstore transparency entry: 2296181044
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp311-cp311-manylinux_2_34_x86_64.whl
Upload date: Jul 30, 2026
Size: 5.1 MB
Tags: CPython 3.11, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp311-cp311-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`3e5f8ebe4649f29bac6a68a8df8802de620b3f59fb4a8b0975ad7bb203dd1a54`
MD5	`64ff6327a56754a14e1db2b8620d978a`
BLAKE2b-256	`3882bdfa36e91a6e7460db28dd9dfcb061204ad79bb8d57a1baa0de0863427e3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp311-cp311-manylinux_2_34_x86_64.whl
- Subject digest: 3e5f8ebe4649f29bac6a68a8df8802de620b3f59fb4a8b0975ad7bb203dd1a54
- Sigstore transparency entry: 2296180641
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

File details

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

File metadata

Download URL: genoio-0.4.0-cp311-cp311-macosx_11_0_arm64.whl
Upload date: Jul 30, 2026
Size: 4.3 MB
Tags: CPython 3.11, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`11a23341e42fc34b6295b62cb0e27ce33248e3a207726c499e378bc2e65af64e`
MD5	`29f0631d067469451060cd19f941b4ee`
BLAKE2b-256	`5fbad990434d5932a8984fe1a871bd7d428345be9b9bec4ac650aab5c67c9c7f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: genoio-0.4.0-cp311-cp311-macosx_11_0_arm64.whl
- Subject digest: 11a23341e42fc34b6295b62cb0e27ce33248e3a207726c499e378bc2e65af64e
- Sigstore transparency entry: 2296180791
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: mancusolab/genoio@760a2527e6a6cb783611c4433b200890497f049c
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/mancusolab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@760a2527e6a6cb783611c4433b200890497f049c
- Trigger Event: release

Release history Release notifications | RSS feed

0.4.1

Aug 28, 2026 9 files

This release

0.4.0 This release

Jul 30, 2026 9 files

0.3.0

Jul 2, 2026 9 files

0.2.0

Jun 22, 2026 9 files

0.1.0

Jun 17, 2026 9 files

genoio 0.4.0

genoio

Install

Documentation

Quick Example

License

Notes

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Provides Extra

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed