<commit_before>.. _sec-installation:

===============
Installing Hail
===============

Requirements
------------

Regardless of installation method, you will need:

- `Java 8 JDK
  <http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html>`_
  Note: it *must* be version eight. Hail does not support Java versions nine,
  ten, or eleven due to our dependency on Spark.
- Python 3.6 or later, we recommend `Anaconda's Python 3
  <https://www.continuum.io/downloads>`_

For all methods *other than using pip*, you will additionally need `Spark
2.2.x
<https://www.apache.org/dyn/closer.lua/spark/spark-2.2.2/spark-2.2.2-bin-hadoop2.7.tgz>`_.


Installation
------------

Installing Hail on Mac OS X or GNU/Linux with pip
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you have Mac OS X, this is the recommended installation method for running
hail locally (i.e. not on a cluster).

.. code-block:: sh

    pip install hail=0.2.1

This must be the ``pip`` for a ``python`` version 3.6 or later, the default
``python`` on Mac OS X will not work.


Running Hail locally with a pre-compiled distribution
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. include:: distLinks.rst

A pre-compiled distribution will be suitable for most users. If you'd like to use Hail with a different version of
Spark, see `Building your own JAR`_.
<commit_msg>remove specific hail version from pip install (#4579)<commit_after>.. _sec-installation:

===============
Installing Hail
===============

Requirements
------------

Regardless of installation method, you will need:

- `Java 8 JDK
  <http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html>`_
  Note: it *must* be version eight. Hail does not support Java versions nine,
  ten, or eleven due to our dependency on Spark.
- Python 3.6 or later, we recommend `Anaconda's Python 3
  <https://www.continuum.io/downloads>`_

For all methods *other than using pip*, you will additionally need `Spark
2.2.x
<https://www.apache.org/dyn/closer.lua/spark/spark-2.2.2/spark-2.2.2-bin-hadoop2.7.tgz>`_.


Installation
------------

Installing Hail on Mac OS X or GNU/Linux with pip
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you have Mac OS X, this is the recommended installation method for running
hail locally (i.e. not on a cluster).

.. code-block:: sh

    pip install hail

This must be the ``pip`` for a ``python`` version 3.6 or later, the default
``python`` on Mac OS X will not work.


Running Hail locally with a pre-compiled distribution
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. include:: distLinks.rst

A pre-compiled distribution will be suitable for most users. If you'd like to use Hail with a different version of
Spark, see `Building your own JAR`_.

{'fraction_non_alphanumeric': 0.1992831541218638, 'fraction_numerical': 0.01971326164874552, 'mean_word_length': 3.862369337979094, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 4, 'lorem ipsum': 0, 'www.': 6, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7137870', 'n_tokens_mistral': 893, 'n_tokens_neox': 813, 'n_words': 319}