runpod-templates

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Official Runpod templates

Runpod官方模板

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.
优先使用官方模板而非自行构建镜像。Runpod为常见工作负载维护预构建镜像;部署流程仅需创建+轮询,无需SSH安装步骤。本指南是这些镜像实际内容的参考文档。它不管理基础设施——请通过runpod-mcp(已连接时)或runpodctl进行部署。

Terms — "template" vs the Hub

术语区分——“模板”与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 pod
runpodctl 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 endpoint
serverless
runpodctl 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.
有两款不同产品共享“Hub”一词,混淆二者会阻碍查找:
术语定义运行形式查找方式
Pod模板(本指南)保存的Pod配置——镜像+端口+磁盘+环境变量。官方模板显示在控制台Hub模板页面(
console.runpod.io/hub/template/<id>
)
以Pod运行
runpodctl template list --type official
/
template search
· REST
GET /v2/catalog/templates
Hub仓库/列表打包的无服务器工作节点(例如
runpod-workers/worker-comfyui
),包含处理器,部署为端点
以无服务器形式运行
runpodctl hub list
/
hub search
· MCP
list-hub-repos
/
deploy-hub-repo
同一词汇,不同目录:
hub search comfyui
仅返回无服务器工作节点,不会返回任何官方ComfyUI Pod模板;而
template search
不会返回Hub仓库。在REST v2目录中,Pod模板与无服务器模板可通过每个条目的
serverless
标志区分。

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>
.
当模板标注
isRunpod: true
时,说明该模板由Runpod维护。搜索结果中的其他模板均为社区发布:可使用,但不在本指南覆盖范围内,且版本无保障。
bash
runpodctl template list --type official   # 全部官方模板(截至2026-08-25共14个)
runpodctl template search <name>          # 按名称搜索;需确认isRunpod: true
runpodctl template get <template-id>      # 获取镜像、端口、端口配置、磁盘信息及完整自述文件
template get
会返回模板的自述文件——与镜像一同维护的描述信息,当它与本指南内容冲突时,自述文件为权威答案。请从这些命令中获取镜像标签、端口和环境变量,而非从本文件中获取:模板有独立的发布周期,更新速度快于本仓库。本参考文件记录的是模板结构及常见问题,这些内容重新探索的成本较高。
⚠️
runpodctl hub ...
并非查找Pod模板的方式
——详见术语区分。
如需向用户提供控制台链接,请使用
https://console.runpod.io/hub/template/<template-id>
。

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

REST v2无模板搜索功能——仅支持自行过滤分片

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/templates
noneonly 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.
REST v2没有针对模板的查询/搜索参数,因此所有“搜索”操作均需在客户端对获取的分片进行过滤:
端点参数返回内容
GET /v2/catalog/templates
source=official|verified|community
(默认值
official
)
公开目录分片
GET /v2/templates
无仅返回您拥有的模板
GET /v2/templates/{id}
—单个模板(自有或目录中的模板)
**
official
(14个)和
verified
(3个)模板可完整枚举;
community
模板上限为100个,且明确不支持分页。**超过该上限的社区模板不会进入API返回的分片,
runpodctl template search
读取的也是相同的服务器端分片——因此也无法查看上限之外的模板。如果用户提及一个您找不到的模板,请向他们索要模板ID,而非直接判定该模板不存在。
isRunpod
是GraphQL/v1字段,在v2中无对应字段——在v2中,“官方”是您请求的
source
分片,而非记录中的标志。
目录条目包含**
allowedCudaVersions
**字段,这是选择同一模板不同CUDA版本变体的可靠方式——将其与
runpodctl pod create --min-cuda-version
配合使用,而非通过GPU名称推断。

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.
工作负载参考文档部署演练
ComfyUI — 可通过URL访问的图像生成UI
reference/comfyui.md
黄金路径02,变体B
PyTorch — 通用GPU基础/开发环境(2.1 → 2.9,包含集群及ROCm构建版本)
reference/pytorch.md
黄金路径06
Ubuntu — 纯净20.04 / 22.04 / 24.04(CPU类别)TODO—
网络存储文件浏览器(GPU + CPU)TODO黄金路径07
添加模板时,需在此处添加一个文件并在上方表格中添加一行。请勿为每个模板创建新指南——任务流程完全相同,且每个注册的指南都会占用会话上下文。

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).
  6. Readiness — how long first boot takes and the exact signal for "actually serving".
    Running
    is never the signal.
  7. What does not ship — the gap between "booted" and "usable", and how to close it programmatically rather than by clicking.
  8. Sizing — container disk and minimum VRAM.
  9. Version pinning — how to hold a known-good version.
reference/
目录下的每个文件都按相同顺序回答相同问题,因此Agent可快速定位所需内容:
  1. 标识信息 — 模板名称、ID、镜像、上游源仓库。
  2. 变体版本 — CUDA/架构/GPU代际的分支及选择建议。
  3. 端口与凭据 — 暴露的内容及默认登录信息。
  4. 自动启动 — 启动时已运行的服务及确切命令。
  5. 路径信息 — 应用、配置及数据的存储位置(以及挂载网络卷后的变化)。
  6. 就绪状态 — 首次启动所需时间及“实际已就绪”的确切信号。
    Running
    状态绝非就绪信号。
  7. 未包含内容 — “已启动”与“可使用”之间的差距,以及通过编程方式而非点击操作填补差距的方法。
  8. 规格要求 — 容器磁盘空间及最小显存。
  9. 版本固定 — 如何锁定已知可用的版本。

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
runpod-comfyui-models
skill — it carries the repair 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)
runpod-usage/reference/building-images.md
— build
FROM
the official base
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.
询问模板相关问题的用户很少只需要参考文档本身;他们通常想要部署、修复或替换模板。先定位到此处,确定用户需求,再跳转至对应内容:
用户需求跳转至
端到端部署模板上方表格中对应的黄金路径(索引)——经过实际验证的运行流程及真实命令
修复无法提供服务的Pod(显示“Running”但URL无法访问、出现404/502错误)模板参考文档的“就绪状态”章节——随后跳转至
runpod-usage/reference/gotchas.md
修复无法下载模型的ComfyUI工作流(模型元数据缺失/损坏、导入的工作流或PNG文件有问题)**
runpod-comfyui-models
**指南——包含修复脚本。官方ComfyUI模板预装了ComfyUI-RunpodDirect,因此其自动下载路径适用
向运行中的模板Pod添加模型/文件模板参考文档的“未包含内容”章节,或使用
companion-clis
进行通用Hugging Face传输
自定义模板未包含的内容(固定版本、额外节点、轻量化镜像)
runpod-usage/reference/building-images.md
——基于官方基础镜像构建
无服务器工作节点而非Pod不属于Pod模板范畴——通过
runpodctl
/
runpod-mcp
部署Hub工作节点
此处的参考文档回答的是镜像中包含什么;绝不会重复演练流程或修复步骤——只会指向对应的负责文档。