Skip to main content

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.

  • 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)

Source distribution for aksha 0.2.2
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)

Table of built distributions (wheels) for aksha 0.2.2
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files No provenance

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