<h1 id="comfyui-smartsave">ComfyUI SmartSave</h1>Automatically organize your ComfyUI generations by subject.SmartSave is a ComfyUI custom node that identifies the primary subject in your prompt using a local Ollama model, then automatically saves images and videos into clean subject-based folders.No manual renaming. No giant output folder full of unrelated generations. Classification stays local.<h2 id="automatic-image-organization">Automatic Image Organization</h2>SmartSave can create both an archival master and a compressed sharing copy from the same generation.Raw PNG <code>Raw/ExampleCharacter/ExampleCharacter_00001.png</code>Preserves ComfyUI workflow and prompt metadata.Compressed JPEG <code>Compressed/ExampleCharacter/ExampleCharacter_00001.jpg</code>Creates a smaller sharing copy while storing recoverable prompt information in EXIF metadata.<h2 id="video-support">Video Support</h2>SmartSave Video provides the same automatic organization for video generations.MP4 master <code>Raw Video/ExampleCharacter/ExampleCharacter_00001.mp4</code>Compressed WebM <code>Webm/ExampleCharacter/ExampleCharacter_00001.webm</code>A workflow PNG is saved alongside the master video, and audio is preserved when supplied.<h2 id="local-ai-classification">Local AI Classification</h2>SmartSave uses Ollama locally on your machine to identify subjects such as:<ul><li>People and characters</li><li>Creators</li><li>Usernames and handles</li><li>LoRA trigger names</li><li>Single-word identities</li><li>Multi-word identities</li></ul>The subject can appear anywhere in a long prompt.The default model is <code>llama3.2:3b</code>.SmartSave also includes conservative local fallback logic for cases where Ollama misses an identity. If there still isn't enough information to determine the subject safely, the generation goes to <code>Unsorted</code> rather than forcing a guess.<h2 id="auto-sort-your-existing-library">Auto-Sort Your Existing Library</h2>SmartSave includes a full-library Auto-Sort utility for existing ComfyUI outputs as well as files SmartSave couldn't classify correctly during generation.It can:<ul><li>Recover supported files from <code>Unsorted</code> and <code>Misc</code></li><li>Organize an existing large ComfyUI output library</li><li>Repair recoverable SmartSave classification misses</li><li>Preserve related generation numbering</li><li>Match related workflow/media files</li><li>Protect existing files from filename collisions</li><li>Safely maintain an already-organized SmartSave library</li></ul>Auto-Sort is preview-first.Run:<code>auto_sort_preview.bat</code>Nothing is moved. Review the proposed changes first.When you're satisfied with the plan, run:<code>auto_sort_apply.bat</code>Existing canonical SmartSave folders are trusted by default, preventing old or noisy metadata from unexpectedly reorganizing an already-clean library.<h2 id="designed-to-fail-safely">Designed to Fail Safely</h2>SmartSave intentionally prefers <code>Unsorted</code> over a confident-looking wrong answer.If a file doesn't contain enough evidence to determine its subject, it stays unresolved for later recovery instead of being forced into the wrong folder.Auto-Sort also protects against overwriting an existing destination file.[H2] Tested on a Real LibraryThe v1.0.0 Auto-Sort build was validated against a real 1,539-file image/video library.After recovery:<ul><li>1,539 files kept in place</li><li>0 additional moves proposed</li><li>0 files skipped</li><li>5 legacy WebM files intentionally remained <code>Unsorted</code> because they contained no usable recovery evidence</li></ul>The included regression suite contains 15 automated tests, with 15/15 passing for v1.0.0.<h2 id="installation">Installation</h2>Place the repository in:<code>ComfyUI/custom_nodes/ComfyUI-SmartSave</code>Install the dependencies from:<code>requirements.txt</code>Install Ollama and pull the default model:<code>ollama pull llama3.2:3b</code>Restart ComfyUI. The SmartSave nodes will then be available in your node list.<h2 id="source-code-and-releases">Source Code &amp; Releases</h2>Full documentation, source code, regression tests, example workflow, and current releases are available on GitHub:<code>https://github.com/phibbyrizz/ComfyUI-SmartSave</code>Current release:<code>https://github.com/phibbyrizz/ComfyUI-SmartSave/releases/tag/v1.0.0</code><h2 id="support-smartsave">Support SmartSave </h2><blockquote>SmartSave is free and open source. If it saves you time and you'd like to support continued development, you can support the project on Ko-fi:<a rel="ugc" href="https://ko-fi.com/phibby">Support SmartSave on Ko-fi</a></blockquote>

ComfyUI-SmartSave | Ollama-Powered Dynamic Output Sorting

SmartSave v1.0.0 production release. Improved subject classification including single-word identities and LoRA triggers, hardened fallback behavior, safer image/video saving, and a major Auto-Sort update for organizing existing ComfyUI libraries and recovering misclassified outputs. Includes preview/apply workflows, collision protection, canonical-folder protection, and a 15-test regression suite.

Files with SHA256: e30f8cbda7233fca8adef58c90efebb13f5dcd5fdc06109c755a0c85eaeef53a