runpodctl is the CLI tool to automate / manage GPU pods for runpod.io.
Note: All pods automatically come with runpodctl installed with a pod-scoped API key.
# Download and install via wget
wget -qO- cli.runpod.net | sudo bash# Using homebrew
brew install runpod/runpodctl/runpodctlwget https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-windows-amd64.exe -O runpodctl.exePlease checkout this video tutorial for a detailed walkthrough of runpodctl.
Video Chapters:
- Installing the latest version of runpodctl
- Uploading large datasets
- File transfers from PC to RunPod
- Downloading folders from RunPod
- Adding runpodctl to your environment path
- Downloading model files
Note: The send and receive commands do not require API keys due to the built-in security of one-time codes.
Run the following on the computer that has the file you want to send
runpodctl send data.txtExample output:
Sending 'data.txt' (5 B)
Code is: 8338-galileo-collect-fidel
On the other computer run
runpodctl receive 8338-galileo-collect-fidelrunpodctl receive 8338-galileo-collect-fidelExample output:
Receiving 'data.txt' (5 B)
Receiving (<-149.36.0.243:8692)
data.txt 100% |████████████████████| ( 5/ 5B, 0.040 kB/s)You can use the following links for google colab
Before using pod commands, configure the API key obtained from your RunPod account.
# configure API key
runpodctl config --apiKey={key}
# Get all pods
runpodctl get pod
# Get a pod
runpodctl get pod {podId}
# Start an ondemand pod.
runpodctl start pod {podId}
# Start a spot pod with bid.
# The bid price you set is the price you will pay if not outbid:
runpodctl start pod {podId} --bid=0.3
# Stop a pod
runpodctl stop pod {podId}For a comprehensive list of commands, visit RunPod CLI documentation.
Model repository commands let you upload, list, and remove AI models that can later be deployed with pods.
# Upload a model directory to your account's repository
runpodctl create model \
--provider huggingface \
--name lodestones/Chroma \
--credential-reference secret://runpod/model-storage \
--version 1.0.0 \
--model-path ./chroma-model
# List models in your repository
runpodctl get models
# Remove a model by owner and name
runpodctl remove model \
--owner your-org \
--name lodestones/ChromaSupplying --model-path archives the directory into a .tar.gz file, starts a multipart upload, transfers the artifact using the pre-signed URLs, and finalizes the upload automatically.
You can still pass --create-upload on its own to inspect the multipart session details without uploading any files.