16.3. Getting Started

Thie document describes clara commands.

16.3.1. create model

Create a model from a directory. The Model Directory must conform to TRITON server specifications.

16.3.1.1. Usage

$ clara create model -p [MODEL_DIRECTORY] -t [MODEL_TYPE] [--raw]

16.3.1.2. Flags

Name Shorthand Default Usage
path p   Model path
type t   Model Type {“tensorflow”, “tensorrt”, “pytorch”, “unknown”}
raw r false Show output in raw format

16.3.2. list model

Lists information about models

16.3.2.1. Usage

$ clara list models [--quiet]

16.3.2.2. Flags

Name Shorthand Default Usage
quiet q false Only show model ids

16.3.3. delete models

Delete models.

16.3.3.1. Usage

$ clara delete models [MODEL_ID]...

16.3.3.2. Arguments

Name Default Usage
MODEL_ID   The full or partial unique identifier of the model. Partial unique identifiers can be used so long as it matches from left-to-right and uniquely identifies a model.

All the model ids passed as argument are deleted.

16.3.4. create job

Creates a job from a name, pipeline id, job priority and file or directory.

16.3.4.1. Usage

$ clara create job -n NAME -p PIPELINE_ID [-f [FILE | DIRECTORY]] [-i JOB_PRIORITY] [--start]

16.3.4.2. Flags

Name Shorthand Default Usage
name n   Name of the job
pipeline p   Pipeline id
priority i normal Job Priority {“low”, “normal”, “high”, “immediate}”
files f   Filename or directory to files used to create the job
start s false Start the job (without any arguments) after creating it
raw r false Show output in raw format

16.3.5. start job

Starts a created job from job id.

16.3.5.1. Usage

$ clara start job -j JOB_ID [-a KEY=VALUE]...

16.3.5.2. Flags

Name Shorthand Default Usage
args a   Argument to the job in KEY=VALUE format
job j   Job id

16.3.6. create pipelines

Creates a clara pipeline.

16.3.6.1. Usage

$ clara create pipeline -p PIPELINE_DEFINITION_FILE

16.3.6.2. Flags

Name Shorthand Default Usage
path p   Pipeline definition file path
raw r false Show output in raw format

16.3.7. list pipelines

Lists pipelines.

16.3.7.1. Usage

$ clara list pipelines

16.3.7.2. Flags

Name Shorthand Default Usage
quiet q false Only show pipeline ids

16.3.8. describe pipeline

Prints definition of the pipeline.

16.3.8.1. Usage

$ clara describe pipeline -p PIPELINE_ID

16.3.8.2. Flags

Name Shorthand Default Usage
pipeline p   The full or partial unique identifier of the Clara pipeline. Partial unique identifiers can be used so long as it matches from left-to-right and uniquely identifies a pipeline.

16.3.9. list jobs

Lists jobs.

16.3.9.1. Usage

$ clara list jobs

16.3.9.2. Flags

Name Shorthand Default Usage
quiet q false Only show job ids
all   false List all jobs including canceled ones
canceled   false List only canceled jobs
faulted   false List only faulted jobs

16.3.10. cancel jobs

Submit reuqest to cancel job(s).

16.3.10.1. Usage

$ clara cancel jobs [-j JOB_ID1,JOB_ID2...] [--all]
$ clara cancel jobs [-j JOB_ID1,JOB_ID2...] [--all]

16.3.10.2. Flags

Name Shorthand Default Usage
all   false Cancel all jobs

16.3.10.3. Arguments

Name Default Usage
JOB_ID   The full or partial unique identifier of the Clara job. Partial unique identifiers can be used so long as it matches from left-to-right and uniquely identifies a job.

16.3.11. upload payload

Uploads payloads

16.3.11.1. Usage

$ clara upload payload -p PAYLOAD_ID -f {FILE | DIRECTORY}

16.3.11.2. Flags

Name Shorthand Default Usage
files f   Payload file or directory to read from
payload p   Payload identifier

16.3.12. delete payloads

Delete payloads.

16.3.12.1. Usage

$ clara delete payloads -p PAYLOAD_ID1[,PAYLOAD_ID2...]
$ clara delete payload -p PAYLOAD_ID1[,PAYLOAD_ID2...]

16.3.12.2. Arguments

Name Default Usage
PAYLOAD_ID   Full unique identifier of the clara payload.

16.3.13. download

Download files associated with the selected job.

16.3.13.1. Usage

$ clara download JOB_ID:SRC_PATH [DEST_PATH] [flags]

16.3.13.2. Arguments

Name Default Usage
JOB_ID   The full or partial unique identifier of the Clara job from which to download content from. Partial unique identifiers can be used so long as it matches from left-to-right and uniquely identifies a job.
SRC_PATH   Source path of the file(s) to download. File names are relative to the root of the payload. Supports simple glob style pattern matching.
DEST_PATH . Optional destination path where the files will be downloaded. By default file(s) will be downloaded to the current directory.

16.3.14. describe job

Prints the information and status of the job.

16.3.14.1. Usage

$ clara describe job -j JOB_ID

16.3.14.2. Flags

Name Shorthand Default Usage
job j   The full or partial unique identifier of the Clara job from which to download content from. Partial unique identifiers can be used so long as it matches from left-to-right and uniquely identifies a job.

16.3.15. config

Configures NGC credentials for use by CLI.

16.3.15.1. Usage

If –orgteam is not specified, the orgteam defaults to ‘nvidia/clara’ which points to the publicly available Clara NGC artifacts

$ clara config [flags]

16.3.15.2. Flags

Name Shorthand Default Usage
key     NGC API Key
orgteam   nvidia/clara Org and team (input format: “{org}[/{team}]” team is optional)
yes y false Bypass the prompt

16.3.16. logs

Read clara job operator logs.

16.3.16.1. Usage

$ clara logs [flags]

16.3.16.2. Flags

Name Shorthand Default Usage
job j   Clara Job Id
operator o   Clara Job Operator

16.3.17. version

Displays the clara cli and clara platform version info

16.3.17.1. Usage

$ clara version