Comfy-Org / ComfyUI_frontend

ComfyUI_frontend **Official front-end implementation of ComfyUI.** [![Website][website-shield]][website-url] [![Discord][discord-shield]][discord-url] [![Matrix][matrix-shield]][matrix-url] [![][github-release-shield]][github-release-link] [![][github-release-date-shield]][github-release-link] [![][github-downloads-shield]][github-downloads-link] [![][github-downloads-latest-shield]][github-downloads-link] [github-release-shield]: https://img.shields.io/github/v/release/Comfy-Org/ComfyUI_frontend?style=flat&sort=semver [github-release-link]: https://github.com/Comfy-Org/ComfyUI_frontend/releases [github-release-date-shield]: https://img.shields.io/github/release-date/Comfy-Org/ComfyUI_frontend?style=flat [github-downloads-shield]: https://img.shields.io/github/downloads/Comfy-Org/ComfyUI_frontend/total?style=flat [github-downloads-latest-shield]: https://img.shields.io/github/downloads/Comfy-Org/ComfyUI_frontend/latest/total?style=flat&label=downloads%40latest [github-downloads-link]: https://github.com/Comfy-Org/ComfyUI_frontend/releases [matrix-shield]: https://img.shields.io/badge/Matrix-000000?style=flat&logo=matrix&logoColor=white [matrix-url]: https://app.element.io/#/room/%23comfyui_space%3Amatrix.org [website-shield]: https://img.shields.io/badge/ComfyOrg-4285F4?style=flat [website-url]: https://www.comfy.org/ [discord-shield]: https://img.shields.io/discord/1218270712402415686?style=flat&logo=discord&logoColor=white&label=Discord [discord-url]: https://www.comfy.org/discord Release Schedule The project follows a structured release process for each minor version, consisting of three distinct phases: • **Development Phase** - 2 weeks • Active development of new features • Code changes merged to the development branch • **Feature Freeze** - 2 weeks • No new features accepted • Only bug fixes are cherry-picked to the release branch • Testing and stabilization of the codebase • **Publication** • Release is published at the end of the freeze period • Version is finalized and made available to all users Nightly Releases Nightly releases are published daily at https://github.com/Comfy-Org/ComfyUI_frontend/releases. To use the latest nightly release, add the following command line argument to your ComfyUI launch script: Overlapping Release Cycles The development of successive minor versions overlaps. For example, while version 1.1 is in feature freeze, development for version 1.2 begins simultaneously. Each feature has approximately 4 weeks from merge to ComfyUI stable release (2 weeks on main, 2 weeks frozen on RC). Example Release Cycle | Week | Date Range | Version 1.1 | Version 1.2 | Version 1.3 | Patch Releases | | ---- | ------------- | -------------- | -------------- | -------------- | ----------------------------------------------- | | 1-2 | Mar 1-14 | Development | - | - | - | | 3-4 | Mar 15-28 | Feature Freeze | Development | - | 1.1.0 through 1.1.13 (daily) | | 5-6 | Mar 29-Apr 11 | Released | Feature Freeze | Development | 1.1.14+ (daily) 1.2.0 through 1.2.13 (daily) | | 7-8 | Apr 12-25 | - | Released | Feature Freeze | 1.2.14+ (daily) 1.3.0 through 1.3.13 (daily) | Release Summary Major features v1.5: Native translation (i18n) ComfyUI now includes built-in translation support, replacing the need for third-party translation extensions. Select your language in to translate the interface into English, Chinese (Simplified), Russian, Japanese, Korean, or Arabic. This native implementation offers better performance, reliability, and maintainability compared to previous solutions. More details available here: https://blog.comfy.org/p/native-localization-support-i18n v1.4: New mask editor https://github.com/Comfy-Org/ComfyUI_frontend/pull/1284 implements a new mask editor. v1.3.22: Integrated server terminal Press Ctrl + window.prompt window.confirm window.alert` Please use the following APIs as replacements. v1.3.34: Register about panel badges v1.3.22: Register bottom panel tabs v1.3.22: New settings API Legacy settings API. New settings API. v1.3.7: Register commands and keybindings Extensions can call the following API to register commands and keybindings. Do note that keybindings defined in core cannot be overwritten, and some keybindings are reserved by the browser. v1.3.1: Extension API to register custom topbar menu items Extensions can call the following API to register custom topbar menu items. v1.2.27: Extension API to add toast message i Extensions can call the following API to add toast messages. Documentation of all supported options can be found here: v1.2.4: Extension API to register custom sidebar tab Extensions now can call the following API to register a sidebar tab. The list of supported icons can be found here: We will support custom icons later. v1.10.9: Selection Toolbox API Extensions can register commands that appear in the selection toolbox when specific items are selected on the canvas. The selection toolbox will display the command button when items are selected: Contributing We welcome contributions to ComfyUI Frontend! Please see our Contributing Guide for: • Ways to contribute (code, documentation, testing, community support) • Development setup and workflow • Code style guidelines • Testing requirements • How to submit pull requests • Backporting fixes to release branches Development For detailed development setup, testing procedures, and technical information, please refer to CONTRIBUTING.md. i18n See locales/README.md for details. Storybook See .storybook/README.md for component development and visual testing documentation. Troubleshooting For comprehensive troubleshooting and technical support, please refer to our official documentation: • **General Troubleshooting Guide** - Common issues, performance optimization, and reporting bugs • **Custom Node Issues** - Debugging custom node problems and conflicts • **Desktop Installation Guide** - Desktop-specific installation and troubleshootin…