Sign In

ComfyUI Frontend 1.46.2 / 1.47.11 / 1.49.3 (Linux / Windows)

1

Jul 27, 2026

(Updated: a day ago)

news
ComfyUI Frontend 1.46.2 / 1.47.11 / 1.49.3 (Linux / Windows)

ComfyUI Frontend Direct Combined Vue-Node Wheels

These custom frontend wheels bring the direct implementations from four ComfyUI frontend pull requests to two compatibility ranges: 1.46.2 for the important pre-subgraph-transition range before frontend 1.47 becomes required, and 1.47.11 for the documented ComfyUI v0.29.x range. A 1.49.3 build is also provided as an out-of-scope latest-line reference.

The builds replace the retired +renderapi artifacts. They implement the behavior inside the frontend and do not expose app.extensionManager.vueNodes.rendering, createPushController, or a replacement public rendering-control API.

The August 4 rebuild includes the reviewed widget-serialization, collapsed-geometry, virtualization lifecycle, slot-layout, resize, and low-detail interaction fixes. It also moves both the visible resize glyphs and their 20×20 pointer hit areas fully inside node bounds. The corrected 1.46.2 wheel continues to remove duplicate right padding around DOM widgets after the linked-slot LOD backport.

Why We Stepped Back from the API Approach

The public API approach required snapshots, subscriptions, controller coordination, contribution merging, and extra lifecycle synchronization across the frontend-extension boundary. That was unnecessary work for behavior now owned entirely by the frontend, and it added overhead to frequent viewport updates. Implementing the features directly is faster, has fewer moving parts, and avoids making extensions maintain integration code for capabilities the frontend can provide natively.

Install one wheel only. The two compatibility wheels cover consecutive ComfyUI release ranges; they are not packages to stack. The 1.49.3 artifact is a latest-line reference build outside that compatibility scope.

Which Wheel Should I Choose?

Choose the wheel for the target ComfyUI backend range:

  • Use 1.46.2+combined.1d65e2c4ef.20260804 for ComfyUI v0.26.0 through v0.28.0. This one wheel covers the pre-1.47, pre-subgraph-transition range even though those backend releases officially pin earlier 1.45.x frontend patches.

  • Use 1.47.11+combined.2f602547fb.20260804 for ComfyUI v0.29.0 through v0.29.2, where the backend requirements have moved to the 1.47 frontend line.

  • 1.49.3+combined.f982193bd1.20260804 falls outside the targeted backend range. Use it only as a latest-line reference or on an installation already using frontend 1.49.3.

The local versions sort above their matching public releases and below the next public patch under PEP 440. The range changes when a ComfyUI release requires a different frontend lineage, not for every frontend patch pin. A custom frontend wheel does not update the ComfyUI backend or make an older backend equivalent to a newer release.

The local ComfyUI v0.26.0 validation environment intentionally uses the 1.46.2 combined wheel even though the official backend requirement pins frontend 1.45.19. That is a tested local compatibility choice, not the official release pairing.

Backend Release Compatibility

ComfyUI's backend, frontend wheel, workflow templates, embedded documentation, and comfy-kitchen are released as a coordinated stack. Installing a newer frontend wheel does not update the backend or the other packages.

  • ComfyUI v0.26.0: frontend 1.45.19, workflow templates 0.10.3, embedded documentation 0.5.5, and comfy-kitchen 0.2.10. It does not support int8_tensorwise or ConvRot models.

  • ComfyUI v0.27.0: frontend 1.45.20, workflow templates 0.11.1, embedded documentation 0.5.6, and comfy-kitchen 0.2.16. It adds native INT8 and INT8 ConvRot support.

  • ComfyUI v0.28.0: frontend 1.45.21, workflow templates 0.11.9, embedded documentation 0.5.8, and comfy-kitchen 0.2.20. It adds ConvRot W4A4/INT4 support and drops PyTorch 2.4 support.

  • ComfyUI v0.29.0: frontend 1.47.10, workflow templates 0.11.19, embedded documentation 0.5.9, and comfy-kitchen 0.2.22. It includes additional INT8 and model/API functionality.

  • ComfyUI v0.29.2: frontend 1.47.11, workflow templates 0.11.20, embedded documentation 0.5.9, and comfy-kitchen 0.2.22. It supports int8_tensorwise and convrot_w4a4.

These pins define two custom-wheel ranges rather than requiring one custom wheel for every backend release. The 1.46.2 combined wheel covers v0.26.0 through v0.28.0. When ComfyUI v0.29.0 moves the frontend requirement to 1.47.10, switch to the 1.47.11 combined wheel, which covers the documented v0.29.0 through v0.29.2 range. Do not treat the local v0.26.0/frontend 1.46.2 validation setup as the official package pin; it is the tested custom-wheel selection for that range.

