Aksha
Fast HMM-based annotation for genomes and metagenomes.
Aksha accelerates HMM-based sequence searches so you can spend more time on biology and less time waiting for annotations. Built on HMMER and PyHMMER, it combines fast CPU searches, optional NVIDIA GPU acceleration, database management and sequence retrieval in one command-line tool.
Aksha outperformed MetaCerberus 1.4 in our Pfam benchmarks on both CPU and GPU.
Benchmark results and comparison conditions
The recorded PLM2_5 workload contained 300,186 proteins and 27,481 Pfam models.
| Tool / configuration | Physical CPU cores | Pfam runtime | Speedup over MetaCerberus |
|---|---|---|---|
| MetaCerberus 1.4, CPU | 64 | 11m 34s | — |
| Aksha, CPU | 64 | 4m 46s | 2.43× |
| Aksha, 1 H200 GPU + CPU | 64 host cores | 3m 39s | 3.17× |
Aksha's CPU and GPU outputs matched exactly in these runs. Both CPU-only runs used 64 physical cores on the same Xeon 6787P machine. The GPU run used one H200 plus 64 physical Xeon Platinum 8480+ host cores on a separate node. Core counts are allocated physical cores, not CPU sockets or SMT threads. MetaCerberus timing covers its HMM search/filter/parse pipeline, not additional reporting; its thresholds and output rules differ, so this is a workflow comparison, not identical-work benchmarking. Measurements predate wheel packaging. CPU evidence and GPU evidence.
More than a fast search
- Search proteins or nucleotide sequences using supported databases or your own HMMs.
- Download and manage databases such as Pfam and KOfam from the same tool.
- Use a database's recommended cutoffs, or choose your own score and E-value thresholds.
- Export tabular results and optionally retrieve matching sequences for downstream analysis.
Installation
The PyPI release is being prepared. Once published:
python -m pip install aksha
# With optional GPU support:
python -m pip install 'aksha[gpu]'
Currently supported: Linux x86-64 with Python 3.12. GPU use requires a compatible NVIDIA GPU and driver. ARM, macOS and Windows are not yet supported. See the installation guide for hardware requirements, local-wheel installation and GPU setup.
Quick start
Download the Pfam protein-family database, then search your protein sequences:
aksha initialize --hmms PFAM
aksha search --prot_in proteins.faa --installed_hmms PFAM --cut_ga --outdir results
Results are written to results/. The example uses Pfam's built-in score
thresholds. You can also supply your own models with --hmm_in instead of
--installed_hmms. Run aksha --help or aksha search --help for more options.
The database setup guide explains available databases, storage locations and reusing existing files. For source builds, see the maintainer guide.
License
Aksha's original code is MIT-licensed; third-party components retain their own licenses. See the application license, native-code license and third-party notices.
Metadata
Release files for aksha 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aksha-0.2.2.tar.gz | 522.2 kB | Without provenance | Details for aksha-0.2.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aksha-0.2.2-py3-none-any.whl | Python 3 | none | any | Details for aksha-0.2.2-py3-none-any.whl |
Total release size: 602.3 kB
Release files / aksha-0.2.2.tar.gz
| Download URL | aksha-0.2.2.tar.gz |
|---|---|
| Size | 522.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b0bca540b3590021c48b2644f378199eeb0c8baae6d9fa34e92983888357633e
|
|
BLAKE2b-256 checksum How to use checksums |
aeaebc614f14e510b91e0f98cb1652ad11ec8afee66a4066c1da76b8beaa2daf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.10
|
Release files / aksha-0.2.2-py3-none-any.whl
| Download URL | aksha-0.2.2-py3-none-any.whl |
|---|---|
| Size | 80.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2aae800f3fa49cc0b409211530209195407ae643c2ce848c9c8ce7ceff9ac4b2
|
|
BLAKE2b-256 checksum How to use checksums |
a1c5a97bd5b1b3e0118b50cf690761e471f26e95f7c6ac6debfbd9a9b310477c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.10
|
Security for aksha 0.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.