runpod/runpod-plugins-official

runpod-companion-clis

Companion CLIs for Runpod workflows — HuggingFace, GitHub, Docker, and AWS.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-companion-clis

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Companion CLIs

For creating or improving a documented template project, start with runpod-build-template; return here for the selected CLI operation.

Four CLIs commonly needed alongside Runpod. Each has its own credentials + command reference in `reference/` — plus a one-time <cli>-setup.md for install (only opened if the CLI isn't installed). Load only the one the task needs, not all four.

If the request starts with an imported ComfyUI workflow whose model filenames lack verified URLs or hashes, route to the ComfyUI model-repair guide in runpod-templates. Return here when the exact Hugging Face repository/file is already known and the task is simply to download, cache, or bake that artifact.

CLIUse it toFull reference
hf (HuggingFace)Download models from the Hub to cache/bake into imagesreference/huggingface.md
gh (GitHub)Manage worker repos + cut releases (Hub indexes releases)reference/github.md
dockerBuild/validate/push images to Docker Hub for Runpod to pullreference/docker.md
aws (S3)Read/write network-volume storage over Runpod's S3 APIreference/aws.md

Each requires credentials before use. Read the per-tool reference for auth steps and commands; install is a separate one-time <cli>-setup.md.

These CLIs are usually one step inside a larger job. For the whole job the verified example is in runpod/golden-paths/README.md — baking vs mounting a model (25), building a minimal image (22), or moving data to a network volume (07).

These are third-party CLIs on their own release trains, so `<cli> --help` is authoritative for flags and subcommands — the references here cover the Runpod-specific usage and the traps, not the tool's full surface. Check --help before reporting that one of them cannot do something.

Windows: choose the shell, then set up WSL2 if needed

Check existing native, WSL2 or remote tools before installing another copy. The Windows hf and gh setup recipes in this skill use WSL2 and their Linux installers. If choosing that route and WSL2 is missing, run this in PowerShell as Administrator, then restart if prompted:

powershell
wsl --install

Afterward open the Ubuntu app to finish setup, then follow the Linux instructions in each reference. Keep commands, credentials and paths in the selected environment. File authoring alone does not require installing these CLIs.

HuggingFace CLI

Download models locally so they're cached for a Docker build/run. Auth and hf download recipes: [reference/huggingface.md](reference/huggingface.md) (install: reference/huggingface-setup.md).

  • Use the standalone hf CLI, not pip install huggingface_hub (that's the older huggingface-cli with different syntax).
  • Auth via hf auth login, or export HF_TOKEN=hf_... (env var wins over saved token).

GitHub CLI

Manage worker repositories and cut releases. Auth and commands: [reference/github.md](reference/github.md) (install + SSH-key setup: reference/github-setup.md).

  • The Hub indexes releases, not commits — every Hub listing update needs a new gh release create.
  • One SSH key (ssh-keygen -t ed25519) registers with both GitHub (gh ssh-key add) and HuggingFace (paste in browser).

Docker

Build, validate, and push images to Docker Hub. Credentials and commands: [reference/docker.md](reference/docker.md) (install: reference/docker-setup.md).

  • Always build `--platform=linux/amd64` — Runpod runs on x86 Linux.
  • Always use explicit semantic tags; never `latest` — latest doesn't track the newest push, so workers can silently pull the wrong image.
  • Docker Hub auth uses a personal access token, not your password. For private images, register the credential once in Console → Container Registry Settings.

AWS CLI

Access network-volume storage over Runpod's S3-compatible API (bucket name = network volume ID). Credentials, region rules, and commands: [reference/aws.md](reference/aws.md) (install: reference/aws-setup.md).

  • Runpod's S3 API, not AWS: access key = Runpod user id (user_...), secret = S3 API key (rps_...).
  • S3 API keys are Console-only. No runpodctl/REST/GraphQL creates them — if they're not already in ~/.aws/credentials/env and S3 access is needed, stop and ask the user to generate them (Settings > S3 API Keys).
  • Every command needs --region DATACENTER --endpoint-url https://s3api-DATACENTER.runpod.io/ (datacenter = the volume's DC, not an AWS region).
  • For large/many-file transfers with resume, prefer runpodctl network-volume upload/download (v3.1.0+, same S3 API keys; see the runpodctl skill). On an older runpodctl, see reference/aws.md → optional resumable volume transfers.
from this repository

More skills

All skills
runpod
Community

runpod

Start here when the Runpod lane is unclear: picks the skill for a task (runpod-mcp and the journey playbooks it routes to, such as runpod-serverless-deploy, runpod-pod-deploy, runpod-pod-doctor and runpod-cost-audit; runpodctl, runpod-flash, runpod-companion-clis, runpod-usage, runpod-templates, runpod-build-template, runpod-migrate, runpod-cloud-migrate) and indexes two dozen end-to-end worked examples (golden paths). Use it before any multi-step or provisioning task, even when the lane is clea

1h installs
3
GitHub stars
50
Updated
Nov 19
runpod
Community

runpod-build-template

Create or improve a complete Runpod template project from an application request, local code, or GitHub repository, with a documented Dockerfile and app-specific files for Pods or queue/load-balanced Serverless. Use runpod-templates for finding or operating existing official templates, runpod-mcp/runpodctl to register an already-built image as a template, runpod-flash for its code-first workflow, and runpod-companion-clis for standalone image build/push commands.

1h installs
3
GitHub stars
50
Updated
Nov 19
runpod
Community

runpod-cloud-migrate

Move a workload from another cloud or GPU platform to Runpod: Vast.ai, Lambda, CoreWeave, Paperspace, Modal, Replicate, Baseten, Together AI, Fireworks AI, fal, Hugging Face Inference Endpoints, AWS, Google Cloud or Azure. Inventories what the project uses, maps it to Runpod, plans, then migrates one workload at a time with verification. To move Runpod code between Runpod API versions, use runpod-migrate instead.

1h installs
3
GitHub stars
50
Updated
Nov 19
runpod
Community

runpod-cost-audit

'Read-only Runpod spend audit: find idle spend, explain serverless billing when nothing seems to run, break spend down by resource type and by resource, and give a whole-account snapshot. Every figure comes from the MCP billing and list reads; it recommends actions and never stops or changes anything. Use when the user asks about their bill, what is costing money, what is running on the account, or tells you to stop or delete idle resources it did not name by id: the audit with ids and the user'

1h installs
3
GitHub stars
50
Updated
Nov 19