runpod/runpod-plugins-official

runpod-templates

Find, use, and troubleshoot official Runpod Pod templates, including ComfyUI workflow model metadata repair.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-templates

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Official Runpod templates

For explicit source packaging or template optimization, use runpod-build-template. For ordinary workload deployment, prefer an official template over building an image. Runpod maintains prebuilt images for common workloads; deploying one is a create + poll, with no SSH install step. This skill is the reference for what those images actually are. It does not manage infrastructure — deploy with runpod-mcp (if connected) or runpodctl.

Terms — "template" vs the Hub

Two different products share the word "Hub", and conflating them derails discovery:

TermWhat it isRuns asDiscover with
Pod template (this skill)A saved pod config — image + ports + disk + env. The official ones appear on Console Hub template pages (console.runpod.io/hub/template/<id>)a podrunpodctl template list --type official / template search · REST GET /v2/catalog/templates
Hub repo / listingA packaged serverless worker (e.g. runpod-workers/worker-comfyui) with a handler, deployed as an endpointserverlessrunpodctl hub list / hub search · MCP list-hub-repos / deploy-hub-repo

Same word, disjoint catalogs: hub search comfyui returns only the serverless worker and none of the official ComfyUI pod templates, and template search returns no Hub repos. In the REST v2 catalog, pod vs serverless templates are told apart by each entry's serverless flag.

What "official" means, and how to find them

A template is Runpod-maintained when it reports isRunpod: true. Anything else in search results is community-published: usable, but not covered by this skill and not version-guaranteed.

bash
runpodctl template list --type official   # the whole official set (14 as of 2026-08-25)
runpodctl template search <name>          # by name; check isRunpod: true
runpodctl template get <template-id>      # image, ports, portsConfig, disk + full readme

template get returns the template's readme — the description maintained alongside the image, and the authoritative answer when it disagrees with this skill. Take image tags, ports, and env from these commands, not from these files: the templates ship on their own release train and move faster than this repo. The reference files record the shape and the gotchas, which is the expensive part to rediscover.

⚠️ `runpodctl hub ...` is not how you find pod templates — see Terms.

To hand a user a Console link, use https://console.runpod.io/hub/template/<template-id>.

REST v2 has no template search — only slices you filter yourself

REST v2 has no query/search parameter for templates, so every "search" is a client-side filter over a fetched slice:

EndpointParamsReturns
GET /v2/catalog/templates`source=official\verified\community (default official`)the public catalog slice
GET /v2/templatesnoneonly templates you own
GET /v2/templates/{id}—one template, owned or catalog

`official` (14) and `verified` (3) are fully enumerable; `community` is capped at 100 with pagination explicitly unsupported. A community template past that cap never enters a slice the API can return, and runpodctl template search reads those same server-side slices — so it has no view past the cap either. If a user names one you cannot find, ask them for the template id rather than concluding it does not exist.

isRunpod is a GraphQL/v1 field with no v2 equivalent — in v2, "official" is the source slice you requested, not a flag on the record.

Catalog entries carry `allowedCudaVersions`, which is the reliable way to pick between CUDA-line variants of the same template — pair it with runpodctl pod create --min-cuda-version instead of inferring from the GPU name.

The templates

WorkloadReferenceDeploy walkthrough
ComfyUI — image generation UI at a URL`reference/comfyui.md`golden path 02, variant B
PyTorch — general GPU base / dev box (2.1 → 2.9, incl. cluster + ROCm builds)`reference/pytorch.md`golden path 06
Ubuntu — bare 20.04 / 22.04 / 24.04 (CPU category)TODO—
Network storage file browser (GPU + CPU)TODOgolden path 07

Add a template by adding one file here and one row above. Do not create a new skill per template — the task shape is identical and every registered skill costs context in every session.

How to use a template reference

Each file under reference/ answers the same questions in the same order, so an agent can skim to the one it needs:

  1. Identity — template name, id, image, upstream source repo.
  2. Variants — CUDA/arch/GPU-generation splits and which to pick.
  3. Ports and credentials — what is exposed and any default login.
  4. Autostart — what is already running on boot, with the exact command.
  5. Paths — where the app, its config, and its data live (and what a network

volume mount changes).

  1. Readiness — how long first boot takes and the exact signal for "actually

serving". Running is never the signal.

  1. What does not ship — the gap between "booted" and "usable", and how to close

it programmatically rather than by clicking.

  1. Sizing — container disk and minimum VRAM.
  2. Version pinning — how to hold a known-good version.

One file is the exception: `reference/comfyui-model-repair.md` is a usage guide — a ComfyUI workflow repair procedure that drives the scripts in `scripts/` — not a 9-question template reference.

Routing onward — this skill is the hub, not the destination

A user asking about a template rarely wants the reference file itself; they want a template deployed, fixed, or replaced. Land here, identify which, and hand off:

The user wants to…Send them to
Deploy a template end to endthe matching golden path in the table above (index) — live-verified runs with real commands
Fix a pod that won't serve ("Running" but URL dead, 404/502)the template's reference file, §Readiness — then `runpod-usage/reference/gotchas.md`
Fix a ComfyUI workflow whose models won't download (missing/broken model metadata, imported workflow or PNG)the repair guide — it drives the repair scripts in `scripts/`. The official ComfyUI templates ship ComfyUI-RunpodDirect, so its automatic-download path applies
Add models / files to a running template podthe template's reference file (§What does not ship), or companion-clis for generic Hugging Face transfers
Customize beyond what the template ships (pinned versions, extra nodes, lighter image) or author a template project / Hub listing`runpod-build-template` — author the project, using the official base when it fits
A serverless worker, not a podnot a pod template — Hub workers via runpodctl / runpod-mcp

Reference files here answer what is in the image; they never duplicate a walkthrough or a repair procedure — they point at the owner.

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
runpod
社区

companion-clis

Companion CLIs for Runpod workflows — HuggingFace, GitHub, Docker, and AWS. Use runpod-build-template for complete template project authoring, and the ComfyUI model-repair guide in runpod-templates for imported workflows lacking model download metadata.

安装量
5
GitHub Stars
46
最近更新
10月23日
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'

安装量
5
GitHub Stars
46
最近更新
10月23日
runpod
社区

discovery

'Answer what is available, what fits and the price against Runpod''s catalogs: GPU and CPU types with price, live stock per data center and per product, the CUDA versions that have capacity, the Hub worker marketplace, the public template catalog, and the pay-per-use Public Endpoints. Read-only: it filters to the user''s real constraint, sizes a model''s VRAM need against real stock, quotes price and stock from the reads, and says "none found" rather than inventing an entry. Use when the user as

安装量
5
GitHub Stars
46
最近更新
10月23日
runpod
社区

endpoint-ops

'Operate a Serverless endpoint that already exists: diagnose queued jobs and dying workers, tune scaling, idle timeout and FlashBoot safely, pin the GPU selection, and manage the queue (cancel a job, purge). Read-only by default; changes only the exact setting the user authorized, with a read before and after. Use when the user has an endpoint and asks why it is slow, stuck or failing, or wants one of its settings changed through the Runpod MCP tools.'

安装量
5
GitHub Stars
46
最近更新
10月23日