Installation¶
CLI v0.23.0
Current version is suppoted on Windows 10 or higher, on MacOS Ventura 13 or higher and Ubuntu 22.04.
Set the python environment¶
To install the Jetraw CLI we need a clean environment and Python installed. For this, we recommend the following steps:
Install Miniconda: This will install a base version of Python too. To achieve this please proceed as follows:
Download the Miniconda installer for MacOS from the official website.
Open the Terminal.
Navigate to the location where you downloaded the installer. For example, if the installer is in your Downloads folder, you can navigate there with
cd /Downloads
.Run the installer. Replace
Miniconda3-latest-MacOSX-x86_64.sh
with the name of the file you downloaded.$ bash Miniconda3-latest-MacOSX-x86_64.sh
Close the Terminal and open a new Terminal window to activate the changes. Type in this command to verify the installation:
$ conda --version
Create a new environment with the following command:
$ conda create -n jetraw-env python=3.13
Activate the environment with this command:
$ conda activate jetraw-env
Once Python and a the environment has been created and activated, the next step is to install the Jetraw CLI. To do so there are a few options that we propose in the following sections.
Install Jetraw CLI¶
There are two main ways to install the Jetraw CLI (explained below):
install the wheels which have been previously downloaded or, install with pip
directly from source.
The first option is recommended for general usage.
Install from a locally downloaded wheel¶
We suggest to install a locally downloaded wheel by following these steps :
Download the wheel from Dotphoton Website.
Pip install from local downloaded wheel
$ pip install jr_cli --index-url https://jetraw-releases.s3.eu-central-2.amazonaws.com
NB: The Jetraw CLI will only be available in the given environment (jetraw-env
in the example above), the user will need to reactivate this environment everytime they open a new terminal for the jr
command to work.
To check that jr
is correctly installed, type in the terminal the following line to see the current installed versions:
$ jr --version
> jr version 0.23.0
Authentication¶
After installing the Jetraw CLI, the user will need to authenticate to the platform. This can be done by running the following command:
$ jr auth login
This will open a browser window where the user will need to login to the platform. Once the login is successful, the user can continue using jr
.