kmhelpers: A Python toolkit for automated management of genomic indexes
Large-scale genomic sequence search has become a central problem in modern bioinformatics (Karasikov et al., 2025;Marchet, 2024).A widely used family of methods relies on Bloom filters (BFs) (Bloom, 1970) to record, for each indexed sample, which 𝑘-mers (words of length 𝑘) it contains; a query then reports the set of samples containing each queried 𝑘mer.Building such an index over many samples is not a single operation but a chain of interdependent steps, and each step demands specialist knowledge: sizing each Bloom filter to its sample, configuring the third-party components used internally by kmindex (such as the findere (Robidou & Peterlongo, 2021) approximate-membership layer), distributing data and computation, bounding peak RAM, and grouping samples into sub-indexes so that the final index stays small without slowing queries.An error at any step can invalidate downstream results, waste significant computation, or produce an oversized index.We present kmhelpers, an open-source Python toolkit that automates this entire workflow for indexes built with kmindex (Lemane et al., 2024).It hides the technical decisions listed above behind a command-line interface (CLI) and a matching Python API that cover every stage of the 𝑘-mer index lifecycle, from raw samples up to queries, including the federation of independently built indexes into a single queryable resource.
Authors
- Kamil S. Jaroň (ORCID: https://orcid.org/0000-0003-1470-5450)
- Pierre Peterlongo (ORCID: https://orcid.org/0000-0003-0776-6407)
- Sébastien Bellenous (ORCID: https://orcid.org/0009-0002-8429-284X)
Institutions
- Centre National de la Recherche Scientifique (FR)
- Wellcome Sanger Institute (GB)
- Institut de Recherche en Informatique et Systèmes Aléatoires (FR)
- Université de Rennes (FR)
Publication Details
- Journal
- The Journal of Open Source Software
- Published
- 2026-11-18
- DOI
- https://doi.org/10.21105/joss.11287
- Primary Topic
- Algorithms and Data Compression
- Type
- article
- Field-Weighted Citation Impact
- 0.00
Funders
- Wellcome Trust
- Agence Nationale de la Recherche