Why Frontend 1.46.2 Is a Separate Range

Frontend 1.46.2 is intentionally retained because it sits before the subgraph transition. It provides the combined Vue-node improvements across the ComfyUI v0.26.0 through v0.28.0 range without importing the frontend 1.47 transition. The subgraph-transition commit 0157b4702416db73131f4aee96b79a5ddfa03d2f is deliberately not an ancestor of this build.

Frontend versions do not control diffusion-model quantization. Compatibility depends on the ComfyUI backend, comfy-kitchen, checkpoint format, GPU, and PyTorch version. An error such as KeyError: 'int8_tensorwise' means the running backend does not recognize that format; changing only the frontend wheel will not fix it.

What Is Included?

Expanded-Size Preservation

Expanding a collapsed Vue node restores its previous expanded dimensions. The geometry remains stable through collapse, expansion, virtualization unmounts, and remounts instead of retaining the compact collapsed size.

Release-compatible handling also preserves dense and named widget values, including empty promoted-widget values on the 1.46.2 lineage.

Viewport Virtualization and Low-Zoom LOD

The frontend can unmount offscreen Vue-node components while preserving graph behavior and remount them when they return to view. Nodes required by active pointer interactions remain available, and remounting republishes current geometry so nodes, slots, links, and widgets remain aligned.

At low zoom, level-of-detail behavior reduces unnecessary node detail. The full-detail threshold is configurable. Virtualization and LOD are internal frontend behavior; no extension-side controller is required.

Compact and Status-Badge Display Settings

The builds include native settings for compact collapsed nodes and hiding node status badges. Compact sizing composes with expanded-size restoration and virtualization rather than replacing either behavior.

Collapsed Stacking and Drag Ownership

Collapsed nodes receive the intended paint ordering, including consistent stacking relative to links and other nodes. Pointer ownership remains with the node being dragged, preventing overlapping collapsed nodes or remounts from stealing an active drag.

Settings

The five direct settings retained on every release line are:

  • Comfy.VueNodes.CompactCollapsedNodes

  • Comfy.VueNodes.HideStatusBadges

  • Comfy.VueNodes.ViewportVirtualization

  • Comfy.VueNodes.LowZoomLOD

  • Comfy.VueNodes.FullDetailZoom

They are ordinary frontend settings. ComfyUI Eclipse is not required to own or drive the virtualization policy in these builds.

Source Provenance

The four PR branches were refreshed to these heads before integration:

  • #14258 expanded size: 97244c8b680a5865bf1ab492e369669c0776158f

  • #14259 viewport virtualization: ae9afe1218bbe8f7ee0b56b967e54484d829f17f

  • #14260 display settings: 6aa88749caeedd5fe7123abe9460e74e07726146

  • #14261 collapsed stacking: 07147ba988cac6693860400576891e9c9e054a6f

Release Compatibility Adjustments

  • 1.46.2 uses the release's native node-ID types and browser-test APIs. It backports named-widget serialization, preserves empty promoted-widget values, adapts the reviewed collapsed-layout and low-detail resize coverage to the older interfaces, and removes duplicate DOM-widget right padding introduced by the linked-slot LOD backport. A telemetry-only scenario from newer releases is omitted because this lineage has no corresponding telemetry surface.

  • 1.47.11 backports the complete named-widget schema, setting, and serialization service. Resize fixtures use a deterministic default workflow, and four snapshots record the intentional direct resize-corner result.

  • 1.49.3 uses the deterministic resize fixtures and the same intentional resize-corner snapshots without older-release production adaptations.

Verified Artifacts

The wheels and their ZIP wrappers are in temp/combined-20260804-resize-hit-area/. Each ZIP contains exactly its matching wheel; it is not a separate compiled-static archive.

Frontend 1.46.2

  • Version: 1.46.2+combined.1d65e2c4ef.20260804

  • Wheel: comfyui_frontend_package-1.46.2+combined.1d65e2c4ef.20260804-py3-none-any.whl

  • Wheel size: 26,579,850 bytes

  • Wheel SHA-256: 1c951ad2d073225f4d4fea330203c873d33fe64360ed5f4235cbfe3e1a2ed4c5

  • ZIP: comfyui_frontend_package-1.46.2+combined.1d65e2c4ef.20260804-py3-none-any.zip

  • ZIP size: 26,471,660 bytes

  • ZIP SHA-256: 19c73c9ed9f5b78a8568f12260e346b3cde32f7c7b5baef6ef2bf9585cf5f2cd

  • Static files: 639

