mcpField
R
runpod-templates

runpod-templates

github.com/runpodクラウド・DevOps4710.4k 回インストール2 日前に更新
リポジトリ

runpod-templates について

ComfyUI や PyTorch などの事前構築ワークロードを選ぶ、または調査する人向けの Runpod 公式 Pod テンプレート参照スキルです。Pod テンプレートとサーバーレス Hub の一覧を区別し、イメージ内容、設定、起動確認、デプロイ先を説明します。

主な機能

  1. 01Pod テンプレートと Hub ワーカーを区別
  2. 02公式テンプレートの検索方法を提示
  3. 03ポート、パス、起動動作を記録
  4. 04起動確認とイメージの不足点を説明
  5. 05デプロイや修復作業の引き継ぎ

活用シーン

  1. 01ワークロード用の公式 Pod テンプレート確認
  2. 02GPU に合うテンプレートバリアントの選択
  3. 03起動中なのに応答しない Pod の調査
  4. 04テンプレートのデプロイをインフラツールへ引き継ぎ

MCP 対応

このスキル自体はインフラをデプロイ、管理しません。MCP 接続時は runpod-mcp、それ以外は runpodctl にデプロイを引き継ぎ、Hub 一覧の検索やデプロイに使う MCP ツールにも触れています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/runpod/runpod-plugins-official --skill runpod-templates

インストール後、Claude Code で/runpod-templatesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
always-output-workflow.eval.md
ambiguous-filename.eval.md
api-inventory-only.eval.md
gated-model.eval.md
mixed-resolved-ambiguous-output.eval.md
nontechnical-handoff.eval.md
png-output-extraction.eval.md
repair-and-handoff.eval.md
runpoddirect-required-handoff.eval.md
support-intake.eval.md
template-recommendation.eval.md
unsafe-download-url.eval.md
reference/
comfyui-model-repair.md
comfyui.md
pytorch.md
reference/comfyui-repair/
metadata.md
resolution.md
runpoddirect.md
scripts/
apply_model_metadata.py
extract_png_workflow.py
inventory_workflow_models.py
tests/
test_extracted_helpers.py
test_model_metadata_scripts.py
test_png_workflow_extractor.py

詳細

公式 Runpod テンプレート

明示的なソースのパッケージ化やテンプレートの最適化には、 runpod-build-template を使用してください。通常のワークロードの デプロイでは、イメージをビルドするよりも公式テンプレートを優先してください。 Runpod は一般的なワークロード向けの ビルド済みイメージを管理しています。デプロイは作成とポーリングだけで完了し、SSH でのインストール手順は 不要です。このスキルでは、それらのイメージの実態を説明します。インフラストラクチャは管理しません。デプロイには、 runpod-mcp（接続されている場合）または runpodctl を使用してください。

用語 — 「テンプレート」と Hub

「Hub」という言葉を共有する製品は 2 つあります。この 2 つを混同すると、検索がうまくいかなくなります。

用語内容実行形態検索方法
Pod テンプレート（このスキル）保存済みの Pod 設定 — イメージ + ポート + ディスク + 環境変数。公式のものは Console の 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 テンプレートは 1 つも返されません。また、template search で Hub リポジトリが返されることもありません。REST v2 カタログでは、Pod とサーバーレスのテンプレートは各 エントリーの serverless フラグで区別できます。

「公式」の意味と検索方法

isRunpod: true を返すテンプレートは Runpod が管理しています。検索結果に表示されるそれ以外のものはコミュニティが公開したもので、 使用できますが、このスキルの対象外であり、バージョンも保証されません。

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 はテンプレートのreadmeを返します。これはイメージとともに管理される説明であり、このスキルと 食い違う場合の正式な情報源です。イメージのタグ、ポート、環境変数は、これらのファイルではなく、次のコマンドから取得してください。テンプレートは独自のリリースサイクルで提供され、このリポジトリよりも速く更新されます。このリファレンスファイルには、構成の概要と注意点が記載されています。再調査に手間がかかるのは、ここにある情報です。

⚠️ runpodctl hub ... は Pod テンプレートの検索方法ではありません — 用語を参照してください。

Console のリンクをユーザーに案内するには、https://console.runpod.io/hub/template/<template-id> を使用してください。

REST v2 にテンプレート検索機能はありません — 自分で絞り込むスライスのみです

REST v2 にはテンプレートのクエリ／検索パラメーターがないため、すべての「検索」は取得したスライスに対するクライアント側の フィルター処理です。

エンドポイントパラメーター返される内容
GET /v2/catalog/templatessource=official|verified|community（デフォルトは official）公開カタログのスライス
GET /v2/templatesなし自分が所有するテンプレートのみ
GET /v2/templates/{id}—所有またはカタログ内のテンプレート 1 件

