robbie run

robbie run

Description

Launches a robbie “run” from the command line.

Synopsis

Robbie run [OPTIONS] [COMMANDS]

Commands

Commands can include any Linux command(s), for example:

• “pwd”

• “nvidia-smi”

• “python file.py”

• “pip install -r requirements && python main.py”

• “python -c ‘import os; os.getcwd()’”

Even more sophisticated commands:

• “tune run lora_finetune_single_device --config llama3/8B_lora_single_device”

• “wandb agent sweep_id”

If you do not specify Commands, Robbie will look at the `job_config.yaml` file in the local directory for commands and execute those.

Options

--name (string)

String that contains the user-defined name of the run. If you omit this option, Robbie will choose a unique name for your run.

--f (string)

String that contains the job configuration file in the local directory to use when running the job.

--conda (boolean)

Run the remote job in a conda environment. If --deps is set to auto-capture then the current active conda environment will be used. If --deps points to an existing environment.yml file that file will be used to recreate the environment on the remote machine.

--python (boolean)

Run the remote job in a Python environment. The --version and --deps are used to create a Python environment on the remote machine.

--funding_group (string)

String that contains the UUID of the funding group that the job will be billed against.

For example, “cecfc347-5680-4fb0-ae99-b000941b08dd”

--environment_id (string)

String that contains the UUID of the environment that the job will use.

For example, “d26d6431-f1a5-4cea-b929-a4ed1f70eaaa”

--image (string)

String that contains the image name or “auto-select”. By specifying “auto-select” Robbie will choose the correct image for you.

For example, “robbie:1.0.0-gpu-py3.10-torch2.2-ubuntu22.04-dev”

--deps (string)

Name of the dependency file to use for the job. If the job is conda-based, this points to an environment .yml file, if this a python job, this points to the requirements.txt file. If you specify auto-capture Robbie will attempt to capture the local dependencies.

--include-local-dir (boolean)

Copies the contents of the local directory to the remote machine.

--tail -Streams the standard out of the remote host to the local host.

--v -Verbose logging

--y -Automatically run the job without asking the user permission.

--i -Build the job configuration interactively before you run it.

--download <file_name>

Download the file_name from the remote machine /results directory to the local directory. If <file_name> is “all”, then all files in the remote /results directory are zipped and downloaded as result.zip.

--path <dir>

Download the file_name from the remote machine to the specified directory.