Installation¶

You can install Atoti and its JupyterLab extension with conda (recommended) or pip.

With Conda¶

1. Install Conda¶

Important

Make sure to use a 64-bit version since some packages are not available with Conda 32-bit like openjdk’s recent version.

Install Miniconda 64-bit (recommended) or Anaconda 64-bit.

2. Set up conda-forge channel¶

Add conda-forge to your Conda channels:

conda config --add channels conda-forge

3. Set up Atoti channel¶

Add our channel to your configuration:

conda config --add channels https://conda.atoti.io

4. Create a new Conda environment¶

Create a new Conda environment and activate it:

                          conda create --name atoti
conda activate atoti

5. Install Atoti¶

Install Atoti and its companion packages:

conda install atoti jupyterlab jupyterlab-atoti nodejs openjdk

6. Rebuild JupyterLab¶

JupyterLab needs to be rebuilt to include the Atoti extension (it can take several minutes):

Linux / macOS¶

                            NODE_OPTIONS=--max-old-space-size=4096 jupyter lab build --dev-build False --minimize True

                          

Windows¶

                            set NODE_OPTIONS=--max-old-space-size=4096 & jupyter lab build --dev-build False --minimize True

                          

Advanced¶

Atoti+¶

Atoti+ is our entreprise edition, it requires a license.

First, follow steps 1. Install Conda and 2. Set up conda-forge channel.

Then, add the Atoti channel to your Conda configuration, replacing {{username}} and {{password}} with your credentials (contact support@atoti.io if you don’t have any):

                          conda config --add channels https://{{username}}:{{password}}@conda.atoti.io

                        

Install Atoti+ and its companion packages:

conda install atoti-plus jupyterlab jupyterlab-atoti nodejs openjdk

Finally, follow step 6. Rebuild JupyterLab.

Without Artifactory¶

If your network policy is blocking our Artifactory repository, you will have to use this less convenient setup and upgrades won’t be streamlined.

First, you need to have the artifacts of our Conda packages on your computer. Let’s say you have our packages at /home/me/project/atoti-0.3.0-0.tar.bz2 and /home/me/project/jupyterlab-atoti-0.3.0-0.tar.bz2. Then, to install them, run these commands:

                          # Create a local Conda channel first.
conda install conda-build
mkdir -p /home/me/project/tmp/channel/noarch
mv /home/me/project/atoti-0.3.0-0.tar.bz2 /home/me/project/tmp/channel/noarch
conda index /home/me/project/tmp/channel/
# Do the actual installation.
conda install --channel file://home/me/project/tmp/channel atoti jupyterlab jupyterlab-atoti nodejs openjdk

                        

Finally, follow step 6. Rebuild JupyterLab.

Without Conda¶

If you would rather use pip/Pipenv/Poetry than Conda, the library is also available as a Python Wheel. Contact us for more information at support@atoti.io.