CLI

​

Installation

Install the AMDS CLI using pip:

pip install amds

Or using uv:

uv pip install amds

​

CLI Commands

​

Authentication

amds login

Log in to your American Data Science account.

Alternatively, you can set the AMDS_API_KEY environment variable:

export AMDS_API_KEY="your-api-key-here"

​

Start Default Server

amds servers start --server-name default

​

List Servers

amds servers list

Display all notebook servers associated with your account.

​

Get Server Details

amds servers get --server-name <name>

Get detailed information about a specific notebook server.

​

Start Server

amds servers start --server-name <name> [options]

Start a notebook server with the specified name and optional parameters.

​

Optional Parameters:

• --environment: Specify the environment (e.g., pytorch, jax)
• --compute: Choose compute type (e.g., amds-medium_cpu, amds-t4, lambdalabs-a100)
• --port: Set custom port number
• Additional parameters available for customization

​

Stop Server

amds servers stop --server-name <name>

Stop a running notebook server.

​

Launch Local Jupyter Lab

amds jupyter launch

Launch a local Jupyter Lab server that connects to your online Alph editor. This allows you to work with your notebooks and files in a familiar Jupyter interface while maintaining connection to your Alph environment.