From b3a5d393cb760e2d2f608a59d3d339a5799b8a37 Mon Sep 17 00:00:00 2001 From: Tim Pietrusky Date: Mon, 23 Mar 2026 16:50:10 +0100 Subject: [PATCH 1/2] chore: rename 5090 template to cuda 13, add cuda version info and upgrade notices MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - rename README_5090.md to README_CUDA13.md with updated content - add CUDA 12.8 mention and upgrade migration notice (CUDA 12.4 → 12.8) to README.md - add upgrade migration notice (CUDA 12.4 → CUDA 13) to README_CUDA13.md - add AGENTS.md with runpod template IDs for reference - updated runpod templates: renamed "Blackwell Edition" to "CUDA 13", updated image to cuda13.0 --- AGENTS.md | 11 +++++ README.md | 6 ++- README_5090.md => README_CUDA13.md | 75 ++++++++++++++++-------------- 3 files changed, 56 insertions(+), 36 deletions(-) create mode 100644 AGENTS.md rename README_5090.md => README_CUDA13.md (60%) diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..ff6d6c7 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,11 @@ + +This document exists for non-obvious, error-prone shortcomings in the codebase, the model, or the tooling that an agent cannot figure out by reading the code alone. + +--- + +## Runpod Template IDs + +- **Default (CUDA 12.8):** `cw3nka7d08` — README: `README.md` +- **CUDA 13:** `2lv7ev3wfp` — README: `README_CUDA13.md` + +Templates are managed on the Runpod platform. Use `../template-utils/scripts/` to read and update them. diff --git a/README.md b/README.md index d6607a1..49e38ee 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,10 @@ [![Watch the video](https://i3.ytimg.com/vi/JovhfHhxqdM/hqdefault.jpg)](https://www.youtube.com/watch?v=JovhfHhxqdM) -Run the latest ComfyUI. All dependencies are pre-installed in the image. On first boot, ComfyUI is copied to your workspace — when you see `[ComfyUI-Manager] All startup tasks have been completed.` in the logs, it's ready to use. +Run the latest ComfyUI with CUDA 12.8. All dependencies are pre-installed in the image. On first boot, ComfyUI is copied to your workspace — when you see `[ComfyUI-Manager] All startup tasks have been completed.` in the logs, it's ready to use. + +## Upgrading from a previous version + +If you have an existing pod created with an older version of this template (CUDA 12.4), a one-time migration of the virtual environment will be performed automatically on the next boot to make it compatible with CUDA 12.8. This may take a few extra minutes on first start after the update. ## Access diff --git a/README_5090.md b/README_CUDA13.md similarity index 60% rename from README_5090.md rename to README_CUDA13.md index fea4ce4..ca262d6 100644 --- a/README_5090.md +++ b/README_CUDA13.md @@ -1,35 +1,40 @@ -[![Watch the video](https://i3.ytimg.com/vi/JovhfHhxqdM/hqdefault.jpg)](https://www.youtube.com/watch?v=JovhfHhxqdM) - -Run the latest ComfyUI optimized for NVIDIA Blackwell architecture (RTX 5090, B200). First start installs dependencies (takes a few minutes), then when you see this in the logs, ComfyUI is ready to be used: `[ComfyUI-Manager] All startup tasks have been completed.` - -## Access - -- `8188`: ComfyUI web UI -- `8080`: FileBrowser (admin / adminadmin12) -- `8888`: JupyterLab (token via `JUPYTER_PASSWORD`, root at `/workspace`) -- `22`: SSH (set `PUBLIC_KEY` or check logs for generated root password) - -## Pre-installed custom nodes - -- ComfyUI-Manager -- ComfyUI-KJNodes -- Civicomfy - -## Source Code - -This is an open source template. Source code available at: [github.com/runpod-workers/comfyui-base](https://github.com/runpod-workers/comfyui-base) - -## Custom Arguments - -Edit `/workspace/runpod-slim/comfyui_args.txt` (one arg per line): - -``` ---max-batch-size 8 ---preview-method auto -``` - -## Directory Structure - -- `/workspace/runpod-slim/ComfyUI`: ComfyUI install -- `/workspace/runpod-slim/comfyui_args.txt`: ComfyUI args -- `/workspace/runpod-slim/filebrowser.db`: FileBrowser DB +[![Watch the video](https://i3.ytimg.com/vi/JovhfHhxqdM/hqdefault.jpg)](https://www.youtube.com/watch?v=JovhfHhxqdM) + +Run the latest ComfyUI with CUDA 13. All dependencies are pre-installed in the image. On first boot, ComfyUI is copied to your workspace — when you see `[ComfyUI-Manager] All startup tasks have been completed.` in the logs, it's ready to use. + +## Upgrading from a previous version + +If you have an existing pod created with an older version of this template (CUDA 12.4), a one-time migration of the virtual environment will be performed automatically on the next boot to make it compatible with CUDA 13. This may take a few extra minutes on first start after the update. + +## Access + +- `8188`: ComfyUI web UI +- `8080`: FileBrowser (admin / adminadmin12) +- `8888`: JupyterLab (token via `JUPYTER_PASSWORD`, root at `/workspace`) +- `22`: SSH (set `PUBLIC_KEY` or check logs for generated root password) + +## Pre-installed custom nodes + +- ComfyUI-Manager +- ComfyUI-KJNodes +- Civicomfy +- ComfyUI-RunpodDirect + +## Source Code + +This is an open source template. Source code available at: [github.com/runpod-workers/comfyui-base](https://github.com/runpod-workers/comfyui-base) + +## Custom Arguments + +Edit `/workspace/runpod-slim/comfyui_args.txt` (one arg per line): + +``` +--max-batch-size 8 +--preview-method auto +``` + +## Directory Structure + +- `/workspace/runpod-slim/ComfyUI`: ComfyUI install +- `/workspace/runpod-slim/comfyui_args.txt`: ComfyUI args +- `/workspace/runpod-slim/filebrowser.db`: FileBrowser DB From c8dab6464e62d83848d303c331a4cdca4630f913 Mon Sep 17 00:00:00 2001 From: Tim Pietrusky Date: Thu, 26 Mar 2026 14:21:59 +0100 Subject: [PATCH 2/2] docs: add CUDA 12 only notice to README with link to CUDA 13 template --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 49e38ee..43bef78 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,9 @@ Run the latest ComfyUI with CUDA 12.8. All dependencies are pre-installed in the image. On first boot, ComfyUI is copied to your workspace — when you see `[ComfyUI-Manager] All startup tasks have been completed.` in the logs, it's ready to use. +> **This template is for CUDA 12 only.** It does not support CUDA 13 (Blackwell / RTX 5090). +> If you need CUDA 13, use our [ComfyUI CUDA 13 template](https://console.runpod.io/hub/template/comfyui-cuda-13?id=2lv7ev3wfp) instead. + ## Upgrading from a previous version If you have an existing pod created with an older version of this template (CUDA 12.4), a one-time migration of the virtual environment will be performed automatically on the next boot to make it compatible with CUDA 12.8. This may take a few extra minutes on first start after the update.