LayerUtility: Load PSD(Advance)
Load PSD — pull individual Photoshop layers straight into ComfyUI
- flat_image
- layer_image
- all_layers
If your source material lives in Photoshop and you want a specific layer - not a flattened export - this is the node that reads a .psd file directly and gives you access to its layer structure without you having to pre-flatten anything in Photoshop first. It's genuinely useful if you're pulling assets from a layered composition someone else built: character on one layer, background on another, and you only want one of them.
image is a dropdown of .psd files already sitting in ComfyUI/input - anything you've previously loaded shows up here for quick re-selection. file_path is the alternative: a full path and filename if the PSD isn't in the input folder. include_hidden_layer decides whether layers that are toggled off/invisible in the PSD still get counted and made available - off by default, which matches what you'd expect (a hidden layer usually means the artist didn't want it used). find_layer_by switches between two ways of picking a layer: layer_index (numbered from the bottom of the stack up, starting at 0) or layer_name (must match exactly, including capitalization and punctuation - a common source of "why isn't this working" when the name looks right at a glance but has a trailing space or different case). layer_index also accepts -1 as a shortcut for the topmost layer, which is handy when you don't know or care about the exact stack position and just want whatever's on top. Note that a layer group in the PSD counts as a single layer for indexing purposes - it doesn't expand into its members. Three outputs come out of this: flat_image (a full preview of the PSD flattened, useful for seeing the whole composition at a glance), layer_image (specifically the layer you selected via index or name), and all_layers (every layer in the file as a batch, if you want to work with the whole stack downstream rather than picking just one).
Install the pack through ComfyUI Manager (search "ComfyUI Layer Style Advance") or git clone https://github.com/chflame163/ComfyUI_LayerStyle_Advance into custom_nodes/, restart. This node depends specifically on the psd_tools Python package, which isn't always installed cleanly by the standard requirements step - the README calls it out as its own separate note, which is a signal it's a common enough failure to warn about up front.
The single most common problem with this node is exactly that: ModuleNotFoundError: No module named 'psd_tools'. If you hit it, close ComfyUI and run python_embeded/python.exe -s -m pip install psd_tools (adjust the path for your ComfyUI flavor) from a terminal opened in the plugin directory. If that install then fails with ModuleNotFoundError: No module named 'docopt', psd_tools has a dependency that doesn't always resolve cleanly through pip - download docopt's wheel file directly (piwheels.org hosts it) and install that specific wheel manually before retrying psd_tools. This two-step failure (psd_tools missing, then docopt missing underneath it) is common enough that the pack ships prebuilt wheels for exactly this and runs the fix automatically as part of the standard dependency-install script - so if you're setting this up fresh, running the full install_requirements.bat (or the Aki equivalent) from the start avoids the manual detour entirely.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| image | COMBO | 0 options: | |
| file_path | STRING | — | |
| include_hidden_layer | BOOLEAN | false | — |
| find_layer_by | COMBO | 2 options: layer_index, layer_name | |
| layer_index | INT | 0-1–999 | — |
| layer_name | STRING | — |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| flat_image | IMAGE | — |
| layer_image | IMAGE | — |
| all_layers | IMAGE | — |