ComfyUI-Aaalice-Nodes Introduction
ComfyUI-Aaalice-Nodes is a collection of ComfyUI nodes and workspace tools designed to make common creative tasks easier to manage. It brings together controls for organizing workflows, choosing reusable prompt phrases, setting image dimensions, loading and saving images with generation information, browsing image-tag galleries, and connecting ComfyUI with Krita.
The extension is intended to help you spend less time navigating a crowded workflow or repeating small setup tasks. For example, you can switch groups on or off from a compact control panel, keep frequently used prompt phrases in a reusable library, or pass generation details from a source image to a saved result.
The project is currently a preview release. Before the first stable release, node behavior and workflow formats may change. Older workflows are not automatically migrated. The author notes that some older prompt-library exports are supported for import.
This extension supports ComfyUI’s classic canvas and Nodes 2.0, but not App Mode. Its interface includes English, Simplified Chinese, and Traditional Chinese; other interface languages fall back to English.
Important compatibility warning: Do not install this extension alongside ComfyUI-Danbooru-Gallery. They register several of the same node IDs, which can cause duplicate controls and unpredictable behavior. Use only one of the two.
The author also advises against installing
AIGODLIKE-COMFYUI-TRANSLATION. It can replace custom subgraph parameter names and make sidebar controls confusing. If it has been used, remove it, restart ComfyUI, and reopen a clean workflow; names saved while the translation extension was active may not restore automatically.
How ComfyUI-Aaalice-Nodes Works
ComfyUI workflows are made from nodes connected together. A node may create or change data, such as an image or prompt, or it may help you control how parts of the workflow behave. This extension adds both kinds of tools.
Some nodes operate directly on workflow data. For instance, ResolutionPreset provides width and height values for other nodes, while LoadImageWithMetadata outputs an image, mask, and any supported generation information found in the image file.
Other tools work alongside the workflow rather than processing image data. QuickGroupManager, for example, gives you a compact way to control visible groups on the canvas. The Aaalice workspace adds sidebar views for workflow parameters, group navigation, and prompt-library management.
A useful way to think about the sidebar is as a set of shortcuts to controls that already exist in your workflow. You choose which compatible parameters to display, then adjust them without searching across the full canvas. Presets can save those settings with the workflow, making it easier to switch between prepared setups.
Some nodes can also check workflow state and use that result to control conditional execution. A group probe can report whether a group is disabled; a logic probe can combine several such checks using AND or OR. When connected to a compatible lazy conditional branch, this can prevent the unselected branch from running.
ComfyUI-Aaalice-Nodes Features
Workflow and group controls
QuickGroupManagermanages visible canvas groups. You can filter which groups it controls by color, turn groups on or off, arrange the list, and set rules that change other groups when a group is toggled. Its mute or bypass setting determines how disabled groups behave. These controls apply to visible groups in the current graph, not groups inside subgraphs.GroupIsEnabledchecks the state of one visible group when a workflow is queued. It reports the group as disabled only when every member is muted or bypassed. Keep the probe outside the group it checks.GroupLogicProbecombines conditions for multiple groups into one Boolean result using AND or OR. You can connect its result to a compatible lazy conditional branch. References to renamed or deleted groups are reported rather than guessed.- Aaalice workspace group navigation provides a curated list of groups and optional keyboard-accessible navigation. You can set a target position and zoom for each listed group. Navigation settings are saved with the workflow.
- Open on Focus lets you mark a node as the focus target when a workflow is opened. You can adjust the view offset and zoom. Marking another node replaces the existing target.
Sidebar controls and presets
In the Aaalice workspace, the Parameter Control view lets you add compatible node parameters to a sidebar. You can search parameters across pages, edit them in place, and organize them into pages and layouts. You can also add Markdown notes, adjust the slider range shown in the sidebar, and bind one sidebar control to multiple compatible parameters.
Sidebar presets save and switch between supported parameter values and dashboard layouts as part of the workflow. Common model parameters can be matched by filename when the receiving computer has a different folder structure. Missing or ambiguous model matches are reported rather than silently replaced.
The separate parameter application profiles feature stores local parameter override rules in your browser, rather than in the workflow. You can export and import these profiles, compare rules, and apply them to a copy of a sidebar preset. Unavailable or ambiguous parameters are skipped and reported; the feature does not guess based on a control’s screen position.
Sidebar compatibility includes simple nodes made from standard number, Boolean, text, and dropdown controls; widgets exposed by subgraphs; and several ComfyUI preview nodes. Nodes with custom panels may need an explicit adapter. Sidebar controls do not search inside subgraphs.
Resolution and text tools
-
ResolutionPresetprovides eleven built-in, model-independent image sizes, including portrait and landscape options such as1080×1920and1920×1080. You can also enter dimensions directly, save personal presets, or adjust dimensions with handles on the canvas. Choose an alignment of 8, 16, 32, or 64 pixels. If a built-in size does not match the selected alignment, the node uses that size’s 8-pixel alignment so its output remains exact. It outputs width and height values; it does not resize images, recommend models, or calculate dimensions from megapixels. -
SimpleStringSplitsplits text at commas or vertical bars (|), trims extra spaces, and removes empty sections. This is useful for turning a simple text list into separate items. -
PromptSelectorhelps you build prompts from reusable entries in the prompt library. Search or browse nested categories and favorites, choose multiple entries, and arrange them in the order you want them to appear. You can change a selected entry’s weight from 0 to 20 with the mouse wheel or arrow keys while hovering over it. An optional prefix is placed first, and you can change the separator from the default,in the node menu.The selector stores references to library entries, not copies of their text. Editing an entry updates nodes that use it. If an entry is deleted, the selector shows a missing reference and requires you to resolve it before running.
Image loading, saving, and notifications
-
LoadImageWithMetadataworks like ComfyUI’s regular image loader, with additional outputs for a mask and metadata. It reads supported generation information from PNGparameterstext or JPEG/WebP EXIFUserComment. It does not treat other fields such aspromptorworkflowas generation parameters. A valid image without supported parameters returns explicit empty metadata. -
ConditionalSaveImagesaves an image only when its Enable switch is on. When off, it passes the image through without writing a file. This is useful because ComfyUI output nodes run when execution reaches them; placing a switch elsewhere in front of a normal save node does not necessarily prevent saving.The node can use ComfyUI-Lora-Manager’s save implementation when that extension is installed. This supports options such as filename variables, PNG/JPEG/WebP formats, metadata, embedded workflows, and recipes. Without Lora-Manager, it falls back to core PNG saving; features beyond that fallback report an error.
A metadata input can be connected to metadata from
LoadImageWithMetadataorFetchFromKrita, or to Lora-Manager’sMetadata Overwrite. Source metadata can replace the generated parameter text, including explicitly empty metadata. It does not replace the current execution values used in filename variables or copy the source workflow. Full source-metadata transfer cannot be combined with recipe saving. -
SimpleNotifysends an optional desktop notification and/or sound when execution reaches it, then passes its input value through unchanged. You can enable the two alert types independently and adjust sound volume. The notification means execution reached this node; it does not mean parallel branches or the full queue have finished. Use the node menu’s Enable and Test Notification option to request browser permission and test the enabled alerts.
Booru image gallery
BooruGalleryNode provides a searchable, ordered gallery for Danbooru, Gelbooru, Safebooru, and AI TAG. You can search, filter, select posts, reorder them, and output images alongside matching prompts in the same order. You can also edit local tags for a selected post without changing the remote site. If an image download fails, the node reports an error rather than inserting a placeholder.
The gallery supports booru-style tag searches and pasted prompt text. Danbooru includes daily and rolling weekly or monthly popular-post channels; AI TAG includes a monthly channel. Random mode draws from the current source, query, channel, and rating range while avoiding repeats during the current node session. Results still follow your local content blacklist.
Gallery settings, credentials, timeouts, and image-cache limits are available under ComfyUI Settings → Aaalice Nodes → Booru Gallery. Credentials and cache data are stored in your local ComfyUI user directory, not in workflow JSON. Gelbooru requires an official User ID and API Key; the complete credential fragment from its account page can be pasted into the API Key field.
The gallery also provides image previews and post details, including image dimensions, rating, favorite count, and tags. You can download the original image from a card or detail view, and open it in a new browser tab from the detail view. Danbooru supports reading and writing favorites; Gelbooru supports reading favorites only.
Two local tag controls serve different purposes:
- Content blacklist hides matching posts from gallery results. It filters responses locally and is not sent to the site as an exclusion query.
- Output filter tags do not hide posts. They remove matching tags from the node output and copied prompt, which can be useful for excluding tags such as watermarks or artist names.
These controls accept comma-separated tags and are available from the prompt-processing overlay and tag menus. If ComfyUI-Autocomplete-Aaalice is installed, supported tag fields gain autocomplete, and gallery previews and post details show tag translations.
Krita connection
FetchFromKrita reads the active Krita document when the workflow runs. It outputs the visible composite image, the current selection as a same-sized mask, and supported generation metadata from the document’s original PNG, JPEG, or WebP file. With no selection, the mask is all black. If the document is unsaved, is a .kra file, or its original image has no generation parameters, the metadata is explicitly empty.
Krita, ComfyUI, and the included Aaalice Comfy Bridge must run on the same computer. The bridge communicates with Krita and waits for the document’s current composite to be ready; the node does not substitute an old preview if the connection or export fails. First-time bridge setup and connection testing are available in ComfyUI Settings → Aaalice Nodes → Krita.
Prompt library
The Aaalice workspace’s Library view manages reusable prompt entries, nested categories, favorites, tags, and one preview image per entry. You can search and organize categories, copy an entry’s full prompt, and export the whole library or the current filtered results.
Library data is stored in the current ComfyUI user directory and does not travel with workflows. Export it separately if you are moving to another installation. The library can upgrade supported older flat databases and export formats.
ComfyUI-Aaalice-Nodes Models
This extension does not provide or select AI image-generation models. ResolutionPreset offers model-independent size presets only; it does not recommend a checkpoint or calculate a model-specific resolution. The Booru gallery uses remote image sources, not generation models.
ComfyUI-Aaalice-Nodes Updates
The available context describes these changes to earlier components:
- Version 0.7.0:
PromptAssistantBridgewas removed. Workflows that contain it need to have the node replaced or removed. - Version 0.8.0:
PromptCleaningMaidwas removed. Workflows that contain it need to have the node replaced or removed. - Preview release: Workflow formats and node behavior may still change before the first stable release. Older workflows do not automatically migrate.
The context does not provide a complete version-by-version changelog, so no additional release details are listed here.
Troubleshooting ComfyUI-Aaalice-Nodes
A node or sidebar control is missing
- Confirm that you are using a recent ComfyUI version that supports V3 custom nodes.
- Restart ComfyUI after updating the extension.
- Refresh the browser. After a frontend update, use a hard refresh to clear cached interface files.
- If a node still has old inputs or controls after a structural update, delete that node instance and create it again.
- Check the ComfyUI console for startup or import errors.
The interface shows duplicate controls or behaves unexpectedly
Check whether both ComfyUI-Aaalice-Nodes and ComfyUI-Danbooru-Gallery are installed. They register overlapping node IDs. Keep only one installed, restart ComfyUI, and reload the workflow.
Sidebar parameter names are confusing
The author warns that AIGODLIKE-COMFYUI-TRANSLATION can overwrite custom subgraph parameter names. Remove that extension, restart ComfyUI, and reopen a clean workflow. Names saved while it was active may need to be restored manually.
A group probe fails
Make sure the referenced group still exists and has not been renamed, and that it is not empty. Place GroupIsEnabled outside the group it monitors. For GroupLogicProbe, inspect any highlighted rows for references to renamed or deleted groups.
An image does not save
Check that the ConditionalSaveImage Enable switch is on and that execution reaches the node. If you are using advanced save options, confirm that ComfyUI-Lora-Manager is installed; without it, the fallback supports core PNG saving only. Also note that saving a recipe cannot be combined with full or explicitly empty source-metadata transfer.
An image or its metadata cannot be loaded
Confirm that the file exists, is a supported image, and can be decoded. LoadImageWithMetadata reads only PNG parameters text and JPEG/WebP EXIF UserComment. Other image comments are not treated as generation parameters. Invalid files or undecodable metadata produce a clear error rather than guessed values.
The gallery cannot connect or download images
- Check that the selected image source is available and that your query and filters return results.
- For Gelbooru, check the official User ID and API Key in the Booru Gallery settings.
- If you see an SSL certificate error, check your system clock, HTTPS proxy or inspection software, and trusted system root certificates. The extension does not disable certificate verification.
- Use the gallery’s network error banner to view or copy the diagnostic details, then retry.
Booru gallery availability, credentials, and favorite behavior depend on third-party services and their media hosts.
Krita data is unavailable
- Make sure Krita and ComfyUI are running on the same computer.
- Install and enable the included Aaalice Comfy Bridge from ComfyUI Settings → Aaalice Nodes → Krita.
- Restart Krita after installing or updating the bridge if the node asks you to.
- Confirm that a document is open and that the source file is saved in a supported format if you need metadata.
- Check the node’s connection status. The node reports missing bridges, offline Krita, missing documents, damaged metadata, and export failures rather than using an old snapshot.
Frequently asked questions
Does SimpleNotify tell me when the entire workflow is finished?
No. It alerts you when execution reaches that node. It does not wait for parallel branches or the queue to empty.
Does ResolutionPreset resize an image?
No. It outputs width and height values for other nodes to use.
Do prompt-library entries get copied into each workflow?
No. PromptSelector stores references to entries in the local library. The library itself is stored in your ComfyUI user directory and does not travel with the workflow.
Are gallery blacklists sent to the image site?
No. The content blacklist is applied locally to returned results. It does not use remote exclusion tags or consume a search-tag slot.
Does the Krita node use the image shown in its status preview?
No. It requests the current document data when the workflow executes. The status preview is not reused as the workflow image.
Learn More about ComfyUI-Aaalice-Nodes
- ComfyUI-Aaalice-Nodes on GitHub
- Report a bug or request a feature
- ComfyUI-Aaalice-Nodes on the Comfy Registry
- ComfyUI-Autocomplete-Aaalice, for tag and Chinese-language autocomplete in supported fields
- ComfyUI-Lora-Manager is referenced by the extension for advanced image-saving features; use the project’s own documentation to confirm its current options
- Aaalice-Workflows, for workflows associated with the author’s projects
- ComfyUI-Aaalice-Workflow-Hub, for workflow management and sharing information from the referenced project context
