Starwhale Resources URI
Resource URI is widely used in Starwhale client commands. The URI can refer to a resource in the local instance or any other resource in a remote instance. In this way, the Starwhale client can easily manipulate any resource.
Instance URIâ
Instance URI can be either:
local
: standalone instance.[http(s)://]<hostname or ip>[:<port>]
: cloud instance with HTTP address.[cloud://]<cloud alias>
: cloud or server instance with an alias name, which can be configured in the instance login phase.
"local" is different from "localhost". The former means the local standalone instance without a controller, while the latter implies a controller listening at the default port 8082 on the localhost.
Example:
# log in Starwhale Cloud; the alias is swcloud
swcli instance login --username <your account name> --password <your password> https://cloud.starwhale.ai --alias swcloud
# copy a model from the local instance to the cloud instance
swcli model copy mnist/version/latest swcloud/project/<your account name>:demo
# copy a runtime to a Starwhale Server instance: http://localhost:8081
swcli runtime copy pytorch/version/v1 http://localhost:8081/project/<your account name>:demo
Project URIâ
Project URI is in the format [<Instance URI>/project/]<project name>
. If the instance URI is not specified, use the current instance instead.
Example:
swcli project select self # select the self project in the current instance
swcli project info local/project/self # inspect self project info in the local instance
Model/Dataset/Runtime URIâ
- Model URI:
[<Project URI>/model/]<model name>[/version/<version id|tag>]
. - Dataset URI:
[<Project URI>/dataset/]<dataset name>[/version/<version id|tag>]
. - Runtime URI:
[<Project URI>/runtime/]<runtime name>[/version/<version id|tag>]
.
swcli
supports human-friendly short version id. You can type the first few characters of the version id, provided it is at least four characters long and unambiguous. However, therecover
command must use the complete version id.- If the project URI is not specified, the default project will be used.
- You can always use the version tag instead of the version id.
Example:
swcli model info mnist/version/hbtdenjxgm4ggnrtmftdgyjzm43tioi # inspect model info, model name: mnist, version:hbtdenjxgm4ggnrtmftdgyjzm43tioi
swcli model remove mnist/version/hbtdenj # short version
swcli model info mnist # inspect mnist model info
swcli model run mnist --runtime pytorch-mnist --dataset mnist # use the default latest tag
Job URIâ
- format:
[<Project URI>/job/]<job id>
. - If the project URI is not specified, the default project will be used.
Example:
swcli job info mezdayjzge3w # Inspect mezdayjzge3w version in default instance and default project
swcli job info local/project/self/job/mezday # Inspect the local instance, self project, with short job id:mezday
The default instanceâ
When the instance part of a project URI is omitted, the default instance is used instead. The default instance is the one selected by the swcli instance login
or swcli instance use
command.
The default projectâ
When the project parts of Model/Dataset/Runtime/Evaluation URIs are omitted, the default project is used instead. The default project is the one selected by the swcli project use
command.