Frontend 1.47.11

  • Version: 1.47.11+combined.2f602547fb.20260804

  • Wheel: comfyui_frontend_package-1.47.11+combined.2f602547fb.20260804-py3-none-any.whl

  • Wheel size: 20,709,595 bytes

  • Wheel SHA-256: 1d258f1ee30f61fd46aecafbf5088a1894a49cbbf07fcaef82c1df820d9f3a56

  • ZIP: comfyui_frontend_package-1.47.11+combined.2f602547fb.20260804-py3-none-any.zip

  • ZIP size: 20,588,987 bytes

  • ZIP SHA-256: e7e05fcf8609851b68cef04dbdfdb009324319317e0f4417e7fb24d242b65528

  • Static files: 709

Frontend 1.49.3 (Out-of-Scope Reference)

  • Version: 1.49.3+combined.f982193bd1.20260804

  • Wheel: comfyui_frontend_package-1.49.3+combined.f982193bd1.20260804-py3-none-any.whl

  • Wheel size: 21,786,809 bytes

  • Wheel SHA-256: 58ee969d0470a88aa718e3e5bdcd65c6cfe5aab4a82dfbe4e878d1b6d66ea3a7

  • ZIP: comfyui_frontend_package-1.49.3+combined.f982193bd1.20260804-py3-none-any.zip

  • ZIP size: 21,621,749 bytes

  • ZIP SHA-256: ba6c5ba0d83b909ba8145b9440c2bc6d64e87fbfff9f6ab1cca7752b6bf0ce84

  • Static files: 952

For every release:

  • wheel metadata reports the exact local version;

  • the local version has the intended PEP 440 ordering;

  • wheel and ZIP CRC checks pass;

  • the wheel contains no .tsbuildinfo output;

  • the embedded static payload is path-for-path and byte-for-byte identical to the validated production dist tree;

  • the ZIP contains exactly one wheel whose bytes match the standalone wheel; and

  • the recorded SHA-256 hashes match the final artifacts.

Installation

Stop ComfyUI before installing. Download the wheel for the selected lineage; the adjacent ZIP is only a wrapper containing that same wheel.

Windows Portable

Open PowerShell in the ComfyUI portable directory.

For frontend 1.46.2:

.\python_embeded\python.exe -m pip install --force-reinstall --no-deps "C:\path\to\comfyui_frontend_package-1.46.2+combined.1d65e2c4ef.20260804-py3-none-any.whl"

For frontend 1.47.11:

.\python_embeded\python.exe -m pip install --force-reinstall --no-deps "C:\path\to\comfyui_frontend_package-1.47.11+combined.2f602547fb.20260804-py3-none-any.whl"

For the out-of-scope frontend 1.49.3 reference build:

.\python_embeded\python.exe -m pip install --force-reinstall --no-deps "C:\path\to\comfyui_frontend_package-1.49.3+combined.f982193bd1.20260804-py3-none-any.whl"

Linux

Activate the Python environment used by ComfyUI, or call that environment's Python executable directly.

For frontend 1.46.2:

/path/to/comfy_env/bin/python -m pip install --force-reinstall --no-deps /path/to/comfyui_frontend_package-1.46.2+combined.1d65e2c4ef.20260804-py3-none-any.whl

For frontend 1.47.11:

/path/to/comfy_env/bin/python -m pip install --force-reinstall --no-deps /path/to/comfyui_frontend_package-1.47.11+combined.2f602547fb.20260804-py3-none-any.whl

For the out-of-scope frontend 1.49.3 reference build:

/path/to/comfy_env/bin/python -m pip install --force-reinstall --no-deps /path/to/comfyui_frontend_package-1.49.3+combined.f982193bd1.20260804-py3-none-any.whl

Verify the Installation

Windows Portable:

.\python_embeded\python.exe -m pip show comfyui-frontend-package

Linux:

/path/to/comfy_env/bin/python -m pip show comfyui-frontend-package

Confirm that Version: exactly matches the selected wheel. Restart ComfyUI, then hard-refresh the browser so it does not reuse previous frontend assets.

Superseded Rendering-Control Builds

Do not follow older instructions that reference a +renderapi wheel, app.extensionManager.vueNodes.rendering, or an Eclipse-owned controller. The old local and fork branches and their wheel/ZIP artifacts were removed after the direct combined replacements passed validation.

Rollback

Stop ComfyUI, reinstall the previous frontend wheel with --force-reinstall --no-deps, restart ComfyUI, and hard-refresh the browser. The previous glyph-only August 4 artifacts remain in temp/combined-20260804/ for rollback. For official compatibility, restore the frontend version pinned by the target ComfyUI backend release.

1