Skip to content

Commit c671dd1

Browse files
authored
Merge pull request #14 from Comfy-Org/feature/update-checkpointloadersimple-docs
Update CheckpointLoaderSimple documentation for all languages
2 parents d5caf32 + 0dc39b7 commit c671dd1

File tree

7 files changed

+121
-82
lines changed

7 files changed

+121
-82
lines changed
Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,21 @@
1-
This node will detect models located in the `ComfyUI/models/checkpoints` folder, and it will also read models from additional paths configured in the extra_model_paths.yaml file. Sometimes, you may need to **refresh the ComfyUI interface** (shortcut 'Ctrl + R') to allow it to read the model files from the corresponding folder.
1+
This is a model loader node that loads model files from specified locations and decomposes them into three core components: the main model, text encoder, and image encoder/decoder.
22

3-
The CheckpointLoaderSimple node is designed for loading model checkpoints without the need for specifying a configuration. It simplifies the process of checkpoint loading by requiring only the checkpoint name, making it more accessible for users who may not be familiar with the configuration details.
4-
## Input types
3+
This node automatically detects all model files in the `ComfyUI/models/checkpoints` folder, as well as additional paths configured in your `extra_model_paths.yaml` file.
54

6-
| Field | Comfy dtype | Description |
7-
|-----------|-------------|-----------------------------------------------------------------------------------|
8-
| `ckpt_name`| `COMBO[STRING]` | Specifies the name of the checkpoint to be loaded, determining which checkpoint file the node will attempt to load and affecting the node's execution and the model that is loaded. |
5+
1. **Model Compatibility**: Ensure the selected model is compatible with your workflow. Different model types (such as SD1.5, SDXL, Flux, etc.) need to be paired with corresponding samplers and other nodes
6+
2. **File Management**: Place model files in the `ComfyUI/models/checkpoints` folder, or configure other paths through extra_model_paths.yaml
7+
3. **Interface Refresh**: If new model files are added while ComfyUI is running, you need to refresh the browser (Ctrl+R) to see the new files in the dropdown list
98

10-
## Output types
9+
## Input Parameters
1110

12-
| Field | Comfy dtype | Description |
13-
|-------|-------------|--------------------------------------------------------------------------|
14-
| `model` | `MODEL` | Returns the loaded model, allowing it to be used for further processing or inference. |
15-
| `clip` | `CLIP` | Returns the CLIP model associated with the loaded checkpoint, if available. |
16-
| `vae` | `VAE` | Returns the VAE model associated with the loaded checkpoint, if available. |
11+
| Parameter Name | Data Type | Input Method | Default Value | Value Range | Description |
12+
|----------------|-----------|--------------|---------------|-------------|-------------|
13+
| ckpt_name | STRING | Dropdown Selection | null | All model files in checkpoints folder | Select the checkpoint model file name to load, which determines the AI model used for subsequent image generation |
14+
15+
## Output Parameters
16+
17+
| Output Name | Data Type | Description |
18+
|-------------|-----------|-------------|
19+
| MODEL | MODEL | The main diffusion model used for image denoising generation, the core component of AI image creation |
20+
| CLIP | CLIP | The model used for encoding text prompts, converting text descriptions into information that AI can understand |
21+
| VAE | VAE | The model used for image encoding and decoding, responsible for converting between pixel space and latent space |
Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
1-
Este nodo detectará los modelos ubicados en la carpeta `ComfyUI/models/checkpoints`,
2-
y también leerá los modelos de las rutas adicionales que hayas configurado en el archivo extra_model_paths.yaml.
3-
A veces, es posible que necesites **refrescar la interfaz de ComfyUI** para que pueda leer los archivos de modelo en la carpeta correspondiente.
1+
Este es un nodo cargador de modelos que carga archivos de modelos desde ubicaciones específicas y los descompone en tres componentes principales: el modelo principal, el codificador de texto y el codificador/decodificador de imágenes.
42

3+
Este nodo detecta automáticamente todos los archivos de modelos en la carpeta `ComfyUI/models/checkpoints`, así como rutas adicionales configuradas en tu archivo `extra_model_paths.yaml`.
54

6-
El nodo CheckpointLoaderSimple está diseñado para cargar checkpoints de modelos sin necesidad de especificar una configuración. Simplifica el proceso de carga de checkpoints al requerir solo el nombre del checkpoint, haciéndolo más accesible para usuarios que pueden no estar familiarizados con los detalles de configuración.
7-
## Tipos de entrada
5+
1. **Compatibilidad del modelo**: Asegúrate de que el modelo seleccionado sea compatible con tu flujo de trabajo. Diferentes tipos de modelos (como SD1.5, SDXL, Flux, etc.) necesitan ser emparejados con los samplers correspondientes y otros nodos
6+
2. **Gestión de archivos**: Coloca los archivos de modelos en la carpeta `ComfyUI/models/checkpoints`, o configura otras rutas a través de extra_model_paths.yaml
7+
3. **Actualización de interfaz**: Si se agregan nuevos archivos de modelos mientras ComfyUI está ejecutándose, necesitas actualizar el navegador (Ctrl+R) para ver los nuevos archivos en la lista desplegable
88

