Où se trouve le dossier de modèles ComfyUI ? Chemins par défaut et supplémentaires

Pour une installation portable ou manuelle de ComfyUI, la bibliothèque de modèles native est ComfyUI/models/. Placez chaque fichier dans le sous-répertoire correspondant à son type : les checkpoints dans models/checkpoints, les LoRAs dans models/loras et les VAEs dans models/vae. Si les fichiers se trouvent déjà dans une bibliothèque partagée, ajoutez celle-ci comme chemin de modèle supplémentaire au lieu d'en faire une nouvelle copie complète.

Le dossier des modèles natifs de ComfyUI

ComfyUI ne considère pas models comme un seul et même conteneur. Ses chargeurs recherchent dans les dossiers enregistrés le type de modèle correspondant. Le dossier natif de ComfyUI pour les LoRA est ComfyUI/models/loras. Un checkpoint placé là-bas reste un checkpoint ; le changer de lieu ne modifie pas ce que contient le fichier.

ComfyUI/
└── models/
    ├── checkpoints/       # checkpoints de diffusion complets
    ├── diffusion_models/  # poids de diffusion ou d'UNet
    ├── loras/             # Fichiers LoRA et autres fichiers d'adaptateurs
    ├── text_encoders/     # poids de l'encodeur de texte
    ├── vae/               # Modèles VAE
    └── controlnet/        # Modèles ControlNet et T2I-Adapter

L'exemple de configuration officielle actuel reconnaît également les anciens noms tels que unet et clip. Pour une bibliothèque neuve et ordonnée, privilégiez les noms actuels indiqués ci-dessus. D'autres types de nœuds peuvent enregistrer davantage de dossiers, donc un package de nœud personnalisé peut ajouter un emplacement de modèle qui n'est pas dans cette courte liste.

ComfyUI Desktop : ouvrez le dossier, ne le devinez pas

Les installations de bureau prêtent facilement à confusion, car l'application gère une plus grande partie de l'organisation. Dans ComfyUI Desktop, utilisez Help → Open Folder → Open Model Folder. Cette commande ouvre l'emplacement actif et évite de copier un modèle dans un dossier au nom similaire appartenant à une ancienne installation.

C'est aussi le diagnostic le plus rapide lorsqu'un fichier n'apparaît pas. Vérifiez que vous regardez le dossier de modèles utilisé par l'application en cours, et non simplement le premier ComfyUI renvoyé par une recherche dans le système de fichiers.

Lorsque les chemins de modèles supplémentaires sont la meilleure solution

Un chemin supplémentaire est utile lorsque deux installations de ComfyUI doivent voir la même bibliothèque, lorsqu'une autre interface utilisateur possède déjà les fichiers ou lorsque de grands modèles se trouvent sur un autre disque. Il indique à ComfyUI où chercher également. Il ne copie, ne convertit, ne fusionne ni ne sauvegarde un modèle.

Le détail gênant est que ComfyUI portable/manuel et ComfyUI Desktop n'utilisent pas le même nom de fichier de configuration :

• Installation portable ou manuelle : copiez ComfyUI/extra_model_paths.yaml.example dans ComfyUI/extra_model_paths.yaml, puis éditez la copie.
• Bureau sur Windows : modifier C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml.
• Bureau sur macOS : modifier ~/Library/Application Support/ComfyUI/extra_models_config.yaml.

Un petit fichier de configuration de chemin supplémentaire lisible

Commencez par une bibliothèque nommée et uniquement les types de modèles que vous partagez réellement. base_path est le répertoire parent ; les autres valeurs sont des chemins par rapport à celui-ci.

shared_models:
  base_path: /Volumes/AI-Library/models/
  checkpoints: checkpoints
  loras: loras
  vae: vae
  controlnet: controlnet
  text_encoders: text_encoders
  diffusion_models: diffusion_models

Sur Windows, utilisez un chemin Windows absolu pour base_path, tel que D:\AI-Library\models\. Gardez les espaces dans le chemin s'ils sont réels ; n'ajoutez des guillemets ou des séquences d'échappement que si le parseur YAML les exige. La configuration la plus simple est généralement celle que vous pouvez comparer directement avec les dossiers sur disque.

Redémarrez, actualisez et vérifiez un modèle connu

Enregistrez la configuration et redémarrez ComfyUI. Le guide officiel des modèles mentionne également que r actualise les définitions des nœuds, mais un redémarrage est le moyen le plus clair pour vérifier après avoir modifié les chemins des modèles. Puis vérifiez la configuration avec des fichiers que vous pouvez identifier :

1. Sélectionnez un checkpoint connu et un LoRA connu dans la bibliothèque externe.
2. Vérifiez que chacun d'eux apparaît dans le chargeur approprié, et non simplement quelque part dans l'interface.
3. Chargez un petit workflow existant et vérifiez que les deux fichiers peuvent être ouverts.
4. Gardez l'emplacement original intact jusqu'à ce que ce test réussisse après un redémarrage.

Si un modèle manque, vérifiez dans l'ordre le dossier de modèles actif, l'indentation du YAML, base_path, le sous-dossier propre au type et l'extension du fichier. Une analyse YAML réussie ne prouve pas qu'un checkpoint a été classé comme checkpoint.

Un chemin supplémentaire n'est pas un plan de conservation

Un répertoire partagé peut éviter les copies de travail redondantes, mais il reste un stockage en temps réel. La suppression d'un fichier dans celui-ci peut affecter chaque installation de ComfyUI qui y fait référence. De la même manière, un fichier SafeTensors ne bénéficie pas d'une sauvegarde uniquement parce que deux applications peuvent y accéder.

Tensor Archive intervient une fois la question de l'environnement d'exécution résolue. Identifiez une famille de modèles terminée et cohérente — par exemple, un checkpoint de base et ses adaptateurs — puis archivez, vérifiez et restaurez cette famille séparément. Tensor Archive ne réécrit pas la configuration de ComfyUI et ne supprime pas silencieusement le dossier source.

Choisissez le prochain guide en fonction du problème que vous avez réellement

Si vous devez conserver un workflow entre les chemins natifs et les chemins supplémentaires, utilisez le guide Sauvegarde de modèles ComfyUI. Si le SSD est déjà plein d'adaptateurs, suivez le guide pratique pour libérer de l'espace disque dans une bibliothèque LoRA. Pour la différence entre les méthodes d'entraînement et l'artefact d'adaptateur qu'elles produisent, lisez LoRA contre QLoRA.