H2O Sonar Installation
======================
Prerequisites:

- Operating system: Linux or macOS 11+ (x86)
- Python: 3.11
- pip 24.2+
- Java: 1.7+ (H2O-3 backend)
- Optional: `Pandoc <https://pandoc.org/>`__ (for better Enterprise h2oGPT integration results)

Download distribution or Python wheels for your platform and Python version:

- `H2O Sonar releases <https://github.com/h2oai/h2o-sonar/releases>`__

Install Python wheel with **only core dependencies** for your platform:

- **Linux x86 64 bit**:
   - ``pip install`` `h2o_sonar-2.15.0-cp311-cp311-linux_x86_64.whl <https://eval-studio-artifacts.s3.us-east-1ral-1.amazonaws.com/releases/h2o_sonar/h2o_sonar-2.15.0-py3-none-any.whl>`__
- **macOS x86 64 bit**:
   - ``pip install`` `h2o_sonar-2.7.0-cp311-cp311-macosx_11_0_universal2.whl <https://eval-studio-artifacts.s3.us-east-1ral-1.amazonaws.com/releases/h2o_sonar/h2o_sonar-2.7.0-cp311-cp311-macosx_11_0_universal2.whl>`__

Package extras
--------------

Install H2O Sonar with **all** dependencies:

- ``pip install h2o_sonar-<version>.whl[explainers,evaluators]``

Install H2O Sonar with **explainers** dependencies:

- ``pip install h2o_sonar-<version>.whl[explainers]``

Install H2O Sonar with **evaluators** dependencies:

- ``pip install h2o_sonar-<version>.whl[evaluators]``

Install H2O Sonar **core** package only:

- ``pip install h2o_sonar-<version>.whl``


Troubleshooting
---------------
**Error**: ``ERROR: datatable-1.1.0a2155-cp38-cp38-manylinux_2_12_x86_64.whl is not a supported wheel on this platform.``

* In case that ``pip install h2o_sonar-<version>.whl`` command fails with this error message,
  then you may need to upgrade ``pip`` with ``python -m pip install --upgrade pip``
  or ``curl -sS https://bootstrap.pypa.io/get-pip.py | python3.11``.

**Error**: ``ERROR: h2o_sonar-<version>.whl is not a supported wheel on this platform.``

* If this error occurs on macOS, then set ``SYSTEM_VERSION_COMPAT=0`` environment variable before running ``pip install h2o_sonar-<version>.whl``.