# Installation

[![PyPI](https://img.shields.io/pypi/v/konduit?style=for-the-badge)](https://pypi.org/project/konduit/0.1.2/)[![Conda (channel only)](https://img.shields.io/conda/vn/konduitai/konduit?color=%233EB049\&style=for-the-badge)](https://anaconda.org/konduitai/konduit)

## System requirements

**Operating systems** Konduit Serving is supported on Linux, macOS and Windows.

**Dependencies** Ensure that you have JDK 8.0 installed. To use the Python SDK, install Python 3.7 and above.

**Hardware requirements** Binaries are provided for Intel/x86 architectures. For ARM support, see the [*Building from source*](/0.1.0-snapshot/building-from-source.md#manual-build) page.

**GPU**: Hardware acceleration with CUDA version 10.1 (included in GPU build) is supported.

## Installation

Install `konduit` from PyPI with

```bash
pip install konduit
```

{% hint style="warning" %}
A version of Konduit Serving with the command line interface (CLI) is not currently available on PyPI. To obtain the CLI, clone the [konduit-serving](https://github.com/KonduitAI/konduit-serving) repository, and in the `python` folder run

`pip install`.
{% endhint %}

If using the Anaconda distribution, you may install `konduit` from the `konduitai` Anaconda channel. First add the `konduitai` channel:

```
conda config --add channels konduitai
```

then install `konduit` with:

```
conda install -c konduitai konduit
```

You may need to install Cython before installing `konduit` using

```
pip install cython
```

We recommend using Python 3.7+.

{% hint style="warning" %}
`konduit` PyPI wheels and conda packages do not currently ship with Konduit Serving JARs. Refer to the [*Building from source*](/0.1.0-snapshot/building-from-source.md#manual-build) page for instructions on compiling a Konduit Serving JAR.
{% endhint %}

## Set environment variables manually

In the absence of the `KONDUIT_JAR_PATH` environment variable, the Python SDK looks for the Konduit Serving JAR file in `~/.konduit/konduit-serving`. To overwrite this default, you can set a default location for the Konduit Serving JAR using environment variables.

{% tabs %}
{% tab title="Windows" %}
Use [setx.exe](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx):

```bash
setx KONDUIT_JAR_PATH "C:\Users\User\konduit-serving\konduit.jar"
```

{% endtab %}

{% tab title="Linux, macOS" %}

```bash
export KONDUIT_JAR_PATH="~/konduit-serving/konduit.jar"
```

{% endtab %}
{% endtabs %}

## Common installation issues

1. Installing `pyjnius` returns

   ```
   WARNING: Not able to assign machine() = AMD64 to a cpu value! Using cpu = 'i386' instead!
   ```

   Fix: Ensure your JAVA environment variables point to a 64-bit version of Java if you're using a 64-bit version of Python, or a 32-bit version of Java if you're using a 32-bit version of Python (see [kivy/pyjnius#390](https://github.com/kivy/pyjnius/issues/390)).
2. When running `konduit` commands on Windows, the following error message is returned:

   ```
   ImportError: DLL load failed: The specified module could not be found.
   ```

   Fix: On Windows, `pyjnius` requires an additional PATH variable to locate `jvm.dll`. Refer to the [pyjnius documentation](https://pyjnius.readthedocs.io/en/stable/installation.html#installation-for-windows) for details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://serving.konduit.ai/0.1.0-snapshot/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.