Skip to content

Commit 758ed23

Browse files
authored
Merge pull request #57 from Comfy-Org/complete-docs
Add the first version of AI-generated docs
2 parents 34d835d + 9a7c40b commit 758ed23

File tree

3,187 files changed

+58857
-1420
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

3,187 files changed

+58857
-1420
lines changed

.gitignore

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,11 @@ dist
44
*.DS_Store
55
.ref/
66
.cursorrules
7-
.gemini/
7+
.gemini/
8+
9+
# Environment variables
10+
.env
11+
*.env.local
12+
13+
# Doc automation outputs
14+
/doc_automation
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/en.md)
2+
3+
The APG (Adaptive Projected Guidance) node modifies the sampling process by adjusting how guidance is applied during diffusion. It separates the guidance vector into parallel and orthogonal components relative to the conditional output, allowing for more controlled image generation. The node provides parameters to scale the guidance, normalize its magnitude, and apply momentum for smoother transitions between diffusion steps.
4+
5+
## Inputs
6+
7+
| Parameter | Data Type | Input Type | Default | Range | Description |
8+
|-----------|-----------|------------|---------|-------|-------------|
9+
| `model` | MODEL | Required | - | - | The diffusion model to apply adaptive projected guidance to |
10+
| `eta` | FLOAT | Required | 1.0 | -10.0 to 10.0 | Controls the scale of the parallel guidance vector. Default CFG behavior at a setting of 1. |
11+
| `norm_threshold` | FLOAT | Required | 5.0 | 0.0 to 50.0 | Normalize guidance vector to this value, normalization disable at a setting of 0. |
12+
| `momentum` | FLOAT | Required | 0.0 | -5.0 to 1.0 | Controls a running average of guidance during diffusion, disabled at a setting of 0. |
13+
14+
## Outputs
15+
16+
| Output Name | Data Type | Description |
17+
|-------------|-----------|-------------|
18+
| `model` | MODEL | Returns the modified model with adaptive projected guidance applied to its sampling process |
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/es.md)
2+
3+
El nodo APG (Adaptive Projected Guidance) modifica el proceso de muestreo ajustando cómo se aplica la guía durante la difusión. Separa el vector de guía en componentes paralelos y ortogonales en relación con la salida condicional, permitiendo una generación de imágenes más controlada. El nodo proporciona parámetros para escalar la guía, normalizar su magnitud y aplicar momentum para transiciones más suaves entre los pasos de difusión.
4+
5+
## Entradas
6+
7+
| Parámetro | Tipo de Dato | Tipo de Entrada | Por Defecto | Rango | Descripción |
8+
|-----------|-----------|------------|---------|-------|-------------|
9+
| `model` | MODEL | Requerido | - | - | El modelo de difusión al que aplicar la guía proyectada adaptativa |
10+
| `eta` | FLOAT | Requerido | 1.0 | -10.0 a 10.0 | Controla la escala del vector de guía paralelo. El comportamiento CFG por defecto se obtiene con un valor de 1. |
11+
| `norm_threshold` | FLOAT | Requerido | 5.0 | 0.0 a 50.0 | Normaliza el vector de guía a este valor, la normalización se desactiva con un valor de 0. |
12+
| `momentum` | FLOAT | Requerido | 0.0 | -5.0 a 1.0 | Controla un promedio móvil de la guía durante la difusión, se desactiva con un valor de 0. |
13+
14+
## Salidas
15+
16+
| Nombre de Salida | Tipo de Dato | Descripción |
17+
|-------------|-----------|-------------|
18+
| `model` | MODEL | Devuelve el modelo modificado con la guía proyectada adaptativa aplicada a su proceso de muestreo |
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
> Cette documentation a été générée par IA. Si vous trouvez des erreurs ou avez des suggestions d'amélioration, n'hésitez pas à contribuer ! [Modifier sur GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/fr.md)
2+
3+
Le nœud APG (Adaptive Projected Guidance - Guidage Projeté Adaptatif) modifie le processus d'échantillonnage en ajustant la manière dont le guidage est appliqué pendant la diffusion. Il sépare le vecteur de guidage en composantes parallèles et orthogonales par rapport à la sortie conditionnelle, permettant une génération d'image plus contrôlée. Le nœud fournit des paramètres pour mettre à l'échelle le guidage, normaliser son amplitude et appliquer une quantité de mouvement pour des transitions plus fluides entre les étapes de diffusion.
4+
5+
## Entrées
6+
7+
| Paramètre | Type de données | Type d'entrée | Par défaut | Plage | Description |
8+
|-----------|-----------|------------|---------|-------|-------------|
9+
| `model` | MODEL | Requis | - | - | Le modèle de diffusion auquel appliquer le guidage projeté adaptatif |
10+
| `eta` | FLOAT | Requis | 1.0 | -10.0 à 10.0 | Contrôle l'échelle du vecteur de guidage parallèle. Comportement CFG par défaut avec une valeur de 1. |
11+
| `norm_threshold` | FLOAT | Requis | 5.0 | 0.0 à 50.0 | Normalise le vecteur de guidage à cette valeur, la normalisation est désactivée avec une valeur de 0. |
12+
| `momentum` | FLOAT | Requis | 0.0 | -5.0 à 1.0 | Contrôle une moyenne mobile du guidage pendant la diffusion, désactivé avec une valeur de 0. |
13+
14+
## Sorties
15+
16+
| Nom de la sortie | Type de données | Description |
17+
|-------------|-----------|-------------|
18+
| `model` | MODEL | Renvoie le modèle modifié avec le guidage projeté adaptatif appliqué à son processus d'échantillonnage |
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください! [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/ja.md)
2+
3+
APG(Adaptive Projected Guidance)ノードは、拡散過程でのガイダンスの適用方法を調整することで、サンプリングプロセスを変更します。このノードは、ガイダンスベクトルを条件付き出力に対する平行成分と直交成分に分離し、より制御された画像生成を可能にします。ガイダンスのスケーリング、大きさの正規化、および拡散ステップ間のより滑らかな遷移のためのモーメンタムの適用を制御するパラメータを提供します。
4+
5+
## 入力
6+
7+
| パラメータ | データ型 | 入力タイプ | デフォルト | 範囲 | 説明 |
8+
|-----------|-----------|------------|---------|-------|-------------|
9+
| `model` | MODEL | 必須 | - | - | 適応投影ガイダンスを適用する拡散モデル |
10+
| `eta` | FLOAT | 必須 | 1.0 | -10.0 から 10.0 | 平行ガイダンスベクトルのスケールを制御します。設定値1でデフォルトのCFG動作になります。 |
11+
| `norm_threshold` | FLOAT | 必須 | 5.0 | 0.0 から 50.0 | ガイダンスベクトルをこの値に正規化します。設定値0で正規化は無効になります。 |
12+
| `momentum` | FLOAT | 必須 | 0.0 | -5.0 から 1.0 | 拡散中のガイダンスの移動平均を制御します。設定値0で無効になります。 |
13+
14+
## 出力
15+
16+
| 出力名 | データ型 | 説明 |
17+
|-------------|-----------|-------------|
18+
| `model` | MODEL | サンプリングプロセスに適応投影ガイダンスが適用された変更済みモデルを返します |
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/ko.md)
2+
3+
APG(Adaptive Projected Guidance) 노드는 확산 과정 중 guidance가 적용되는 방식을 조정하여 샘플링 과정을 수정합니다. 이 노드는 조건부 출력에 대한 상대적인 평행 및 직교 구성 요소로 guidance 벡터를 분리하여 더욱 제어된 이미지 생성을 가능하게 합니다. 노드는 guidance의 크기를 조정하고, 그 강도를 정규화하며, 확산 단계 간의 부드러운 전환을 위해 모멘텀을 적용하는 매개변수를 제공합니다.
4+
5+
## 입력
6+
7+
| 매개변수 | 데이터 타입 | 입력 타입 | 기본값 | 범위 | 설명 |
8+
|-----------|-----------|------------|---------|-------|-------------|
9+
| `model` | MODEL | 필수 | - | - | 적응형 투영 guidance를 적용할 확산 모델 |
10+
| `eta` | FLOAT | 필수 | 1.0 | -10.0 ~ 10.0 | 평행 guidance 벡터의 크기를 제어합니다. 1로 설정 시 기본 CFG 동작입니다. |
11+
| `norm_threshold` | FLOAT | 필수 | 5.0 | 0.0 ~ 50.0 | guidance 벡터를 이 값으로 정규화합니다. 0으로 설정 시 정규화가 비활성화됩니다. |
12+
| `momentum` | FLOAT | 필수 | 0.0 | -5.0 ~ 1.0 | 확산 과정 중 guidance의 이동 평균을 제어합니다. 0으로 설정 시 비활성화됩니다. |
13+
14+
## 출력
15+
16+
| 출력 이름 | 데이터 타입 | 설명 |
17+
|-------------|-----------|-------------|
18+
| `model` | MODEL | 샘플링 과정에 적응형 투영 guidance가 적용된 수정된 모델을 반환합니다 |
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/ru.md)
2+
3+
Узел APG (Адаптивное Проекционное Управление) изменяет процесс сэмплирования, регулируя способ применения управляющих сигналов во время диффузии. Он разделяет вектор управления на параллельную и ортогональную составляющие относительно условного вывода, что позволяет более контролируемо генерировать изображения. Узел предоставляет параметры для масштабирования управляющего сигнала, нормализации его величины и применения импульса для более плавных переходов между шагами диффузии.
4+
5+
## Входы
6+
7+
| Параметр | Тип данных | Тип ввода | По умолчанию | Диапазон | Описание |
8+
|-----------|-----------|------------|---------|-------|-------------|
9+
| `model` | MODEL | Обязательный | - | - | Модель диффузии, к которой применяется адаптивное проекционное управление |
10+
| `eta` | FLOAT | Обязательный | 1.0 | -10.0 до 10.0 | Управляет масштабом параллельного вектора управления. Стандартное поведение CFG при значении 1. |
11+
| `norm_threshold` | FLOAT | Обязательный | 5.0 | 0.0 до 50.0 | Нормализует вектор управления до этого значения; нормализация отключается при значении 0. |
12+
| `momentum` | FLOAT | Обязательный | 0.0 | -5.0 до 1.0 | Управляет скользящим средним управляющего сигнала во время диффузии; отключается при значении 0. |
13+
14+
## Выходы
15+
16+
| Имя выхода | Тип данных | Описание |
17+
|-------------|-----------|-------------|
18+
| `model` | MODEL | Возвращает модифицированную модель с применённым адаптивным проекционным управлением к её процессу сэмплирования |
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
> 本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献![在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/APG/zh.md)
2+
3+
APG(自适应投影引导)节点通过调整扩散过程中引导应用的方式,来修改采样过程。它将引导向量分离为相对于条件输出的平行和正交分量,从而实现更可控的图像生成。该节点提供了用于缩放引导、归一化其幅度以及应用动量以实现扩散步骤间更平滑过渡的参数。
4+
5+
## 输入参数
6+
7+
| 参数 | 数据类型 | 输入类型 | 默认值 | 范围 | 描述 |
8+
|-----------|-----------|------------|---------|-------|-------------|
9+
| `model` | MODEL | 必选 | - | - | 要应用自适应投影引导的扩散模型 |
10+
| `eta` | FLOAT | 必选 | 1.0 | -10.0 到 10.0 | 控制平行引导向量的缩放比例。设置为 1 时为默认的 CFG 行为。 |
11+
| `norm_threshold` | FLOAT | 必选 | 5.0 | 0.0 到 50.0 | 将引导向量归一化到此值,设置为 0 时禁用归一化。 |
12+
| `momentum` | FLOAT | 必选 | 0.0 | -5.0 到 1.0 | 控制扩散过程中引导的滑动平均值,设置为 0 时禁用。 |
13+
14+
## 输出
15+
16+
| 输出名称 | 数据类型 | 描述 |
17+
|-------------|-----------|-------------|
18+
| `model` | MODEL | 返回已在其采样过程中应用了自适应投影引导的修改后模型 |
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AddNoise/en.md)
2+
3+
# AddNoise
4+
5+
This node adds controlled noise to a latent image using specified noise parameters and sigma values. It processes the input through the model's sampling system to apply noise scaling appropriate for the given sigma range.
6+
7+
## How It Works
8+
9+
The node takes a latent image and applies noise to it based on the provided noise generator and sigma values. It first checks if there are any sigmas provided - if not, it returns the original latent image unchanged. The node then uses the model's sampling system to process the latent image and apply scaled noise. The noise scaling is determined by the difference between the first and last sigma values when multiple sigmas are provided, or by the single sigma value when only one is available. Empty latent images (containing only zeros) are not shifted during processing. The final output is a new latent representation with the applied noise, with any NaN or infinite values converted to zeros for stability.
10+
11+
## Inputs
12+
13+
| Parameter | Data Type | Input Type | Default | Range | Description |
14+
|-----------|-----------|------------|---------|-------|-------------|
15+
| `model` | MODEL | Required | - | - | The model containing sampling parameters and processing functions |
16+
| `noise` | NOISE | Required | - | - | The noise generator that produces the base noise pattern |
17+
| `sigmas` | SIGMAS | Required | - | - | Sigma values controlling the noise scaling intensity |
18+
| `latent_image` | LATENT | Required | - | - | The input latent representation to which noise will be added |
19+
20+
## Outputs
21+
22+
| Output Name | Data Type | Description |
23+
|-------------|-----------|-------------|
24+
| `LATENT` | LATENT | The modified latent representation with added noise |
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/AddNoise/es.md)
2+
3+
# AddNoise
4+
5+
Este nodo agrega ruido controlado a una imagen latente utilizando parámetros de ruido específicos y valores sigma. Procesa la entrada a través del sistema de muestreo del modelo para aplicar una escala de ruido apropiada para el rango sigma dado.
6+
7+
## Cómo Funciona
8+
9+
El nodo toma una imagen latente y le aplica ruido basándose en el generador de ruido y los valores sigma proporcionados. Primero verifica si hay sigmas proporcionados; si no los hay, devuelve la imagen latente original sin cambios. Luego, el nodo utiliza el sistema de muestreo del modelo para procesar la imagen latente y aplicar ruido escalado. La escala del ruido está determinada por la diferencia entre el primer y el último valor sigma cuando se proporcionan múltiples sigmas, o por el valor sigma único cuando solo hay uno disponible. Las imágenes latentes vacías (que contienen solo ceros) no se desplazan durante el procesamiento. La salida final es una nueva representación latente con el ruido aplicado, donde cualquier valor NaN o infinito se convierte a ceros para garantizar estabilidad.
10+
11+
## Entradas
12+
13+
| Parámetro | Tipo de Dato | Tipo de Entrada | Por Defecto | Rango | Descripción |
14+
|-----------|-----------|------------|---------|-------|-------------|
15+
| `modelo` | MODEL | Requerido | - | - | El modelo que contiene los parámetros de muestreo y las funciones de procesamiento |
16+
| `ruido` | NOISE | Requerido | - | - | El generador de ruido que produce el patrón de ruido base |
17+
| `sigmas` | SIGMAS | Requerido | - | - | Valores sigma que controlan la intensidad de la escala de ruido |
18+
| `imagen_latente` | LATENT | Requerido | - | - | La representación latente de entrada a la que se le agregará ruido |
19+
20+
## Salidas
21+
22+
| Nombre de Salida | Tipo de Dato | Descripción |
23+
|-------------|-----------|-------------|
24+
| `LATENT` | LATENT | La representación latente modificada con ruido agregado |

0 commit comments

Comments
 (0)