ComfyUI Folder Structure: Where Models and Files Live

The following is a breakdown of the roles of some files in the ComfyUI installation directory.

ComfyUI_windows_portable
├── ComfyUI                                            // Main folder for Comfy UI
│  ├── .git                                            // Git version control folder, used for code version management
│  ├── .github                                         // GitHub Actions workflow folder
│  ├── comfy                                           //
│  ├── 📁 comfy_extras                                 //
│  ├── 📁 custom_nodes                                 // Directory for ComfyUI custom node files (plugin installation directory)
│  ├── 📁 input                                        // ComfyUI upload folder, when you use nodes like load image, the corresponding uploaded images will be stored in this folder
│  ├── 📁 models                                       // Corresponding model file configuration folder
│  |  ├── 📁 checkpoints                               // Path for storing large model checkpoint files
│  |  ├── 📁 clip                                      // Path for storing CLIP files
│  |  ├── 📁 clip_vision                               // Path for storing CLIP_vision files
│  |  ├── 📁 configs
│  |  ├── 📁 controlnet                                // Path for storing ControlNet model files
│  |  ├── 📁 diffusers
│  |  ├── 📁 embedding                                 // Path for storing embedding model files
│  |  ├── 📁 gligen
│  |  ├── 📁 hypernetworks                             // Path for storing hypernetwork models
│  |  ├── 📁 loras                                     // Path for storing Lora model files
│  |  ├── 📁 style_models
│  |  ├── 📁 unet
│  |  ├── 📁 upscale_models                            // Path for storing upscale model files
│  |  ├── 📁 vae                                       // Path for storing VAE model files
│  |  └── 📁 vae_approx
│  ├── 📁 notebooks
│  ├── 📁 user                                         // ComfyUI user information (such as configuration files, workflow information, etc.)
│  |    ├── 📁 default                                 // Default ComfyUI user folder
│  |    |    ├─ 📁 workflow                            // Folder for user-saved workflows
│  |    |    ├─ 📄 xxx.json                            // User configuration file
│  |    |    └── ... xxx.json                          // Other configuration files
│  |    └── ...[username]                              // If multi-user is enabled and multiple users exist, corresponding different usernames will be displayed
│  ├── 📁 output                                       // ComfyUI image output folder, when using nodes like save image, the generated images will be stored in this folder
│  |    ├── 📁 checkpoints                             // If using model merge nodes and related functions to save merged models, the merged models will be output here
│  |    └── ... xxx.png                                // Files generated during the process will be saved here
│  ├── extra_model_paths.yaml.example                  // Extra model file path configuration file, if you set this, please remove the .example suffix and edit with a text editor
│  └── ...                                             // Other files
├── 📁 config                                          // Configuration folder
├── 📁 Python_embeded                                  // Embedded Python files
├── 📁 update  
│  ├── update.py                                       // Python script for ComfyUI
│  ├── update_comfyUI.bat                              // The batch command recommended by the author of ComfyUI to upgrade ComfyUI
│  └── update_comfyui_and_python_dependencies.bat      // Only run this batch command when there are issues with your Python dependency files
├── comfyui.log                                        // Comfy UI runtime log file
├── README_VERY_IMPORTANT.txt                          // README file, includes methods and explanations for file usage, etc.
├── run_cpu.bat                                        // Batch file, double-click to start ComfyUI when your graphics card is an A card or you only have a CPU
└── run_nvidia_gpu.bat                                 // Batch file, double-click to start ComfyUI when your graphics card is an N card (Nvidia)

ComfyUI Desktop folder locations

The ComfyUI Desktop app keeps its data outside the app install folder. By default it uses a base folder under your Documents directory:

Windows: C:\Users\<username>\Documents\ComfyUI\
macOS: ~/Documents/ComfyUI/

The models folder inside it uses the same subdirectories as the portable version (checkpoints, loras, vae, unet, clip, etc.), so models placed in Documents/ComfyUI/models/<type>/ appear in the node pickers. Generated images go to output, uploaded images to input.

You can change the base folder in ComfyUI Desktop settings. To add extra model folders, edit extra_models_config.yaml (Windows: %APPDATA%\ComfyUI\extra_models_config.yaml, macOS: ~/Library/Application Support/ComfyUI/extra_models_config.yaml).

ComfyUI Desktop folder locations

Comments