comfyui-embedded-docs 0.5.3__tar.gz → 0.5.4__tar.gz

comfyui_embedded_docs-0.5.4/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: comfyui-embedded-docs
+Version: 0.5.4
+Summary: Embedded documentation for ComfyUI nodes
+Author: Comfy-Org
+License-Expression: GPL-3.0
+Project-URL: repository, https://github.com/Comfy-Org/embedded-docs
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# comfyui_embedded_docs
+
+> [!NOTE]
+> This is only for core nodes. For embedded custom node documentation, please see <https://docs.comfy.org/custom-nodes/help_page>
+
+## Updating Documentation
+
+Each core node should have a folder containing its node name, then a two letter locale.md, and potentially any assets along with it in the same folder.
+
+See [FluxProUltraImageNode](https://github.com/Comfy-Org/embedded-docs/tree/main/docs/FluxProUltraImageNode) as an example.
+
+> [!NOTE]
+> A fallback is simply docs/NodeName.md, but this is discouraged.
+
+## Previewing Changes Locally
+
+To preview your documentation changes in ComfyUI:
+
+1. **Install editable version (optional but recommended):**
+
+   ```bash
+   # If you have one, activate your ComfyUI virtual environment first
+   pip uninstall comfyui-embedded-docs  # Remove existing PyPI version
+   pip install -e /path/to/embedded-docs/  # Install editable version
+   ```
+
+2. **Launch and preview:**
+   - Start ComfyUI
+   - Refresh the frontend tab after making documentation changes
+
+> [!TIP]
+> The editable installation allows you to see changes immediately after copying files, without reinstalling the package.
+
+## Publishing
+
+The package is automatically published to PyPI when:
+
+1. You manually trigger the workflow (Actions → Publish to PyPI → Run workflow)
+2. You push changes to `pyproject.toml` on the main branch
+3. A pull request that modifies `pyproject.toml` is merged to main
+
+The publishing workflow:
+
+1. Builds the package using `python -m build`
+2. Publishes to PyPI using the configured PYPI_TOKEN secret
+
+## Syncing to Comfy docs
+
+The script `doc_automation/sync_to_comfy_docs.py` syncs embedded-docs (en.md, zh.md, and assets) to the [comfy/docs](https://github.com/Comfy-Org/comfy/tree/main/docs) repository as built-in node MDX files and updates the navigation (`docs.json`).
+
+**Environment variables (optional):**
+
+- `EMBEDDED_DOCS_PATH` – Path to this repo (default: parent of `doc_automation`)
+- `COMFYUI_PATH` – Path to the ComfyUI repo (used to read node category from source)
+- `TARGET_DOCS` – Path to the comfy/docs root (e.g. `/path/to/comfy/docs`)
+
+**Category mapping:** The sync script uses each node’s ComfyUI category to put it in the right docs.json group. For the most complete categories (including API nodes and nodes that get category from a base class), run the node scanner once so it can write `doc_automation/all_nodes_info.json`; the sync script will prefer that file when present.
+
+```sh
+# Optional: run scanner first to build all_nodes_info.json (better category coverage)
+python doc_automation/scan_missing_nodes.py
+```
+
+**Run from repo root:**
+
+```sh
+# Test mode: sync first 10 nodes (dry run: no writes)
+python doc_automation/sync_to_comfy_docs.py --mode test --count 10 --dry-run
+
+# Sync all nodes with en.md and update docs.json
+python doc_automation/sync_to_comfy_docs.py --mode all
+
+# Sync a single node
+python doc_automation/sync_to_comfy_docs.py --node Load3D
+```
+
+You can also use the interactive menu: run `python doc_automation/main.py` and choose option **5) 同步到 Comfy 文档 (Sync to Comfy docs)**.
+
+## Linting
+
+To ensure minimal consistency across nodes documentation, it is recommended to follow the Markdown linting principles. Some of the linting issues can be fixed automatically with the shell script below. Note this requires to install `markdownlint-cli`.
+
+```sh
+# Install markdownlint-cli
+# If you encounter the error npm.ps1 cannot be loaded because running scripts is disabled on this system
+# Run this command: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
+npm install -g markdownlint-cli
+
+# Fix linting issues in all markdown files under docs directory，using shell script (Linux)
+bash fix_markdown.sh
+
+# Fix linting issues for a specific node's documentation
+bash fix_markdown.sh ClipLoader  # This will only check files in comfyui_embedded_docs/docs/ClipLoader/
+
+# Or fix linting issues in markdown files, using powershell script (Windows)
+powershell -ExecutionPolicy Bypass -File fix_markdown.ps1
+```

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BeebleSwitchXImageEdit/en.md

@@ -0,0 +1,28 @@
+# Beeble SwitchX Image Edit
+
+Edit a single image with Beeble SwitchX. This node can switch anything in the scene (background, lighting, costume) while preserving the original subject's pixels. Provide a reference image and/or text prompt to describe the new look. Maximum resolution is approximately 2.77 megapixels.
+
+## Inputs
+
+| Parameter | Description | Data Type | Required | Range |
+|-----------|-------------|-----------|----------|-------|
+| `image` | The source image to edit. | IMAGE | Yes | - |
+| `prompt` | A text description of the desired new look (e.g., "a knight in shining armor"). | STRING | Yes | - |
+| `alpha_mode` | How to handle the alpha matte. "select" uses a keyframe to select the subject, "fill" replaces the entire image without a separate matte, "custom" uses a user-provided mask. | COMBO | Yes | `"select"`<br>`"fill"`<br>`"custom"` |
+| `max_resolution` | The maximum resolution for the output image. Higher resolution costs more credits. | COMBO | Yes | `"1080p"`<br>`"720p"` |
+| `seed` | A seed value for reproducibility. | INT | Yes | - |
+| `reference_image` | An optional reference image to guide the style or appearance of the new scene elements. | IMAGE | No | - |
+
+**Note on `alpha_mode`:** When `alpha_mode` is set to `"select"`, you must also provide an `alpha_keyframe` (a keyframe image used to select the subject). When set to `"custom"`, you must provide an `alpha_mask` (a user-created mask). When set to `"fill"`, no alpha input is needed.
+
+## Outputs
+
+| Output Name | Description | Data Type |
+|-------------|-------------|-----------|
+| `image` | The edited image with the scene elements switched. | IMAGE |
+| `alpha` | The alpha matte used by Beeble. Empty for "fill" mode, which has no separate matte. | MASK |
+
+> 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/BeebleSwitchXImageEdit/en.md)
+
+---
+**Source fingerprint (SHA-256):** `6fd10dff6ac4f1a15fd05de7a6ff6eda988e60dd4ef32bc8c792480fbbf0c92b`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BeebleSwitchXVideoEdit/en.md

