Skip to main content
Manage models in the Runpod model repository. You can add a model from a local directory or mirror one from Hugging Face, list your models, and remove ones you no longer need.

Subcommands

List models

List the models in your model repository:
You can use ls as a shorthand for list.

List flags

string
Filter by model name.
string
Filter by provider.

Add a model

Add a model by mirroring a Hugging Face repository. --name is the name the model gets in your repository, and --huggingface-model is the source:
Add a model by uploading a local directory of model files:
To wait until the uploaded model is ready to deploy, add --wait-for-hash. To also delete the local files once the upload is confirmed, add --delete-my-model-files-after-upload:
--huggingface-model can’t be combined with the local upload flags, such as --model-path.
--delete-my-model-files-after-upload deletes the files in --model-path from your machine. It requires --wait-for-hash, so files are deleted only after the model version is confirmed deployable.

Add flags

string
required
Name for the model in your repository.
string
Hugging Face model to mirror, in owner/repo format.
string
Local directory containing the model files to upload.
string
Owner namespace for the model: a user or team owner ID.
bool
Wait for a completed --model-path upload to become deployable.
duration
Maximum time to wait with --wait-for-hash (default 30m). 0 disables the timeout.
bool
Delete the uploaded --model-path files once the model version is confirmed deployable. Requires --wait-for-hash.
bool
Include upload details in the --wait-for-hash output.
string
Metadata as key=value pairs.
string
Initial model status.
string
Credential type, if the source requires one.
string
Credential reference, if the source requires one.
bool
Create an upload session.
string
File name for the upload.
string
File size in bytes.
string
Content type of the upload.
string
Part size for multipart uploads, in bytes.

Remove a model

Remove a model from your repository. Both --name and --owner are required:
You can use rm or delete as a shorthand for remove. A model that a Serverless endpoint still references can’t be removed. The command fails and lists the endpoints that use it. Detach the model from each endpoint first, then remove it:

Remove flags

string
required
Name of the model to remove.
string
required
Owner of the model.
string
UUID of a specific model version to remove.
string
Hash of a specific model version to remove.
Last modified on November 14, 2026