9-
| Campo | Comfy dtype | Descripción |
10-
|-----------|-------------|-----------------------------------------------------------------------------------|
11-
| `ckpt_name`| `COMBO[STRING]` | Especifica el nombre del checkpoint a cargar, determinando qué archivo de checkpoint intentará cargar el nodo y afectando la ejecución del nodo y el modelo que se carga. |
9+
## Parámetros de Entrada
1210

13-
## Tipos de salida
11+
| Nombre del Parámetro | Tipo de Datos | Método de Entrada | Valor Predeterminado | Rango de Valores | Descripción |
12+
|----------------------|---------------|-------------------|----------------------|------------------|-------------|
13+
| nombre_ckpt | STRING | Selección Desplegable | null | Todos los archivos de modelos en la carpeta checkpoints | Selecciona el nombre del archivo de checkpoint del modelo a cargar, que determina el modelo de IA utilizado para la generación posterior de imágenes |
1414

15-
| Campo | Comfy dtype | Descripción |
16-
|-------|-------------|--------------------------------------------------------------------------|
17-
| `model` | `MODEL` | Devuelve el modelo cargado, permitiendo que se utilice para procesamiento o inferencia adicional. |
18-
| `clip` | `CLIP` | Devuelve el modelo CLIP asociado con el checkpoint cargado, si está disponible. |
19-
| `vae` | `VAE` | Devuelve el modelo VAE asociado con el checkpoint cargado, si está disponible. |
15+
## Parámetros de Salida
16+
17+
| Nombre de Salida | Tipo de Datos | Descripción |
18+
|------------------|---------------|-------------|
19+
| MODELO | MODEL | El modelo de difusión principal utilizado para la generación de imágenes por eliminación de ruido, el componente central de la creación de imágenes con IA |
20+
| CLIP | CLIP | El modelo utilizado para codificar prompts de texto, convirtiendo descripciones de texto en información que la IA puede entender |
21+
| VAE | VAE | El modelo utilizado para la codificación y decodificación de imágenes, responsable de convertir entre el espacio de píxeles y el espacio latente |
Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
1-
Ce nœud détectera les modèles situés dans le dossier `ComfyUI/models/checkpoints`,
2-
et lira également les modèles des chemins supplémentaires que vous avez configurés dans le fichier extra_model_paths.yaml.
3-
Parfois, vous devrez **rafraîchir l'interface ComfyUI** pour qu'elle puisse lire les fichiers de modèle dans le dossier correspondant.
1+
Ceci est un nœud chargeur de modèles qui charge des fichiers de modèles à partir d'emplacements spécifiés et les décompose en trois composants principaux : le modèle principal, l'encodeur de texte et l'encodeur/décodeur d'images.
42

3+
Ce nœud détecte automatiquement tous les fichiers de modèles dans le dossier `ComfyUI/models/checkpoints`, ainsi que les chemins supplémentaires configurés dans votre fichier `extra_model_paths.yaml`.
54

6-
Le nœud CheckpointLoaderSimple est conçu pour charger des checkpoints de modèle sans avoir besoin de spécifier une configuration. Il simplifie le processus de chargement de checkpoint en ne nécessitant que le nom du checkpoint, le rendant plus accessible pour les utilisateurs qui pourraient ne pas être familiers avec les détails de configuration.
7-
## Types d'entrée
5+
1. **Compatibilité du modèle** : Assurez-vous que le modèle sélectionné est compatible avec votre flux de travail. Différents types de modèles (comme SD1.5, SDXL, Flux, etc.) doivent être associés aux échantillonneurs correspondants et autres nœuds
6+
2. **Gestion des fichiers** : Placez les fichiers de modèles dans le dossier `ComfyUI/models/checkpoints`, ou configurez d'autres chemins via extra_model_paths.yaml
7+
3. **Actualisation de l'interface** : Si de nouveaux fichiers de modèles sont ajoutés pendant que ComfyUI fonctionne, vous devez actualiser le navigateur (Ctrl+R) pour voir les nouveaux fichiers dans la liste déroulante
88

9-
| Champ | Comfy dtype | Description |
10-
|-----------|-------------|-----------------------------------------------------------------------------------|
11-
| `ckpt_name`| `COMBO[STRING]` | Spécifie le nom du checkpoint à charger, déterminant quel fichier de checkpoint le nœud tentera de charger et affectant l'exécution du nœud ainsi que le modèle chargé. |
9+
## Paramètres d'Entrée
1210

