Quickstart

This guide will walk you through the initial steps of using the exalsius CLI to start your first development environment.

Closed Beta

We are currently in a closed beta, and registration is limited. Please reach out to run.it@exalsius.ai to request access to exalsius.

1. Install the CLI

The exalsius command-line interface (CLI) is the primary way to interact with the platform.

Python Version

The exalsius CLI requires Python 3.12 or newer.

Install the CLI using pip:

pip install git+https://github.com/exalsius/exalsius-cli.git@main

After installation, verify that the CLI is working correctly by running:

exls --help

You should see a list of available commands.

2. Login

Next, you need to authenticate with your exalsius account.

Run the login command:

exls login

This command will open a new tab in your web browser to complete the login process. If you're on a system without a graphical browser, you can use the QR code displayed in the terminal to authenticate via your mobile phone or another device.

3. Start your First Workspace

exalsius supports a set of prepared AI developer environments: jupyter, marimo, dev-pod.

You can start one by running:

exls workspaces deploy dev-pod --ssh-password <your-password>

You'll be prompted for a password that you will need to access your dev-pod via ssh.

Get a list of your running workspaces with:

exls workspaces list

Check the details of a workspace with:

exls workspaces get <WORKSPACE-ID>

When the workspace is ready, it will show you how to reach the workspace via the displayed Access field.

First Time Start

When starting workspaces for the first time, it may take a while until they are reachable, as containers need to be pulled first.

Next Steps

You've successfully started your first workspace! Now, let us dive deeper into the concepts of node management, cluster deployment, and workspaces. Next, you'll need to import nodes into your node pool.