@@ -0,0 +1,36 @@
+# Beeble SwitchX Video Edit
+
+Edit a video with Beeble SwitchX. This node can switch anything in the scene (background, lighting, costume) while preserving the original subject's pixels and motion. Provide a reference image and/or text prompt to describe the new look. Maximum 240 frames, maximum approximately 2.77 megapixels per frame.
+
+## Inputs
+
+| Parameter | Description | Data Type | Required | Range |
+|-----------|-------------|-----------|----------|-------|
+| `video` | The input video to edit. | VIDEO | Yes | N/A |
+| `prompt` | A text description of the desired new look for the scene. | STRING | Yes | N/A |
+| `alpha_mode` | The alpha matte mode. "fill" mode has no separate matte and fills the entire frame. "select" mode uses a single keyframe image to define the area to edit. "custom" mode uses a full alpha video to define the area to edit frame by frame. | COMBO | Yes | `"fill"`<br>`"select"`<br>`"custom"` |
+| `max_resolution` | The maximum resolution for the output video (default: "1080p"). | COMBO | Yes | `"720p"`<br>`"1080p"` |
+| `seed` | A seed value for reproducibility. Using the same seed with the same inputs will produce the same result. | INT | Yes | 0 to 2147483647 |
+| `reference_image` | An optional reference image that describes the desired new look for the scene. | IMAGE | No | N/A |
+
+### Alpha Mode Details
+
+The `alpha_mode` parameter controls which parts of the video are edited:
+
+- **fill**: The entire video frame is edited. No separate alpha matte is produced.
+- **select**: You provide a single keyframe image that defines the area to edit. The node will use this to determine which parts of the video to change.
+- **custom**: You provide a full alpha video that defines the area to edit frame by frame. This gives you precise control over which parts of each frame are edited.
+
+When using `select` mode, you must provide the `alpha_keyframe` image. When using `custom` mode, you must provide the `alpha_mask` video.
+
+## Outputs
+
+| Output Name | Description | Data Type |
+|-------------|-------------|-----------|
+| `video` | The edited video with the scene changes applied. | VIDEO |
+| `alpha` | The alpha matte used by Beeble. This is empty for "fill" mode, which has no separate matte. | VIDEO |
+
+> 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/BeebleSwitchXVideoEdit/en.md)
+
+---
+**Source fingerprint (SHA-256):** `a92e78e6a08ac01466d953562a250b812eb8b1a5fb37efce6fddd7aa1ef380a2`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/ar.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+تقوم عقدة BerniniConditioning بإعداد بيانات التكييف الخاصة بالفيديو والصورة لنموذج Wan2.2-A14B. تقوم بتشفير مقاطع الفيديو المصدر، ومقاطع الفيديو المرجعية، والصور المرجعية باستخدام VAE المقدم، ثم تُرفقها ببيانات التكييف لمهام التوليد السياقي.
+
+## المدخلات
+
+| المعامل | الوصف | نوع البيانات | مطلوب | النطاق |
+|---------|-------|---------------|--------|--------|
+| `positive` | بيانات التكييف الإيجابي | CONDITIONING | نعم | - |
+| `negative` | بيانات التكييف السلبي | CONDITIONING | نعم | - |
+| `vae` | نموذج VAE المستخدم لتشفير مدخلات الفيديو والصورة | VAE | نعم | - |
+| `width` | عرض الكمون الناتج (الافتراضي: 832) | INT | نعم | 16 إلى 8192 (الخطوة: 16) |
+| `height` | ارتفاع الكمون الناتج (الافتراضي: 480) | INT | نعم | 16 إلى 8192 (الخطوة: 16) |
+| `length` | عدد الإطارات في الكمون الناتج (الافتراضي: 81) | INT | نعم | 1 إلى 8192 (الخطوة: 4) |
+| `batch_size` | عدد مقاطع الفيديو المطلوب توليدها في دفعة واحدة (الافتراضي: 1) | INT | نعم | 1 إلى 4096 |
+| `source_video` | الفيديو المصدر المراد تحريره أو إعادة تصميمه (v2v, rv2v). يتم تغيير حجمه إلى العرض/الارتفاع وقصّه إلى الطول المحدد. | IMAGE | لا | - |
+| `reference_video` | الفيديو المراد إدراجه في الفيديو المصدر (ads2v). | IMAGE | لا | - |
+| `reference_images` | الصور المرجعية المحقونة كرموز سياقية (r2v, rv2v). يمكن توفير ما يصل إلى 8 صور. | IMAGE | لا | 0 إلى 8 صور |
+| `ref_max_size` | الحد الأقصى لحجم الحافة الطويلة للفيديو المرجعي والصور المرجعية. يتم تغيير الحجم مع الحفاظ على نسبة العرض إلى الارتفاع وتثبيته عند 16 بكسل (الافتراضي: 848). | INT | لا | 16 إلى 8192 (الخطوة: 16) |
+
+**ملاحظة:** يتم استنتاج المهمة من المدخلات المتصلة:
+- عدم توصيل أي مدخلات → نص إلى فيديو (t2v)
+- توصيل `source_video` فقط → فيديو إلى فيديو (v2v)
+- توصيل `source_video` + `reference_images` → تحرير فيديو موجه بالمرجع (rv2v)
+- توصيل `reference_images` فقط → مرجع إلى فيديو (r2v)
+- توصيل `source_video` + `reference_video` → إدراج صورة/فيديو داخل فيديو (ads2v)
+
+## المخرجات
+
+| اسم المخرج | الوصف | نوع البيانات |
+|------------|-------|---------------|
+| `positive` | التكييف الإيجابي مع الكمونات السياقية المرفقة | CONDITIONING |
+| `negative` | التكييف السلبي مع الكمونات السياقية المرفقة | CONDITIONING |
+| `latent` | موتر كمون فارغ بأبعاد تطابق العرض والارتفاع والطول وحجم الدفعة المحددة | LATENT |
+
+> تم إنشاء هذه الوثيقة بواسطة الذكاء الاصطناعي. إذا وجدت أي أخطاء أو لديك اقتراحات للتحسين، فلا تتردد في المساهمة! [تحرير على GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/ar.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/en.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+The BerniniConditioning node prepares video and image conditioning data for the Wan2.2-A14B model. It encodes source videos, reference videos, and reference images using the provided VAE, then attaches them to the conditioning data for in-context generation tasks. The task is automatically inferred from which inputs are connected.
+
+## Inputs
+
+| Parameter | Description | Data Type | Required | Range |
+|-----------|-------------|-----------|----------|-------|
+| `positive` | Positive conditioning data | CONDITIONING | Yes | - |
+| `negative` | Negative conditioning data | CONDITIONING | Yes | - |
+| `vae` | VAE model used to encode video and image inputs | VAE | Yes | - |
+| `width` | Width of the output latent (default: 832) | INT | Yes | 16 to 8192 (step: 16) |
+| `height` | Height of the output latent (default: 480) | INT | Yes | 16 to 8192 (step: 16) |
+| `length` | Number of frames in the output latent (default: 81) | INT | Yes | 1 to 8192 (step: 4) |
+| `batch_size` | Number of videos to generate in a single batch (default: 1) | INT | Yes | 1 to 4096 |
+| `source_video` | Source video to edit or restyle (v2v, rv2v). Resized to width/height and trimmed to length. | IMAGE | No | - |
+| `reference_video` | Video to insert into the source video (ads2v). | IMAGE | No | - |
+| `reference_images` | Reference images injected as in-context tokens (r2v, rv2v). Up to 8 images can be provided. | IMAGE | No | 0 to 8 images |
+| `ref_max_size` | Max size for the long edge of reference_video and reference_images. Resized with preserved aspect ratio and snapped to 16px (default: 848). | INT | No | 16 to 8192 (step: 16) |
+
+**Note:** The task is inferred from which inputs are connected:
+- No inputs connected → text-to-video (t2v)
+- `source_video` only → video-to-video (v2v)
+- `source_video` + `reference_images` → reference-guided video editing (rv2v)
+- `reference_images` only → reference-to-video (r2v)
+- `source_video` + `reference_video` → insert image/video into video (ads2v)
+
+## Outputs
+
+| Output Name | Description | Data Type |
+|-------------|-------------|-----------|
+| `positive` | Positive conditioning with context latents attached | CONDITIONING |
+| `negative` | Negative conditioning with context latents attached | CONDITIONING |
+| `latent` | Empty latent tensor with dimensions matching the specified width, height, length, and batch size | LATENT |
+
+> 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/BerniniConditioning/en.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/es.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+El nodo BerniniConditioning prepara datos de condicionamiento de video e imagen para el modelo Wan2.2-A14B. Codifica videos fuente, videos de referencia e imágenes de referencia utilizando el VAE proporcionado, y luego los adjunta a los datos de condicionamiento para tareas de generación en contexto.
+
+## Entradas
+
+| Parámetro | Descripción | Tipo de Dato | Requerido | Rango |
+|-----------|-------------|--------------|-----------|-------|
+| `positive` | Datos de condicionamiento positivo | CONDITIONING | Sí | - |
+| `negative` | Datos de condicionamiento negativo | CONDITIONING | Sí | - |
+| `vae` | Modelo VAE utilizado para codificar entradas de video e imagen | VAE | Sí | - |
+| `width` | Ancho del latente de salida (predeterminado: 832) | INT | Sí | 16 a 8192 (paso: 16) |
+| `height` | Alto del latente de salida (predeterminado: 480) | INT | Sí | 16 a 8192 (paso: 16) |
+| `length` | Número de fotogramas en el latente de salida (predeterminado: 81) | INT | Sí | 1 a 8192 (paso: 4) |
+| `batch_size` | Número de videos a generar en un solo lote (predeterminado: 1) | INT | Sí | 1 a 4096 |
+| `source_video` | Video fuente para editar o cambiar el estilo (v2v, rv2v). Redimensionado al ancho/alto y recortado a la longitud especificada. | IMAGE | No | - |
+| `reference_video` | Video para insertar en el video fuente (ads2v). | IMAGE | No | - |
+| `reference_images` | Imágenes de referencia inyectadas como tokens de contexto (r2v, rv2v). Se pueden proporcionar hasta 8 imágenes. | IMAGE | No | 0 a 8 imágenes |
+| `ref_max_size` | Tamaño máximo para el borde largo de reference_video y reference_images. Redimensionado manteniendo la relación de aspecto y ajustado a 16px (predeterminado: 848). | INT | No | 16 a 8192 (paso: 16) |
+
+**Nota:** La tarea se infiere según qué entradas están conectadas:
+- Sin entradas conectadas → texto a video (t2v)
+- Solo `source_video` → video a video (v2v)
+- `source_video` + `reference_images` → edición de video guiada por referencia (rv2v)
+- Solo `reference_images` → referencia a video (r2v)
+- `source_video` + `reference_video` → insertar imagen/video en video (ads2v)
+
+## Salidas
+
+| Nombre de Salida | Descripción | Tipo de Dato |
+|------------------|-------------|--------------|
+| `positive` | Condicionamiento positivo con latentes de contexto adjuntos | CONDITIONING |
+| `negative` | Condicionamiento negativo con latentes de contexto adjuntos | CONDITIONING |
+| `latent` | Tensor latente vacío con dimensiones que coinciden con el ancho, alto, longitud y tamaño de lote especificados | LATENT |
+
+> 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/BerniniConditioning/es.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/fa.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+گره BerniniConditioning داده‌های شرطی‌سازی ویدیو و تصویر را برای مدل Wan2.2-A14B آماده می‌کند. این گره ویدیوهای منبع، ویدیوهای مرجع و تصاویر مرجع را با استفاده از VAE ارائه‌شده رمزگذاری کرده، سپس آن‌ها را برای وظایف تولید درون‌بافتی به داده‌های شرطی‌سازی متصل می‌کند.
+
+## ورودی‌ها
+
+| پارامتر | توضیحات | نوع داده | ضروری | محدوده |
+|---------|---------|----------|-------|--------|
+| `positive` | داده‌های شرطی‌سازی مثبت | CONDITIONING | بله | - |
+| `negative` | داده‌های شرطی‌سازی منفی | CONDITIONING | بله | - |
+| `vae` | مدل VAE مورد استفاده برای رمزگذاری ورودی‌های ویدیو و تصویر | VAE | بله | - |
+| `width` | عرض خروجی نهفته (پیش‌فرض: 832) | INT | بله | 16 تا 8192 (گام: 16) |
+| `height` | ارتفاع خروجی نهفته (پیش‌فرض: 480) | INT | بله | 16 تا 8192 (گام: 16) |
+| `length` | تعداد فریم‌های خروجی نهفته (پیش‌فرض: 81) | INT | بله | 1 تا 8192 (گام: 4) |
+| `batch_size` | تعداد ویدیوهای تولیدشده در یک دسته (پیش‌فرض: 1) | INT | بله | 1 تا 4096 |
+| `source_video` | ویدیوی منبع برای ویرایش یا تغییر سبک (v2v, rv2v). به اندازه عرض/ارتفاع تغییر اندازه داده و به طول مشخص شده برش می‌خورد. | IMAGE | خیر | - |
+| `reference_video` | ویدیویی که در ویدیوی منبع درج می‌شود (ads2v). | IMAGE | خیر | - |
+| `reference_images` | تصاویر مرجع که به‌عنوان توکن‌های درون‌بافتی تزریق می‌شوند (r2v, rv2v). حداکثر 8 تصویر قابل ارائه است. | IMAGE | خیر | 0 تا 8 تصویر |
+| `ref_max_size` | حداکثر اندازه برای لبه بلند reference_video و reference_images. با حفظ نسبت ابعاد تغییر اندازه داده و به 16 پیکسل گرد می‌شود (پیش‌فرض: 848). | INT | خیر | 16 تا 8192 (گام: 16) |
+
+**نکته:** وظیفه بر اساس ورودی‌های متصل تعیین می‌شود:
+- بدون ورودی متصل → متن به ویدیو (t2v)
+- فقط `source_video` → ویدیو به ویدیو (v2v)
+- `source_video` + `reference_images` → ویرایش ویدیوی راهنمایی‌شده با مرجع (rv2v)
+- فقط `reference_images` → مرجع به ویدیو (r2v)
+- `source_video` + `reference_video` → درج تصویر/ویدیو در ویدیو (ads2v)
+
+## خروجی‌ها
+
+| نام خروجی | توضیحات | نوع داده |
+|-----------|---------|----------|
+| `positive` | شرطی‌سازی مثبت با نهفته‌های بافتی متصل | CONDITIONING |
+| `negative` | شرطی‌سازی منفی با نهفته‌های بافتی متصل | CONDITIONING |
+| `latent` | تنسور نهفته خالی با ابعاد منطبق با عرض، ارتفاع، طول و اندازه دسته مشخص‌شده | LATENT |
+
+> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/fa.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/fr.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+Le nœud BerniniConditioning prépare les données de conditionnement vidéo et image pour le modèle Wan2.2-A14B. Il encode les vidéos sources, les vidéos de référence et les images de référence à l'aide du VAE fourni, puis les attache aux données de conditionnement pour des tâches de génération en contexte.
+
+## Entrées
+
+| Paramètre | Description | Type de données | Requis | Plage |
+|-----------|-------------|-----------------|--------|-------|
+| `positive` | Données de conditionnement positives | CONDITIONING | Oui | - |
+| `negative` | Données de conditionnement négatives | CONDITIONING | Oui | - |
+| `vae` | Modèle VAE utilisé pour encoder les entrées vidéo et image | VAE | Oui | - |
+| `width` | Largeur du latent de sortie (par défaut : 832) | INT | Oui | 16 à 8192 (pas : 16) |
+| `height` | Hauteur du latent de sortie (par défaut : 480) | INT | Oui | 16 à 8192 (pas : 16) |
+| `length` | Nombre d'images dans le latent de sortie (par défaut : 81) | INT | Oui | 1 à 8192 (pas : 4) |
+| `batch_size` | Nombre de vidéos à générer en un seul lot (par défaut : 1) | INT | Oui | 1 à 4096 |
+| `source_video` | Vidéo source à éditer ou restyler (v2v, rv2v). Redimensionnée à la largeur/hauteur et ajustée à la longueur. | IMAGE | Non | - |
+| `reference_video` | Vidéo à insérer dans la vidéo source (ads2v). | IMAGE | Non | - |
+| `reference_images` | Images de référence injectées comme jetons en contexte (r2v, rv2v). Jusqu'à 8 images peuvent être fournies. | IMAGE | Non | 0 à 8 images |
+| `ref_max_size` | Taille maximale pour le bord long de reference_video et reference_images. Redimensionné avec conservation du rapport hauteur/largeur et ajusté à 16px (par défaut : 848). | INT | Non | 16 à 8192 (pas : 16) |
+
+**Remarque :** La tâche est déduite des entrées connectées :
+- Aucune entrée connectée → texte-vers-vidéo (t2v)
+- `source_video` uniquement → vidéo-vers-vidéo (v2v)
+- `source_video` + `reference_images` → édition vidéo guidée par référence (rv2v)
+- `reference_images` uniquement → référence-vers-vidéo (r2v)
+- `source_video` + `reference_video` → insertion d'image/vidéo dans une vidéo (ads2v)
+
+## Sorties
+
+| Nom de sortie | Description | Type de données |
+|---------------|-------------|-----------------|
+| `positive` | Conditionnement positif avec latents de contexte attachés | CONDITIONING |
+| `negative` | Conditionnement négatif avec latents de contexte attachés | CONDITIONING |
+| `latent` | Tenseur latent vide dont les dimensions correspondent à la largeur, hauteur, longueur et taille de lot spécifiées | LATENT |
+
+> 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/BerniniConditioning/fr.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/ja.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+BerniniConditioningノードは、Wan2.2-A14Bモデル用の動画および画像の条件付けデータを準備します。提供されたVAEを使用してソース動画、参照動画、参照画像をエンコードし、それらを条件付けデータに付加して、インコンテキスト生成タスクを実行します。
+
+## 入力
+
+| パラメータ | 説明 | データ型 | 必須 | 範囲 |
+|-----------|-------------|-----------|----------|-------|
+| `positive` | ポジティブ条件付けデータ | CONDITIONING | はい | - |
+| `negative` | ネガティブ条件付けデータ | CONDITIONING | はい | - |
+| `vae` | 動画および画像入力をエンコードするために使用するVAEモデル | VAE | はい | - |
+| `width` | 出力潜在変数の幅（デフォルト: 832） | INT | はい | 16～8192（ステップ: 16） |
+| `height` | 出力潜在変数の高さ（デフォルト: 480） | INT | はい | 16～8192（ステップ: 16） |
+| `length` | 出力潜在変数のフレーム数（デフォルト: 81） | INT | はい | 1～8192（ステップ: 4） |
+| `batch_size` | 1バッチで生成する動画の数（デフォルト: 1） | INT | はい | 1～4096 |
+| `source_video` | 編集またはリスタイルするソース動画（v2v、rv2v）。幅/高さにリサイズされ、長さにトリミングされます。 | IMAGE | いいえ | - |
+| `reference_video` | ソース動画に挿入する動画（ads2v）。 | IMAGE | いいえ | - |
+| `reference_images` | インコンテキストトークンとして注入される参照画像（r2v、rv2v）。最大8枚の画像を指定できます。 | IMAGE | いいえ | 0～8枚の画像 |
+| `ref_max_size` | reference_videoおよびreference_imagesの長辺の最大サイズ。アスペクト比を維持してリサイズされ、16pxにスナップされます（デフォルト: 848）。 | INT | いいえ | 16～8192（ステップ: 16） |
+
+**注記:** タスクは、どの入力が接続されているかから推論されます：
+- 入力が接続されていない場合 → テキストから動画へ（t2v）
+- `source_video`のみの場合 → 動画から動画へ（v2v）
+- `source_video` + `reference_images`の場合 → 参照ガイド付き動画編集（rv2v）
+- `reference_images`のみの場合 → 参照から動画へ（r2v）
+- `source_video` + `reference_video`の場合 → 画像/動画を動画に挿入（ads2v）
+
+## 出力
+
+| 出力名 | 説明 | データ型 |
+|-------------|-------------|-----------|
+| `positive` | コンテキスト潜在変数が付加されたポジティブ条件付けデータ | CONDITIONING |
+| `negative` | コンテキスト潜在変数が付加されたネガティブ条件付けデータ | CONDITIONING |
+| `latent` | 指定された幅、高さ、長さ、バッチサイズに一致する次元を持つ空の潜在テンソル | LATENT |
+
+> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/ja.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/ko.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+BerniniConditioning 노드는 Wan2.2-A14B 모델을 위한 비디오 및 이미지 컨디셔닝 데이터를 준비합니다. 제공된 VAE를 사용하여 소스 비디오, 참조 비디오 및 참조 이미지를 인코딩한 후, 이를 컨텍스트 내 생성 작업을 위한 컨디셔닝 데이터에 첨부합니다.
+
+## 입력
+
+| 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 |
+|-----------|-------------|-----------|----------|-------|
+| `positive` | 긍정 컨디셔닝 데이터 | CONDITIONING | 예 | - |
+| `negative` | 부정 컨디셔닝 데이터 | CONDITIONING | 예 | - |
+| `vae` | 비디오 및 이미지 입력을 인코딩하는 데 사용되는 VAE 모델 | VAE | 예 | - |
+| `width` | 출력 잠재 변수의 너비(기본값: 832) | INT | 예 | 16 ~ 8192 (단위: 16) |
+| `height` | 출력 잠재 변수의 높이(기본값: 480) | INT | 예 | 16 ~ 8192 (단위: 16) |
+| `length` | 출력 잠재 변수의 프레임 수(기본값: 81) | INT | 예 | 1 ~ 8192 (단위: 4) |
+| `batch_size` | 단일 배치에서 생성할 비디오 수(기본값: 1) | INT | 예 | 1 ~ 4096 |
+| `source_video` | 편집 또는 스타일 변경할 소스 비디오(v2v, rv2v). 너비/높이로 크기 조정되고 길이에 맞게 잘립니다. | IMAGE | 아니요 | - |
+| `reference_video` | 소스 비디오에 삽입할 비디오(ads2v). | IMAGE | 아니요 | - |
+| `reference_images` | 컨텍스트 내 토큰으로 주입되는 참조 이미지(r2v, rv2v). 최대 8개의 이미지를 제공할 수 있습니다. | IMAGE | 아니요 | 0 ~ 8개 이미지 |
+| `ref_max_size` | reference_video 및 reference_images의 긴 쪽 최대 크기. 종횡비를 유지하며 크기 조정되고 16px 단위로 맞춰집니다(기본값: 848). | INT | 아니요 | 16 ~ 8192 (단위: 16) |
+
+**참고:** 작업은 어떤 입력이 연결되었는지에 따라 결정됩니다:
+- 연결된 입력 없음 → 텍스트-투-비디오 (t2v)
+- `source_video`만 연결됨 → 비디오-투-비디오 (v2v)
+- `source_video` + `reference_images` → 참조 기반 비디오 편집 (rv2v)
+- `reference_images`만 연결됨 → 참조-투-비디오 (r2v)
+- `source_video` + `reference_video` → 비디오에 이미지/비디오 삽입 (ads2v)
+
+## 출력
+
+| 출력 이름 | 설명 | 데이터 타입 |
+|-------------|-------------|-----------|
+| `positive` | 컨텍스트 잠재 변수가 첨부된 긍정 컨디셔닝 | CONDITIONING |
+| `negative` | 컨텍스트 잠재 변수가 첨부된 부정 컨디셔닝 | CONDITIONING |
+| `latent` | 지정된 너비, 높이, 길이 및 배치 크기와 일치하는 차원의 빈 잠재 변수 텐서 | LATENT |
+
+> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/ko.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/pt-BR.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+O nó BerniniConditioning prepara dados de condicionamento de vídeo e imagem para o modelo Wan2.2-A14B. Ele codifica vídeos fonte, vídeos de referência e imagens de referência usando o VAE fornecido, em seguida os anexa aos dados de condicionamento para tarefas de geração em contexto.
+
+## Entradas
+
+| Parâmetro | Descrição | Tipo de Dado | Obrigatório | Faixa |
+|-----------|-------------|-----------|----------|-------|
+| `positive` | Dados de condicionamento positivo | CONDITIONING | Sim | - |
+| `negative` | Dados de condicionamento negativo | CONDITIONING | Sim | - |
+| `vae` | Modelo VAE usado para codificar entradas de vídeo e imagem | VAE | Sim | - |
+| `width` | Largura do latente de saída (padrão: 832) | INT | Sim | 16 a 8192 (passo: 16) |
+| `height` | Altura do latente de saída (padrão: 480) | INT | Sim | 16 a 8192 (passo: 16) |
+| `length` | Número de quadros no latente de saída (padrão: 81) | INT | Sim | 1 a 8192 (passo: 4) |
+| `batch_size` | Número de vídeos a serem gerados em um único lote (padrão: 1) | INT | Sim | 1 a 4096 |
+| `source_video` | Vídeo fonte para editar ou reestilizar (v2v, rv2v). Redimensionado para largura/altura e cortado para o comprimento especificado. | IMAGE | Não | - |
+| `reference_video` | Vídeo a ser inserido no vídeo fonte (ads2v). | IMAGE | Não | - |
+| `reference_images` | Imagens de referência injetadas como tokens em contexto (r2v, rv2v). Até 8 imagens podem ser fornecidas. | IMAGE | Não | 0 a 8 imagens |
+| `ref_max_size` | Tamanho máximo para a borda longa do vídeo de referência e imagens de referência. Redimensionado com proporção preservada e ajustado para 16px (padrão: 848). | INT | Não | 16 a 8192 (passo: 16) |
+
+**Observação:** A tarefa é inferida a partir de quais entradas estão conectadas:
+- Nenhuma entrada conectada → texto-para-vídeo (t2v)
+- Apenas `source_video` → vídeo-para-vídeo (v2v)
+- `source_video` + `reference_images` → edição de vídeo guiada por referência (rv2v)
+- Apenas `reference_images` → referência-para-vídeo (r2v)
+- `source_video` + `reference_video` → inserir imagem/vídeo em vídeo (ads2v)
+
+## Saídas
+
+| Nome da Saída | Descrição | Tipo de Dado |
+|-------------|-------------|-----------|
+| `positive` | Condicionamento positivo com latentes de contexto anexados | CONDITIONING |
+| `negative` | Condicionamento negativo com latentes de contexto anexados | CONDITIONING |
+| `latent` | Tensor latente vazio com dimensões correspondentes à largura, altura, comprimento e tamanho do lote especificados | LATENT |
+
+> Esta documentação foi gerada por IA. Se você encontrar erros ou tiver sugestões de melhoria, sinta-se à vontade para contribuir! [Editar no GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/pt-BR.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/ru.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+Узел BerniniConditioning подготавливает данные видеосостояния и изображений для модели Wan2.2-A14B. Он кодирует исходные видео, эталонные видео и эталонные изображения с помощью указанного VAE, после чего присоединяет их к данным состояния для задач контекстной генерации.
+
+## Входные параметры
+
+| Параметр | Описание | Тип данных | Обязательный | Диапазон |
+|----------|----------|------------|--------------|----------|
+| `positive` | Положительные данные состояния | CONDITIONING | Да | - |
+| `negative` | Отрицательные данные состояния | CONDITIONING | Да | - |
+| `vae` | Модель VAE для кодирования видео и изображений | VAE | Да | - |
+| `width` | Ширина выходного латентного представления (по умолчанию: 832) | INT | Да | от 16 до 8192 (шаг: 16) |
+| `height` | Высота выходного латентного представления (по умолчанию: 480) | INT | Да | от 16 до 8192 (шаг: 16) |
+| `length` | Количество кадров в выходном латентном представлении (по умолчанию: 81) | INT | Да | от 1 до 8192 (шаг: 4) |
+| `batch_size` | Количество видео для генерации в одном пакете (по умолчанию: 1) | INT | Да | от 1 до 4096 |
+| `source_video` | Исходное видео для редактирования или изменения стиля (v2v, rv2v). Изменяет размер до width/height и обрезается до length. | IMAGE | Нет | - |
+| `reference_video` | Видео для вставки в исходное видео (ads2v). | IMAGE | Нет | - |
+| `reference_images` | Эталонные изображения, внедряемые как контекстные токены (r2v, rv2v). Можно указать до 8 изображений. | IMAGE | Нет | от 0 до 8 изображений |
+| `ref_max_size` | Максимальный размер для длинной стороны reference_video и reference_images. Изменяет размер с сохранением пропорций и выравниванием по 16px (по умолчанию: 848). | INT | Нет | от 16 до 8192 (шаг: 16) |
+
+**Примечание:** Тип задачи определяется на основе подключенных входов:
+- Нет подключенных входов → текст-в-видео (t2v)
+- Только `source_video` → видео-в-видео (v2v)
+- `source_video` + `reference_images` → редактирование видео с эталонным управлением (rv2v)
+- Только `reference_images` → эталон-в-видео (r2v)
+- `source_video` + `reference_video` → вставка изображения/видео в видео (ads2v)
+
+## Выходные параметры
+
+| Имя выхода | Описание | Тип данных |
+|------------|----------|------------|
+| `positive` | Положительное состояние с присоединенными контекстными латентными представлениями | CONDITIONING |
+| `negative` | Отрицательное состояние с присоединенными контекстными латентными представлениями | CONDITIONING |
+| `latent` | Пустой тензор латентного представления с размерами, соответствующими указанным width, height, length и batch_size | LATENT |
+
+> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/ru.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/tr.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+BerniniConditioning düğümü, Wan2.2-A14B modeli için video ve görüntü koşullandırma verilerini hazırlar. Kaynak videoları, referans videoları ve referans görüntülerini sağlanan VAE kullanarak kodlar ve bunları bağlam içi üretim görevleri için koşullandırma verilerine ekler.
+
+## Girişler
+
+| Parametre | Açıklama | Veri Türü | Zorunlu | Aralık |
+|-----------|----------|-----------|---------|--------|
+| `positive` | Pozitif koşullandırma verileri | CONDITIONING | Evet | - |
+| `negative` | Negatif koşullandırma verileri | CONDITIONING | Evet | - |
+| `vae` | Video ve görüntü girişlerini kodlamak için kullanılan VAE modeli | VAE | Evet | - |
+| `width` | Çıktı latenti genişliği (varsayılan: 832) | INT | Evet | 16 ila 8192 (adım: 16) |
+| `height` | Çıktı latenti yüksekliği (varsayılan: 480) | INT | Evet | 16 ila 8192 (adım: 16) |
+| `length` | Çıktı latentindeki kare sayısı (varsayılan: 81) | INT | Evet | 1 ila 8192 (adım: 4) |
+| `batch_size` | Tek bir grupta oluşturulacak video sayısı (varsayılan: 1) | INT | Evet | 1 ila 4096 |
+| `source_video` | Düzenlenecek veya yeniden stillendirilecek kaynak video (v2v, rv2v). Genişlik/yüksekliğe yeniden boyutlandırılır ve uzunluğa kırpılır. | IMAGE | Hayır | - |
+| `reference_video` | Kaynak videoya eklenecek video (ads2v). | IMAGE | Hayır | - |
+| `reference_images` | Bağlam içi token olarak eklenen referans görüntüleri (r2v, rv2v). En fazla 8 görüntü sağlanabilir. | IMAGE | Hayır | 0 ila 8 görüntü |
+| `ref_max_size` | reference_video ve reference_images için uzun kenarın maksimum boyutu. En-boy oranı korunarak yeniden boyutlandırılır ve 16 piksele yuvarlanır (varsayılan: 848). | INT | Hayır | 16 ila 8192 (adım: 16) |
+
+**Not:** Görev, hangi girişlerin bağlı olduğuna göre belirlenir:
+- Hiçbir giriş bağlı değil → metinden videoya (t2v)
+- Yalnızca `source_video` → videodan videoya (v2v)
+- `source_video` + `reference_images` → referans kılavuzlu video düzenleme (rv2v)
+- Yalnızca `reference_images` → referanstan videoya (r2v)
+- `source_video` + `reference_video` → görüntü/videoyu videoya ekleme (ads2v)
+
+## Çıktılar
+
+| Çıktı Adı | Açıklama | Veri Türü |
+|-----------|----------|-----------|
+| `positive` | Bağlam latenteri eklenmiş pozitif koşullandırma | CONDITIONING |
+| `negative` | Bağlam latenteri eklenmiş negatif koşullandırma | CONDITIONING |
+| `latent` | Belirtilen genişlik, yükseklik, uzunluk ve batch_size ile eşleşen boyutlara sahip boş latent tensör | LATENT |
+
+> Bu belge yapay zeka tarafından oluşturulmuştur. Herhangi bir hata bulursanız veya iyileştirme önerileriniz varsa, katkıda bulunmaktan çekinmeyin! [GitHub'da Düzenle](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/tr.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`

comfyui_embedded_docs-0.5.4/comfyui_embedded_docs/docs/BerniniConditioning/zh-TW.md

@@ -0,0 +1,39 @@
+# BerniniConditioning
+
+BerniniConditioning 節點負責為 Wan2.2-A14B 模型準備影片與影像的條件化資料。它使用提供的 VAE 對來源影片、參考影片及參考影像進行編碼，然後將其附加到條件化資料中，以執行情境內生成任務。
+
+## ## 輸入
+
+| 參數 | 說明 | 資料類型 | 必填 | 範圍 |
+|-----------|-------------|-----------|----------|-------|
+| `positive` | 正向條件化資料 | CONDITIONING | 是 | - |
+| `negative` | 負向條件化資料 | CONDITIONING | 是 | - |
+| `vae` | 用於編碼影片與影像輸入的 VAE 模型 | VAE | 是 | - |
+| `width` | 輸出潛在空間的寬度（預設值：832） | INT | 是 | 16 至 8192（步長：16） |
+| `height` | 輸出潛在空間的高度（預設值：480） | INT | 是 | 16 至 8192（步長：16） |
+| `length` | 輸出潛在空間的影格數（預設值：81） | INT | 是 | 1 至 8192（步長：4） |
+| `batch_size` | 單一批次中生成的影片數量（預設值：1） | INT | 是 | 1 至 4096 |
+| `source_video` | 要編輯或重新風格的來源影片（v2v, rv2v）。會調整為指定的寬度/高度，並裁剪至指定長度。 | IMAGE | 否 | - |
+| `reference_video` | 要插入來源影片中的影片（ads2v）。 | IMAGE | 否 | - |
+| `reference_images` | 作為情境內標記注入的參考影像（r2v, rv2v）。最多可提供 8 張影像。 | IMAGE | 否 | 0 至 8 張影像 |
+| `ref_max_size` | 參考影片與參考影像長邊的最大尺寸。會保持長寬比進行調整，並對齊至 16 像素（預設值：848）。 | INT | 否 | 16 至 8192（步長：16） |
+
+**注意：** 任務類型會根據連接的輸入推斷：
+- 未連接任何輸入 → 文字轉影片（t2v）
+- 僅連接 `source_video` → 影片轉影片（v2v）
+- 連接 `source_video` + `reference_images` → 參考引導的影片編輯（rv2v）
+- 僅連接 `reference_images` → 參考轉影片（r2v）
+- 連接 `source_video` + `reference_video` → 將影像/影片插入影片（ads2v）
+
+## ## 輸出
+
+| 輸出名稱 | 說明 | 資料類型 |
+|-------------|-------------|-----------|
+| `positive` | 附加了情境潛在空間的正向條件化資料 | CONDITIONING |
+| `negative` | 附加了情境潛在空間的負向條件化資料 | CONDITIONING |
+| `latent` | 空的潛在空間張量，其維度符合指定的寬度、高度、長度與批次大小 | LATENT |
+
+> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議，歡迎貢獻！ [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BerniniConditioning/zh-TW.md)
+
+---
+**Source fingerprint (SHA-256):** `3535bbe9a1ae007dc579242b44787ab315479a820eb0da680eab9b870ab60699`