official（14 件）と verified（3 件）はすべて列挙できますが、community は 100 件が上限で、 ページネーションは明示的にサポートされていません。 上限を超えるコミュニティテンプレートは API が返せるスライスに 含まれず、runpodctl template search も同じサーバー側のスライスを参照するため、上限を超えるテンプレートは検索できません。ユーザーが名前を挙げたテンプレートが 見つからない場合、存在しないと判断するのではなく、テンプレート ID を尋ねてください。

isRunpod は GraphQL/v1 のフィールドで、v2 に相当するものはありません。v2 では「公式」は レコードのフラグではなく、リクエストした source スライスを指します。

カタログエントリーには allowedCudaVersions が含まれています。同じテンプレートの CUDA 系統別バリエーションから選ぶ際は、これが信頼できる情報源です。GPU 名から推測するのではなく、runpodctl pod create --min-cuda-version と組み合わせてください。

テンプレート

ワークロードリファレンスデプロイ手順
ComfyUI — URL で利用できる画像生成 UIreference/comfyui.mdgolden path 02、variant B
PyTorch — 汎用 GPU ベース／開発環境（2.1 → 2.9、クラスターと ROCm ビルドを含む）reference/pytorch.mdgolden path 06
Ubuntu — ベアの 20.04／22.04／24.04（CPU カテゴリー）TODO—
ネットワークストレージのファイルブラウザー（GPU + CPU）TODOgolden path 07

テンプレートを追加するには、ここにファイルを 1 つ追加し、上の表に行を 1 つ追加します。テンプレートごとに新しいスキルを作成しないでください。タスクの形式は同じで、登録されたスキルはすべてのセッションでコンテキストを消費します。

テンプレートリファレンスの使い方

reference/ 以下の各ファイルは、同じ質問に同じ順序で答えるため、エージェントは必要な項目をすぐに確認できます。

  1. 識別情報 — テンプレート名、ID、イメージ、上流のソースリポジトリ。
  2. バリアント — CUDA／アーキテクチャ／GPU 世代による違いと、選択するバリアント。
  3. ポートと認証情報 — 公開されるものと、デフォルトのログイン情報。
  4. 自動起動 — 起動時にすでに実行されているものと、正確なコマンド。
  5. パス — アプリ、その設定、データの場所（およびネットワークボリュームのマウントによる変更点）。
  6. 準備状態 — 初回起動にかかる時間と、「実際にサービスを提供している」ことを示す正確なシグナル。Running は決してそのシグナルではありません。
  7. 含まれないもの — 「起動済み」と「利用可能」の違い、およびクリック操作ではなくプログラムでその差を埋める方法。
  8. サイズ設定 — コンテナディスクと最小 VRAM。
  9. バージョンの固定 — 動作確認済みのバージョンを固定する方法。

例外が 1 つあります。reference/comfyui-model-repair.md は 使用ガイド です。これは scripts/ のスクリプトを実行する ComfyUI ワークフローの修復手順であり、9 つの質問に答えるテンプレートリファレンスではありません。

次の案内 — このスキルはハブであり、目的地ではありません

テンプレートについて質問するユーザーが求めているのは、たいていリファレンスファイルそのものではなく、テンプレートのデプロイ、修正、置き換えです。ここに案内し、どれに当たるかを特定して、次の手順へ引き継ぎます。

ユーザーの要望案内先
テンプレートを最初から最後まで デプロイ する上の表にある該当する golden path（インデックス）— 実際のコマンドを使ってライブ検証済みの手順
サービスを提供しない Pod を 修正 する（「Running」だが URL が応答しない、404／502）テンプレートのリファレンスファイルの §Readiness — 次に runpod-usage/reference/gotchas.md
モデルをダウンロードできない ComfyUI ワークフローを 修正 する（モデルメタデータの欠落／破損、インポートしたワークフローまたは PNG）修復ガイド — scripts/ の修復スクリプトを実行します。公式 ComfyUI テンプレートには ComfyUI-RunpodDirect が含まれているため、自動ダウンロードの経路が適用されます
実行中のテンプレート Pod にモデル／ファイルを 追加 するテンプレートのリファレンスファイル（§What does not ship）、または汎用的な Hugging Face 転送には companion-clis
テンプレートに含まれる範囲を超えて カスタマイズ する（バージョンの固定、追加ノード、軽量なイメージ）、または テンプレートプロジェクト／Hub の掲載情報を作成 するrunpod-build-template — 適合する場合は公式ベースを使用してプロジェクトを作成します
Pod ではなく サーバーレスワーカーPod テンプレートではありません — runpodctl／runpod-mcp を使った Hub ワーカー

ここにあるリファレンスファイルは イメージに何が含まれているか を説明します。手順や修復方法を重複して記載することはなく、それらの担当先を案内します。

コメント

Markdown 対応