Skip to content

apheris🔗

Usage:

$ apheris [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • login: Interactive login to the Apheris platform.
  • logout: Log out of the Apheris platform.
  • version: Print the version of the Apheris CLI.
  • datasets: Use the sub-commands to interact with datasets.
  • compute: Use the sub-commands to interact with Compute Specs.
  • job: Use the sub-commands to interact with jobs.
  • models: Interact with the Model Registry.

apheris login🔗

Interactive login to the Apheris platform. You will be forwarded to a website. For machine to machine applications (m2m), make sure the environment variables APH_SERVICE_USER_CLIENT_ID and APH_SERVICE_USER_CLIENT_SECRET are set. Call apheris login status to check your login status.

Usage:

$ apheris login [OPTIONS] [COMMAND]

Arguments:

  • [COMMAND]: Call apheris login status to show your login status.

Options:

  • --help: Show this message and exit.

apheris logout🔗

Log out of the Apheris platform.

Usage:

$ apheris logout [OPTIONS]

Options:

  • --help: Show this message and exit.

apheris version🔗

Print the version of the Apheris CLI.

Usage:

$ apheris version [OPTIONS]

Options:

  • --help: Show this message and exit.

apheris datasets🔗

Use the sub-commands to interact with datasets.

Usage:

$ apheris datasets [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List all datasets that you have access to.
  • describe: Show information on a single dataset.

apheris datasets list🔗

List all datasets that you have access to.

Usage:

$ apheris datasets list [OPTIONS]

Options:

  • --help: Show this message and exit.

apheris datasets describe🔗

Show information on a single dataset.

Usage:

$ apheris datasets describe [OPTIONS] DATASET_ID

Arguments:

  • DATASET_ID: [required]

Options:

  • --help: Show this message and exit.

apheris compute🔗

Use the sub-commands to interact with Compute Specs.

Usage:

$ apheris compute [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • create: Create a Compute Specification on the Apheris orchestrator.
  • get: Get a Compute Specification from the Apheris orchestrator.
  • list: List all your Compute Specifications.
  • activate: Activate a Compute Specification.
  • deactivate: Deactivate a Compute Specification - stops any running jobs and shuts down any infrastructure that was brought up for this Compute Spec.
  • activate-status: Get information on the status of the activation of a Compute Specification.
  • status: Get the status of a Compute Specification.

apheris compute create🔗

Create a Compute Specification on the Apheris orchestrator. All parameters that are not passed as command line arguments will be interactively queried.

Usage:

$ apheris compute create [OPTIONS]

Options:

  • --dataset_ids TEXT: Comma-separated dataset IDs, e.g. -dataset_ids=id1,id2,id3
  • --ignore_limits: The CLI sets some expected bounds for requested infrastructure resources. Use this flag to override the validation checks if your model requires more resources.
  • --client_n_cpu FLOAT: number of vCPUs of Compute Clients
  • --client_n_gpu INTEGER: number of GPUs of Compute Clients
  • --client_memory INTEGER: memory of Compute Clients [MByte]
  • --server_n_cpu FLOAT: number of vCPUs of Compute Aggregators
  • --server_n_gpu INTEGER: number of GPUs of Compute Aggregators
  • --server_memory INTEGER: memory of Compute Aggregators [MByte]
  • --model_id TEXT: A model ID, e.g. statistics
  • --model_version TEXT: The version of the model to use, e.g. v0.0.5
  • --json PATH: File path to json file that describes a Compute Spec. Please use the interactive workflow once to learn about the expected format. If specified, all other arguments (except for force) must be None to avoid clashes.
  • -f, --force: Do not ask if user is certain, and do not ask for arguments interactively.
  • --help: Show this message and exit.

apheris compute get🔗

Get a Compute Specification from the Apheris orchestrator.

Usage:

$ apheris compute get [OPTIONS] [COMPUTE_SPEC_ID]

Arguments:

  • [COMPUTE_SPEC_ID]: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.

Options:

  • --help: Show this message and exit.

apheris compute list🔗

List all your Compute Specifications.

Usage:

$ apheris compute list [OPTIONS]

Options:

  • -l, --limit INTEGER RANGE: Limit the number of Compute Specifications shown. [x>=1]
  • -v, --verbose: Show more detailed status information.
  • --help: Show this message and exit.

apheris compute activate🔗

Activate a Compute Specification. This will spin up a cluster of Compute Clients and Compute Aggregators.

Usage:

$ apheris compute activate [OPTIONS] [COMPUTE_SPEC_ID]

Arguments:

  • [COMPUTE_SPEC_ID]: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.

Options:

  • -f, --force: Do not ask if user is certain.
  • --help: Show this message and exit.

apheris compute deactivate🔗

Deactivate a Compute Specification - stops any running jobs and shuts down any infrastructure that was brought up for this Compute Spec. Use this if you have spun up a cluster of Compute Clients and Compute Aggregators, and don't need it anymore. Provided the Compute Specification remains approved, you can use activate to reinstate the infrastructure if needed at a later time.

Usage:

$ apheris compute deactivate [OPTIONS] [COMPUTE_SPEC_ID]

Arguments:

  • [COMPUTE_SPEC_ID]: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.

Options:

  • -f, --force: Do not ask if user is certain.
  • --help: Show this message and exit.

apheris compute activate-status🔗

Get information on the status of the activation of a Compute Specification.

Usage:

$ apheris compute activate-status [OPTIONS] [COMPUTE_SPEC_ID]

Arguments:

  • [COMPUTE_SPEC_ID]: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.

Options:

  • --help: Show this message and exit.

apheris compute status🔗

Get the status of a Compute Specification.

Usage:

$ apheris compute status [OPTIONS] [COMPUTE_SPEC_ID]

Arguments:

  • [COMPUTE_SPEC_ID]: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.

Options:

  • -v, --verbose: Show more information about Compute Spec status. Can be used to diagnose the issue when your Compute Spec is stuck in creating, forexample, due to capacity constraints.
  • --help: Show this message and exit.

apheris job🔗

Use the sub-commands to interact with jobs.

Usage:

$ apheris job [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • run: Submit a job to run it.
  • list: List jobs.
  • status: Get the status and details of a job.
  • abort: Abort a currently running job.
  • download-results: Download the results of a job.
  • logs: Download the logs for a job, which can be optionally written to a file.

apheris job run🔗

Submit a job to run it.

Usage:

$ apheris job run [OPTIONS]

Options:

  • --payload TEXT: Arguments to provide to the job. You can either provide the filepath to a json-file, or a string that contains a json-compatible dictionary.
  • --compute-spec-id UUID: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.
  • -f, --force: Do not ask if user is certain.
  • -v, --verbose: Show more detailed information.
  • --help: Show this message and exit.

apheris job list🔗

List jobs.

Usage:

$ apheris job list [OPTIONS]

Options:

  • --compute-spec-id UUID: The ID of the Compute Spec. If None, returns all jobs
  • --help: Show this message and exit.

apheris job status🔗

Get the status and details of a job.

Usage:

$ apheris job status [OPTIONS]

Options:

  • --job-id UUID: The ID of the job. If None, use the most recently used job ID.
  • --compute-spec-id UUID: This argument is deprecated and will be removed in future releases.
  • -v, --verbose: Show more detailed information.
  • --help: Show this message and exit.

apheris job abort🔗

Abort a currently running job.

Usage:

$ apheris job abort [OPTIONS]

Options:

  • --job-id UUID: The ID of the job. If None, use the most recently used job ID.
  • --compute-spec-id UUID: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.
  • -f, --force: Do not ask if user is certain.
  • --help: Show this message and exit.

apheris job download-results🔗

Download the results of a job.

Usage:

$ apheris job download-results [OPTIONS] [DOWNLOAD_PATH]

Arguments:

  • [DOWNLOAD_PATH]: Directory to store the downloaded results

Options:

  • --job-id UUID: The ID of the job. If None, use the most recently used job ID.
  • --compute-spec-id UUID: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.
  • --help: Show this message and exit.

apheris job logs🔗

Download the logs for a job, which can be optionally written to a file.

Usage:

$ apheris job logs [OPTIONS]

Options:

  • --storage-path FILE: File in which to store logs (plaintext)
  • --job-id UUID: The ID of the job. If None, use the most recently used job ID.
  • --compute-spec-id UUID: The ID of the Compute Spec. If None, use the most recently used Compute Spec ID.
  • --help: Show this message and exit.

apheris models🔗

Interact with the Model Registry.

Usage:

$ apheris models [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • list: List models that are available in the Model Registry.Note that only the 3 most recent versions of each model are shown.
  • add-version: Add a new version to an existing model in the Model Registry.

apheris models list🔗

List models that are available in the Model Registry.Note that only the 3 most recent versions of each model are shown.

Usage:

$ apheris models list [OPTIONS]

Options:

  • --help: Show this message and exit.

apheris models add-version🔗

Add a new version to an existing model in the Model Registry.

Usage:

$ apheris models add-version [OPTIONS] MODEL_ID

Arguments:

  • MODEL_ID: Apheris ID of the model to which you want to add a version to. Obtainable via Apheris UI or CLI. [required]

Options:

  • --version TEXT: Version number for the new model version. Needs to match the repo that holds the built image. [required]
  • --digest TEXT: Digest for the new model. Needs to match the repository that holds the built image. [required]
  • --commit-hash TEXT: Hash for the new model version. [required]
  • --help: Show this message and exit.