explaingit

o-l-l-i/comfyui-olm-liquify

11JavaScriptAudience · designerComplexity · 2/5LicenseSetup · easy

TLDR

A custom node for ComfyUI that adds a Photoshop-style Liquify editor so you can manually warp and reshape AI-generated images with a brush before they continue through your generation workflow.

Mindmap

mindmap
  root((olm-liquify))
    What it does
      Warp images interactively
      Bake edits into graph
    Warp Tools
      Push and Pull
      Twirl and Pinch
      Expand and Smooth
    Visual Aids
      Grid overlay
      Mesh overlay
      Brush size and strength
    Save and Reload
      Export warp file
      Import for reuse
    Known Limits
      Single images only
      No batch support
      Settings not persisted
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Warp and reshape an AI-generated portrait interactively before passing it to an upscaler in your ComfyUI workflow.

USE CASE 2

Save a warp configuration to a file and reload it to apply the same distortion to similar images without redoing the work.

USE CASE 3

Use the grid and mesh overlays to precisely judge how far pixels have moved during a complex deformation.

Tech stack

JavaScriptComfyUI

Getting it running

Difficulty · easy Time to first run · 30min

The Liquify editor requires one full graph run to load the image into memory before the interactive panel becomes available.

Source-available custom license, free to use and keep all outputs, but redistributing or reselling the code is not permitted.

In plain English

ComfyUI is an open-source tool for building AI image generation workflows by connecting nodes together in a visual graph. Olm Liquify adds a custom node to that graph that lets you warp and reshape images interactively before they move on to the rest of your workflow. When you drop the node into your graph and connect an image to it, you can open a dedicated editor that works similarly to the Liquify filter in Photoshop. Inside the editor you paint directly over the image using tools called Push, Pull, Twirl, Pinch, Expand, and Smooth. Each one distorts the image pixels in a different direction or pattern. You control how strongly the warp applies by adjusting brush radius and strength, either through sliders or by scrolling the mouse wheel. Once you are happy with the result, clicking Apply bakes the changes back into the graph so that later nodes receive the modified image. The editor includes a few visual aids to help you judge the distortion. An optional grid overlay lets you track straight lines across the image, and an optional mesh overlay shows the actual shape of the deformation field so you can see exactly how far pixels have moved. You can also save the warp to a file and reload it later, which is useful when you want to apply the same distortion to similar images without redoing the work. A few practical limits are worth knowing. The tool is designed for single still images only and does not support video frames or batch processing. Settings like brush size and grid color are not saved when you close the editor or refresh the browser. The editor also needs one graph run to load the image into memory before the interactive panel becomes available, so you cannot open it the moment you place the node. If you restart ComfyUI, you need to run the graph once again to reload the cached image. The project is source-available under a custom license. You can use it freely and keep all output you generate, but redistributing or reselling the code is not allowed.

Copy-paste prompts

Prompt 1
In ComfyUI with olm-liquify installed, how do I open the Liquify editor and use the Push tool to reshape a face in a generated image?
Prompt 2
How do I save my warp settings in olm-liquify and reload them for a different image in the same ComfyUI session?
Prompt 3
Walk me through building a ComfyUI workflow that generates an image, lets me warp it with olm-liquify, then upscales the result.
Open on GitHub → Explain another repo

← o-l-l-i on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.