> ## Documentation Index
> Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt
> Use this file to discover all available pages before exploring further.

> Guide to install Atoti

# Installation

If you need help, reach out on [GitHub](https://github.com/atoti/atoti/discussions).

Atoti and its plugins (such as the [`JupyterLab extension`](../api/atoti_jupyterlab#module-atoti_jupyterlab)) are available on [PyPI](https://pypi.org/project/atoti) and can thus be installed with package managers such as [uv](https://docs.astral.sh/uv):

```bash theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
uv add "atoti[jupyterlab]"
```

or [pip](https://pip.pypa.io):

```bash theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
pip install "atoti[jupyterlab]"
```

## Advanced

### ActiveViam repository

Installing Atoti Python SDK packages with PyPI is the easiest way but they can also be downloaded from ActiveViam’s repository by configuring `https://activeviam.jfrog.io/artifactory/api/pypi/pypi/simple/` as an [extra-index-url](https://docs.astral.sh/uv/reference/settings/#extra-index-url).

### Client only

Projects using Atoti Python SDK exclusively to [`connect`](../api/atoti.Session.connect#atoti.Session.connect) to already running Atoti sessions (i.e. never [`starting`](../api/atoti.Session.start#atoti.Session.start) new ones) do not need the `atoti` package and can instead install `atoti-client`.

`atoti-client` and its [extras](https://packaging.python.org/en/latest/specifications/dependency-specifiers/#extras) do not require a Java runtime and do not embed any JARs so they take up significantly less disk space.

```bash theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
uv add atoti-client
```

Or, with the [`JupyterLab extension`](../api/atoti_jupyterlab#module-atoti_jupyterlab) extra:

```bash theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
uv add "atoti-client[jupyterlab]"
```

### Custom JDK

Installing `atoti` will install [jdk4py](https://github.com/activeviam/jdk4py): a Python package embedding a JDK including all the Java modules required to run Atoti.

Projects willing to use their own JDK can skip the installation of `jdk4py`:

```bash theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
uv add atoti-client atoti-server
```

This requires the `JAVA_HOME` environment variable to point to a JDK >=21.

### Offline

Tools such as [pip download](https://pip.pypa.io/en/stable/cli/pip_download/) can be used to facilitate offline installation.