Sidebar catalog using the website's token search and ordering, with a visible base-model filter and saved base-model preference.
English, Romaji, or Japanese origin display; search always checks all available origin languages.
KurutAI LoRA + Prompt node with the shared V2 recipe: character, outfit, style, pose, and negative prompt.
Character, outfit, and style slots can be added, replaced, or removed independently while remaining compatible with the selected base model.
Additional selected LoRAs are downloaded with the same queue-time consent and loaded as one ordered stack.
Optional synchronized KurutAI Gallery with separate, on-demand galleries for character outfits, character previews, outfit LoRAs, and style LoRAs. It shows one image at a time, includes generation details, and can apply a displayed character outfit to the generation node.
Automatic insertion into a standard sampler/text-encode chain, or replacement of a selected native Load LoRA node while preserving connections.
KurutAI LoRA Loader with separate model and CLIP strengths.
KurutAI LoRA Selector whose lora_name output connects to ComfyUI's native Load LoRA node.
KurutAI Prompt with editable positive, negative, and trigger-word text.
Model-specific standard negative prompts are added when a LoRA has no recommendation. Each base-model default can be edited or disabled in Settings → KurutAI → Prompts.
Prompt snapshots saved inside workflows, so prompt text remains available offline.
SHA-256 verified downloads with live progress and detailed ComfyUI console logging.
Missing shared-workflow LoRAs are checked only when the workflow is queued. Opening a workflow never downloads anything.
NSFW previews are disabled by default in Settings → KurutAI.
Private commission LoRAs can be added from Settings → KurutAI → Private models by pasting the private page link I sent you. They then appear in the normal catalog and search. The access token is stored only in this ComfyUI installation and is never written into workflows.

Install

ComfyUI Manager

Search for KurutAI for ComfyUI in ComfyUI Manager, install it, and restart ComfyUI.

Git

cd ComfyUI/custom_nodes
git clone https://github.com/KurutAI/KurutAI-ComfyUI.git

Restart ComfyUI. There are no additional Python packages to install.

ZIP

Extract the repository into ComfyUI/custom_nodes/KurutAI-ComfyUI, then restart ComfyUI. Make sure the repository files are directly inside that folder rather than inside a second nested folder.

Use

Open the KurutAI tab in ComfyUI's sidebar.
Search or filter the catalog.
Choose Add to workflow to add or update the matching character, outfit, or style slot in the single KurutAI node. A selected catalog item changes to Remove from workflow.
Optionally choose compatible LoRAs and a pose from the Prompt Builder inside the node. Every LoRA has its own weight, and the pose refresh button immediately generates another visible pose prompt. Put quality tags, camera details, or other permanent text in Stable prompt; it remains untouched while the generated prompt changes, and both fields are combined for the workflow output. On a standard workflow, the extension connects the node automatically.
Use Add Gallery Node in the generation-node header when you want the synchronized gallery. The same button removes it again.

Downloads use the configured LoRA folders shown under Settings → KurutAI → Downloads → LoRA download folder. Existing files are detected recursively across every configured LoRA folder before a download starts.

The first time a queued workflow needs a missing KurutAI LoRA, ComfyUI explains that continuing also enables future automatic KurutAI downloads. This can be disabled at any time in Settings → KurutAI → Downloads.

Files and collisions

The extension uses the filename published by KurutAI and saves it directly into ComfyUI's configured LoRA folder—no separate KurutAI model folder is created. If a file with the same name and SHA-256 already exists, it is reused. If the name exists but the hash differs, the extension asks before using a numbered filename. It never silently overwrites another model.

Network and analytics

The extension uses the catalog/download API v1 and Prompt Builder API v2 at https://lora.nudemuse.online/api. It identifies itself with X-KurutAI-Client: kurutai-comfyui/<version>. No API key or KurutAI account is required.

For development, KURUTAI_API_BASE_URL can point the Python backend at another compatible v1 API before ComfyUI starts; the extension derives the sibling v2 URL for prompt building.

Build or modify your own extension

You are welcome to modify this extension, create a fork, or build a separate client that uses the KurutAI API. The source is MIT-licensed, and the API and catalog are available free of charge and will always remain free.

The public API documentation includes endpoint descriptions, parameters, examples, and authentication details. An OpenAPI JSON schema is also available for generated clients and tooling. No permission or API key is required for normal public API use; please identify your client with the X-KurutAI-Client header and follow the documented limits.

You can use this repository as a starting point, or implement only the parts you need. Please keep your own fork's versioning and documentation clear so users can distinguish it from the official KurutAI extension.

License

MIT