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. You can add a model in two ways: by uploading model files from your local machine, or by mirroring an existing Hugging Face model server-side.

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.

To mirror an existing Hugging Face model into the Runpod model repository, use --huggingface-model with the source model in owner/repo form. --name sets the destination model name in the Runpod repository, and --owner is optional when mirroring.

The transfer runs server-side, so there is no local upload session, file upload, or progress bar. Runpod creates the new model version right away and transfers the files from Hugging Face in the background.

Mirroring cannot be combined with the local-upload flags (--model-path, --create-upload, --file-name, --file-size, --part-size, --content-type, and --wait-for-hash). Uploading and mirroring are two separate ways to add a model.

runpodctl model add --name tiny-llm --huggingface-model arnir0/Tiny-LLM

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.

--huggingface-model · string

Hugging Face model to mirror into the Runpod model repository, in owner/repo form. Cannot be combined with the local-upload flags (--model-path, --create-upload, --file-name, --file-size, --part-size, --content-type, and --wait-for-hash).

--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