From 041f3e61bba358bf0aecde987568701a6d145527 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Mon, 11 May 2026 22:20:57 +0000 Subject: [PATCH 1/2] Add runpodctl model command reference page Document the runpodctl model list command, including the new Version Hash column that displays the model version hash needed for the --model-reference flag when creating Serverless endpoints. --- docs.json | 1 + runpodctl/overview.mdx | 1 + runpodctl/reference/runpodctl-model.mdx | 49 +++++++++++++++++++++++++ 3 files changed, 51 insertions(+) create mode 100644 runpodctl/reference/runpodctl-model.mdx diff --git a/docs.json b/docs.json index 53b7e698..ce91aa37 100644 --- a/docs.json +++ b/docs.json @@ -415,6 +415,7 @@ "runpodctl/reference/runpodctl-serverless", "runpodctl/reference/runpodctl-template", "runpodctl/reference/runpodctl-hub", + "runpodctl/reference/runpodctl-model", "runpodctl/reference/runpodctl-network-volume", "runpodctl/reference/runpodctl-registry", "runpodctl/reference/runpodctl-gpu", diff --git a/runpodctl/overview.mdx b/runpodctl/overview.mdx index 8fa4d651..6b10eb84 100644 --- a/runpodctl/overview.mdx +++ b/runpodctl/overview.mdx @@ -182,6 +182,7 @@ Runpod CLI organizes commands into groups based on the resource type: | `runpodctl serverless` | `sls` | Manage Serverless endpoints | | `runpodctl template` | `tpl` | List, search, and manage templates | | `runpodctl hub` | | Browse and deploy from the Runpod Hub | +| `runpodctl model` | | List available models | | `runpodctl network-volume` | `nv` | Manage network volumes | | `runpodctl registry` | `reg` | Manage container registry authentications | | `runpodctl gpu` | | List available GPUs | diff --git a/runpodctl/reference/runpodctl-model.mdx b/runpodctl/reference/runpodctl-model.mdx new file mode 100644 index 00000000..d6a71625 --- /dev/null +++ b/runpodctl/reference/runpodctl-model.mdx @@ -0,0 +1,49 @@ +--- +title: "model" +sidebarTitle: "model" +--- + +List models available in your account. The model list includes version hashes you can use with the `--model-reference` flag when creating Serverless endpoints. + +```bash +runpodctl model [flags] +``` + +## Subcommands + +### List models + +List all models available in your account: + +```bash +runpodctl model list +``` + +#### Output columns + +| Column | Description | +|--------|-------------| +| ID | Unique identifier for the model. | +| Version Hash | Hash of the model version, used with `--model-reference` when creating Serverless endpoints. Shows `-` if no version hash is available. | +| Provider | The model provider. | +| Name | Name of the model. | +| Owner | Account that owns the model. | +| Status | Current status of the model. | +| Created At | When the model was created. | +| Updated At | When the model was last updated. | + +## Using model version hashes + +To create a Serverless endpoint that uses a model, reference the model by its version hash: + +```bash +runpodctl serverless create --template-id "tpl_abc123" --name "my-endpoint" \ + --model-reference "abc123def456" +``` + +Run `runpodctl model list` to find the version hash for your model. + +## Related commands + +- [`runpodctl serverless create`](/runpodctl/reference/runpodctl-serverless) +- [`runpodctl hub`](/runpodctl/reference/runpodctl-hub) From b419baedd35381e8fdae81925e3047aa78a46d85 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Wed, 3 Jun 2026 22:15:49 +0000 Subject: [PATCH 2/2] docs: Expand model command documentation with add, remove, and env var - Add model add subcommand with all flags including new --owner flag - Add model remove subcommand documentation - Document --provider and --name filter flags for model list - Add RUNPOD_GRAPHQL_URL environment variable documentation - Remove --all flag from list (removed in runpodctl PR #283) - Remove --version-status flag from add (removed in runpodctl PR #283) --- runpodctl/reference/runpodctl-model.mdx | 122 +++++++++++++++++++++--- 1 file changed, 108 insertions(+), 14 deletions(-) diff --git a/runpodctl/reference/runpodctl-model.mdx b/runpodctl/reference/runpodctl-model.mdx index d6a71625..0e34b9fc 100644 --- a/runpodctl/reference/runpodctl-model.mdx +++ b/runpodctl/reference/runpodctl-model.mdx @@ -3,7 +3,7 @@ title: "model" sidebarTitle: "model" --- -List models available in your account. The model list includes version hashes you can use with the `--model-reference` flag when creating Serverless endpoints. +Manage models in the Model Repo, including adding, uploading, listing, and removing models. ```bash runpodctl model [flags] @@ -11,30 +11,124 @@ runpodctl model [flags] ## Subcommands +### Add a model + +Register a new model with the Model Repo: + +```bash +runpodctl model add --name "my-model" +``` + +To upload model files from a local directory: + +```bash +runpodctl model add --name "my-model" --model-path ./model-files +``` + +#### Add flags + + +Model name. + + + +Model owner namespace (user or team owner ID). Use this to add models to a team account. + + + +Initial model status. + + + +Credential type (if required for model access). + + + +Credential reference (if required for model access). + + + +Directory containing model files to upload. When specified, all files in the directory are uploaded to the Model Repo. + + + +Create an upload session without uploading files. Use this to get upload URLs for manual file uploads. + + + +File name for single-file upload. + + + +File size in bytes for single-file upload. + + + +Multipart upload part size in bytes. + + + +Content type for the upload. + + + +GraphQL request timeout. Defaults to 30 minutes for model upload operations. + + ### List models -List all models available in your account: +List models in your account: ```bash runpodctl model list ``` -#### Output columns +Filter by provider or name: + +```bash +runpodctl model list --provider huggingface +runpodctl model list --name "llama" +``` + +#### List flags + + +Filter by model provider. + + + +Filter by model name. + + +### Remove a model + +Remove a model from the Model Repo: + +```bash +runpodctl model remove +``` + +You can specify the model by ID or name: + +```bash +runpodctl model remove my-model +``` + + + +Removing a model permanently deletes it and all associated versions from the Model Repo. This action cannot be undone. + + + +## Environment variables -| Column | Description | -|--------|-------------| -| ID | Unique identifier for the model. | -| Version Hash | Hash of the model version, used with `--model-reference` when creating Serverless endpoints. Shows `-` if no version hash is available. | -| Provider | The model provider. | -| Name | Name of the model. | -| Owner | Account that owns the model. | -| Status | Current status of the model. | -| Created At | When the model was created. | -| Updated At | When the model was last updated. | + +Override the GraphQL API endpoint URL. Defaults to `https://api.runpod.io/graphql`. + ## Using model version hashes -To create a Serverless endpoint that uses a model, reference the model by its version hash: +To create a Serverless endpoint that uses a model from the Model Repo, reference the model by its version hash: ```bash runpodctl serverless create --template-id "tpl_abc123" --name "my-endpoint" \