13-
## Types de sortie
11+
| Nom du Paramètre | Type de Données | Méthode d'Entrée | Valeur Par Défaut | Plage de Valeurs | Description |
12+
|-------------------|-----------------|------------------|-------------------|------------------|-------------|
13+
| nom_ckpt | STRING | Sélection Déroulante | null | Tous les fichiers de modèles dans le dossier checkpoints | Sélectionne le nom du fichier de checkpoint du modèle à charger, qui détermine le modèle IA utilisé pour la génération d'images ultérieure |
1414

15-
| Champ | Comfy dtype | Description |
16-
|-------|-------------|--------------------------------------------------------------------------|
17-
| `model` | `MODEL` | Retourne le modèle chargé, permettant son utilisation pour un traitement ou une inférence ultérieure. |
18-
| `clip` | `CLIP` | Retourne le modèle CLIP associé au checkpoint chargé, si disponible. |
19-
| `vae` | `VAE` | Retourne le modèle VAE associé au checkpoint chargé, si disponible. |
15+
## Paramètres de Sortie
16+
17+
| Nom de Sortie | Type de Données | Description |
18+
|---------------|-----------------|-------------|
19+
| MODÈLE | MODEL | Le modèle de diffusion principal utilisé pour la génération d'images par débruitage, le composant central de la création d'images IA |
20+
| CLIP | CLIP | Le modèle utilisé pour encoder les prompts textuels, convertissant les descriptions textuelles en informations que l'IA peut comprendre |
21+
| VAE | VAE | Le modèle utilisé pour l'encodage et le décodage d'images, responsable de la conversion entre l'espace pixel et l'espace latent |
Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
1-
このノードは、`ComfyUI/models/checkpoints` フォルダーにあるモデルを検出し、
2-
また、extra_model_paths.yaml ファイルで設定された追加のパスからモデルを読み取ります。
3-
場合によっては、**ComfyUIのインターフェースを更新する**必要があるかもしれません。そうしないと、対応するフォルダー内のモデルファイルを読み取ることができません。
1+
これは、指定された場所からモデルファイルを読み込み、主要な3つのコンポーネント(メインモデル、テキストエンコーダー、画像エンコーダー/デコーダー)に分解するモデルローダーノードです。
42

3+
このノードは、`ComfyUI/models/checkpoints`フォルダー内のすべてのモデルファイルと、`extra_model_paths.yaml`ファイルで設定された追加パスを自動的に検出します。
54

6-
CheckpointLoaderSimpleノードは、設定を指定することなくモデルのチェックポイントをロードするために設計されています。チェックポイント名のみを必要とすることで、設定の詳細に不慣れなユーザーにもアクセスしやすくなっています。
7-
## 入力タイプ
5+
1. **モデル互換性**:選択したモデルがワークフローと互換性があることを確認してください。異なるモデルタイプ(SD1.5、SDXL、Fluxなど)は、対応するサンプラーや他のノードと組み合わせる必要があります
6+
2. **ファイル管理**:モデルファイルを`ComfyUI/models/checkpoints`フォルダーに配置するか、extra_model_paths.yamlを通じて他のパスを設定してください
7+
3. **インターフェース更新**:ComfyUIの実行中に新しいモデルファイルが追加された場合、ブラウザーを更新(Ctrl+R)してドロップダウンリストに新しいファイルを表示する必要があります
88

9-
| フィールド | Comfy dtype | 説明 |
10-
|-----------|-------------|-----------------------------------------------------------------------------------|
11-
| `ckpt_name`| `COMBO[STRING]` | ロードするチェックポイントの名前を指定し、ノードがロードしようとするチェックポイントファイルを決定し、ノードの実行とロードされるモデルに影響を与えます。 |
9+
## 入力パラメータ
1210

13-
## 出力タイプ
11+
| パラメータ名 | データ型 | 入力方法 | デフォルト値 | 値の範囲 | 説明 |
12+
|-------------|----------|----------|--------------|----------|------|
13+
| ckpt名 | STRING | ドロップダウン選択 | null | checkpointsフォルダー内のすべてのモデルファイル | 読み込むチェックポイントモデルファイル名を選択し、後続の画像生成で使用するAIモデルを決定します |
1414

