Skip to main content

Usage

Reads cassian.yaml, picks the best available node, starts your container, and restores your workspace. If an instance with the same name is already running, it stops it first.

Options

What happens

  1. Validates your cassian.yaml (including GPU type check)
  2. Connects to Cassian and provisions a container
  3. Restores your workspace files from the last session
  4. Prints runtime info (Python version, Torch version, GPU model)
  5. Installs dependencies (auto-detected or from workspace.setup)
  6. Shows connection instructions

Startup time

First cassian up for a new volume takes 30 to 60 seconds depending on how much data is in your workspace. Repeat cassian up (after cassian down) is faster because your volume is cached on the node. Typically under 20 seconds.

Switching GPUs without editing cassian.yaml

Useful when your preferred type is unavailable. The flag overrides gpu.type for this session only — your cassian.yaml is unchanged.

Fast restart

Skips both the file push and the setup command. Use when your environment is already installed and your files haven’t changed — shaves 30+ seconds off restarts.

Auto dependency install

If workspace.setup is not set in cassian.yaml, Cassian detects and installs automatically:
  • requirements.txt in project root runs pip install -r requirements.txt
  • pyproject.toml in project root runs pip install -e .
To disable this: cassian up --no-setup To set an explicit command:

GPU type validation

Runtime banner