hail

library0.2.138pypypi✓ verified 83d ago

Hail is an open-source, general-purpose, Python-based data analysis tool with additional data types and methods for working with genomic data. Current version 0.2.138, with monthly releases. Requires Python >=3.10.

data ai-ml

pip install hail

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · HAIL

hail

datapythonv0.2.138

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

✓ import hail as hl

✗ from hail import *

Hail's API is exposed via the `hl` module; wildcard imports can cause namespace pollution.

init

✓ hl.init()

✗ hail.init()

Must call init after import, before any Hail operations.

Initializes Hail, simulates a simple genetic dataset, and displays it.

import hail as hl hl.init() mt = hl.balding_nichols_model(n_populations=3, n_samples=100, n_variants=10) mt.show()

Debug

Known issues

breakingHail removed support for Python 3.9 and below. Requires Python >=3.10 as of version 0.2.130.

fix

Upgrade to Python 3.10 or later.

affects: >=0.2.130

deprecatedThe VCF import method `hl.import_vcf` is deprecated; use `hl.import_vcf_bgen` or `hail.VariantDataset.from_vcf` instead.

fix

Replace `hl.import_vcf` with `hl.import_vcf_bgen` or the new VDS API.

affects: >=0.2.120

gotchaHail uses lazy evaluation; mutations to MatrixTable require writing to disk or calling `.persist()` to enforce computation.

fix

Use `mt = mt.persist()` or `hl.write(mt, 'output.ht')` to trigger execution.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'hail'

Hail not installed or installed in wrong environment.

fix

Run `pip install hail` in the correct Python environment (Python >=3.10).

ValueError: Hail is not initialized. Call hl.init() before using Hail methods.

Forgot to call `hl.init()` after import.

fix

Add `hl.init()` after `import hail as hl`.

java.lang.OutOfMemoryError: Java heap space

Default Spark memory settings are insufficient for large datasets.

fix

Configure memory via `hl.init(spark_conf={'spark.executor.memory': '16g', 'spark.driver.memory': '16g'})`.

Upgrade

Version history

0.2.138latest on PyPI · released Apr 16, 2026

Audit

Dependencies

pysparkrequiredHail uses Apache Spark for distributed computing.

numpyrequiredRequired for array operations.

pandasrequiredRequired for DataFrame integration.

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/hail-is/hail ↗

packagehttps://pypi.org/project/hail/ ↗

homepagehttps://hail.is ↗

docshttps://hail.is/docs/0.2/ ↗