15-
| フィールド | Comfy dtype | 説明 |
16-
|-------|-------------|--------------------------------------------------------------------------|
17-
| `model` | `MODEL` | ロードされたモデルを返し、さらなる処理や推論に使用できるようにします。 |
18-
| `clip` | `CLIP` | ロードされたチェックポイントに関連付けられたCLIPモデルを返します(利用可能な場合)。 |
19-
| `vae` | `VAE` | ロードされたチェックポイントに関連付けられたVAEモデルを返します(利用可能な場合)。 |
15+
## 出力パラメータ
16+
17+
| 出力名 | データ型 | 説明 |
18+
|--------|----------|------|
19+
| モデル | MODEL | 画像のノイズ除去生成に使用される主要な拡散モデル、AI画像作成の中核コンポーネント |
20+
| CLIP | CLIP | テキストプロンプトのエンコードに使用されるモデル、テキスト記述をAIが理解できる情報に変換します |
21+
| VAE | VAE | 画像のエンコードとデコードに使用されるモデル、ピクセル空間と潜在空間の間の変換を担当します |
Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
1-
이 노드는 `ComfyUI/models/checkpoints` 폴더에 있는 모델을 감지하고,
2-
또한 extra_model_paths.yaml 파일에서 설정한 추가 경로의 모델을 읽습니다.
3-
때때로 **ComfyUI 인터페이스를 새로 고침**해야 해당 폴더의 모델 파일을 읽을 수 있습니다.
1+
이것은 지정된 위치에서 모델 파일을 로드하고 세 가지 핵심 구성 요소(메인 모델, 텍스트 인코더, 이미지 인코더/디코더)로 분해하는 모델 로더 노드입니다.
42

3+
이 노드는 `ComfyUI/models/checkpoints` 폴더의 모든 모델 파일과 `extra_model_paths.yaml` 파일에서 설정한 추가 경로를 자동으로 감지합니다.
54

6-
CheckpointLoaderSimple 노드는 설정을 지정할 필요 없이 모델 체크포인트를 로드하도록 설계되었습니다. 체크포인트 이름만 필요로 하여, 설정 세부 사항에 익숙하지 않은 사용자에게 더 쉽게 접근할 수 있도록 합니다.
7-
## 입력 유형
5+
1. **모델 호환성**: 선택한 모델이 워크플로우와 호환되는지 확인하세요. 다양한 모델 유형(SD1.5, SDXL, Flux 등)은 해당 샘플러 및 기타 노드와 함께 사용해야 합니다
6+
2. **파일 관리**: 모델 파일을 `ComfyUI/models/checkpoints` 폴더에 배치하거나 extra_model_paths.yaml을 통해 다른 경로를 설정하세요
7+
3. **인터페이스 새로 고침**: ComfyUI 실행 중에 새 모델 파일이 추가된 경우, 드롭다운 목록에서 새 파일을 보려면 브라우저를 새로 고침(Ctrl+R)해야 합니다
88

9-
| 필드 | Comfy dtype | 설명 |
10-
|-----------|-------------|-----------------------------------------------------------------------------------|
11-
| `ckpt_name`| `COMBO[STRING]` | 로드할 체크포인트의 이름을 지정하며, 노드가 로드할 체크포인트 파일을 결정하고 노드의 실행 및 로드된 모델에 영향을 미칩니다. |
9+
## 입력 매개변수
1210

13-
## 출력 유형
11+
| 매개변수 이름 | 데이터 유형 | 입력 방법 | 기본값 | 값 범위 | 설명 |
12+
|--------------|-------------|-----------|--------|---------|------|
13+
| 체크포인트 파일명 | STRING | 드롭다운 선택 | null | checkpoints 폴더의 모든 모델 파일 | 로드할 체크포인트 모델 파일 이름을 선택하며, 후속 이미지 생성에 사용되는 AI 모델을 결정합니다 |
1414

15-
| 필드 | Comfy dtype | 설명 |
16-
|-------|-------------|--------------------------------------------------------------------------|
17-
| `model` | `MODEL` | 로드된 모델을 반환하여 추가 처리나 추론에 사용할 수 있도록 합니다. |
18-
| `clip` | `CLIP` | 로드된 체크포인트와 연관된 CLIP 모델을 반환합니다, 사용 가능한 경우. |
19-
| `vae` | `VAE` | 로드된 체크포인트와 연관된 VAE 모델을 반환합니다, 사용 가능한 경우. |
15+
## 출력 매개변수
16+
17+
| 출력 이름 | 데이터 유형 | 설명 |
18+
|----------|-------------|------|
19+
| 모델 | MODEL | 이미지 노이즈 제거 생성에 사용되는 주요 확산 모델, AI 이미지 생성의 핵심 구성 요소 |
20+
| CLIP | CLIP | 텍스트 프롬프트 인코딩에 사용되는 모델, 텍스트 설명을 AI가 이해할 수 있는 정보로 변환 |
21+
| VAE | VAE | 이미지 인코딩 및 디코딩에 사용되는 모델, 픽셀 공간과 잠재 공간 간의 변환을 담당 |

0 commit comments

Comments
 (0)