ComfyUI_Antonioilev Introduction
ComfyUI_Antonioilev, described in the original README as Antonioilev Light Pack, is a collection of more than 40 ComfyUI nodes for 3D mesh work, UV layouts, textures, images, previews, and workflow management. The author built it to help you handle practical production tasks without repeatedly leaving ComfyUI for another application.
For example, a generated 3D object may have a hole, broken normals, or UVs that need attention before you can texture it. The Light Pack provides nodes for those tasks alongside tools for inspecting the result, handling batches of images, and freeing video memory between demanding stages. You can combine the nodes with your existing ComfyUI workflows rather than treating each repair as a separate manual job.
How ComfyUI_Antonioilev Works
In ComfyUI, a node is a step in a visual workflow. One node might receive a mesh and clean it; another might create a UV layout; a preview node can then help you inspect the result. Think of the workflow as a production line: each connected step prepares an asset for the next one.
The Light Pack supplies building blocks for several parts of that line:
- Meshes are the geometry that gives a 3D object its shape. Repair nodes help address issues such as holes, unwanted geometry, or incorrect normals.
- UVs describe how a flat texture is placed on a 3D surface. UV nodes help create, inspect, scale, or fix that layout.
- Textures and images provide surface detail or other visual inputs. Image nodes help load, adjust, extract, and save them.
- Previews and workflow utilities help you check work in progress, preserve viewing states, process batches, and manage memory.
You might, for instance, send a mesh through a cleanup node, unwrap its UVs, inspect the UV preview, and then continue to your texturing workflow. Which nodes you need depends on the problem you see in the asset.
ComfyUI_Antonioilev Features
View and preview tools
These nodes help you inspect an asset and return to a useful viewing setup:
- 3D View Save Load saves and restores 3D viewport states.
- 2D View Save Load saves, loads, and manages 2D preview states.
- UV Preview displays a UV layout within the workflow so you can check how the mesh has been laid out for texturing.
These are useful when you are comparing stages of a workflow or need to revisit an asset from a consistent view.
Mesh processing and repair
Use these nodes to prepare geometry for later work. Some address a specific visible problem, while others provide broader cleanup or construction tools:
| Node | What it is for |
|---|---|
| Combine Meshes (Smart) | Combines meshes for use in a workflow. |
| Refine Mesh | Refines geometry to make it cleaner and more usable. |
| Normals Fixer | Repairs mesh normals, which affect how surfaces face and appear when lit. |
| Hole Filler | Fills holes in mesh geometry. |
| CapGPU | Uses GPU acceleration for mesh capping. |
| GPU Mesh Builder | Builds mesh geometry using GPU acceleration. |
| MeshFixer PRO (Safe Repair) | Provides a mesh-repair option intended for production workflows. |
| CleanMesh | Removes unwanted geometry and cleans a mesh. |
| UV-Safe Hard Weld | Welds geometry while aiming to protect its UV layout. |
| Mesh Cutter | Cuts mesh geometry within a workflow. |
| HoleSurgeon | Detects and repairs mesh holes with more targeted controls. |
| Mesh Cleaner | Cleans problematic or unnecessary geometry. |
| MeshOneSurface | Processes and consolidates mesh surfaces. |
| Long Holes Finder | Identifies long or problematic openings in geometry. |
| Hole Hub | Brings together tools for working with mesh holes. |
| HardBottomCap | Creates hard caps for open mesh bottoms. |
As a starting point, choose a node that matches the problem you can identify: Normals Fixer for incorrect surface orientation, Hole Filler for an opening, or UV-Safe Hard Weld when connected geometry needs welding but its texture layout matters. Preview the result before continuing, especially when a repair could affect the object’s shape.
UV workflow tools
UV work determines how a 2D texture fits onto a 3D object:
- UVUnwrap (xatlas) automatically creates a UV layout using xatlas.
- UVShellScale changes the scale of UV shells, the separate pieces of a UV layout.
- UVFixer addresses problematic UV layouts.
- Mesh UV Watertight prepares and repairs UVs for watertight-mesh workflows.
For example, you can generate UVs with UVUnwrap (xatlas), examine them with UV Preview, and use a UV repair or scaling node if the layout needs further work.
Texture, color, and image tools
These nodes support texture preparation and everyday image handling:
- NormalSpaceConverter converts normal maps between normal-space conventions.
- Lightness Shadows/Mid/High lets you adjust the lightness of shadows, midtones, and highlights separately. This gives you more control than changing the brightness of the entire image at once.
- Suffix adds or changes filename suffixes for workflow automation.
- GLBTextureExtractor extracts textures from a GLB asset.
- Composite Saver saves composited results.
- ImageSaver saves images within a workflow.
- Load_batch_images and ImageLoader load images; the batch node is intended for groups of images.
- Save_batch_images saves image batches, while Save_batch_images_alfa saves batches with alpha information preserved.
- List Batch Images helps you inspect and manage an image batch.
If you are preparing many related images, the batch nodes can reduce repeated loading and saving. If transparency matters to the next stage, use the alpha-preserving batch saver.
Projection, geometry, and memory
- MeshProjector projects geometry and data within a workflow.
- Clear VRAM releases video memory between heavy processing stages. This can be useful when a workflow chains together demanding 3D and AI operations.
The Light Pack is intended to work alongside existing 3D generation, mesh-processing, UV, PBR, image-batch, and other custom-node workflows. You can connect only the tools your project calls for and reuse that workflow on later assets.
Learn More about ComfyUI_Antonioilev
- Antonioilev Light Pack on GitHub provides the extension’s repository and documentation.
- The author’s YouTube channel shows the nodes in ComfyUI workflows. Watching a node in use can help you decide where it belongs in your own process.
