model

Manage models in the Runpod model repository. Use these subcommands to upload model files, list your models, and remove models or individual model versions.

Command

runpodctl model <subcommand> [flags]

Subcommands

Add a model

Add a model to the model repository. To upload model files from your local machine, point --model-path at the directory that contains them:

runpodctl model add --name "my-model" --owner "my-team" --model-path ./model

When you upload from a directory in a terminal, runpodctl shows a progress bar with upload progress and estimated time remaining, then prints the total model size once the upload finishes.

Add flags

--name · string

Model name.

--owner · string

Model owner namespace (a user or team owner ID).

--model-path · string

Directory containing the model files to upload.

--wait-for-hash · bool · default: "false"

Wait for uploaded model files to finish hashing before the command returns. Requires --model-path. When hashing completes, runpodctl prints a message confirming the model is ready to deploy along with its model URL.

--hash-timeout · duration · default: "30m0s"

Maximum time to wait when --wait-for-hash is set. Set to 0 to wait indefinitely.

--verbose, -v · bool · default: "false"

Include the full upload details in the --wait-for-hash output. Without this flag, a compact summary is printed instead.

runpodctl model add also accepts lower-level flags for configuring uploads directly, such as --content-type, --file-name, --file-size, --part-size, --metadata, and --model-status. Run runpodctl model add --help to see the complete list.

List models

List the models in your model repository:

runpodctl model list

List flags

--name · string

Filter the results by model name.

--provider · string

Filter the results by provider.

Remove a model

Remove a model from the model repository:

runpodctl model remove --name "my-model" --owner "my-team"

To remove a single model version instead of the entire model, pass either --hash or --version. This marks that version as removed and leaves the rest of the model in place.

runpodctl model remove --name "my-model" --owner "my-team" --version "<version-uuid>"

Remove flags

--name · string

Model name.

--owner · string

Model owner.

--hash · string

Hash of the model version to remove. Cannot be combined with --version.

--version · string

UUID of the model version to remove. Cannot be combined with --hash.

Related commands

• runpodctl serverless
• runpodctl config