# Deno Custom Nodes [English](../README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [Español](README.es.md) | [Português](README.pt-PT.md) | [Português (Brasil)](README.pt-BR.md) | [Bahasa Indonesia](README.id.md) [YouTube Channel](https://www.youtube.com/@Denoise-AI) ![Deno Custom Nodes banner](images/deno-custom-nodes-banner.jpg) Nós práticos do ComfyUI para preparar imagens e vídeos, carregar modelos e organizar o canvas. [GPL-3.0](../LICENSE) - **Preparar e comparar imagens:** [Resize Box, carregadores e nós de comparação](#deno-resize-box). - **Criar workflows de geração:** [MiniMax H3](#deno-minimax-h3-multi-reference-image-loader), [LTX](#deno-ltx-model-loader) e [LLMs locais](#deno-local-llm-loader--deno-local-llm-reviewer). - **Organizar o canvas e os resultados:** [Visual Fold](#deno-visual-fold), [Floating Tools](#deno-floating-tools) e [ferramentas no navegador](#web-tools). ## Quick Start Comece com o ComfyUI já instalado. 1. Abra o ComfyUI Manager e pesquise `Deno Custom Nodes`. 2. Instale o pacote e reinicie o ComfyUI. 3. Clique duas vezes em uma área vazia do canvas, pesquise `(Deno) Resize Box` e adicione o nó. 4. Escolha `Preset Ratio` e os megapixels para definir `width` / `height` de saída. 5. Adicione `Load Image`, selecione ou envie uma imagem e conecte a saída `IMAGE` à entrada `image` do Resize Box. Conecte a saída `image` do Resize Box a `Preview Image` e clique em `Run` para ver o resultado. [Todos os nós](#included-nodes) · [Ferramentas web](#web-tools) · [Visual Fold](#deno-visual-fold) · [Floating Tools](#deno-floating-tools) · [Instalação manual](#install) · [Licença](#license) A maioria dos nós Deno inclui um pequeno botão verde `i` para abrir uma ajuda rápida sem sair do canvas do ComfyUI. Se uma nova versão do Deno Custom Nodes estiver disponível, o botão fica amarelo e mostra um pequeno selo `!`. ## Web Tools Ferramentas que rodam direto no navegador. - [Deno Video Compare](https://deno2026.github.io/comfyui-deno-custom-nodes/video-compare/) - compara dois vídeos renderizados com slider, lado a lado, diferença e toggle. - [Deno Video to GIF/WebP](https://deno2026.github.io/comfyui-deno-custom-nodes/video-to-gif/) - corta, recorta, redimensiona e exporta clipes curtos como GIF ou WebP menor. - [Deno Compressão de vídeo / imagem para Discord](https://deno2026.github.io/comfyui-deno-custom-nodes/video-to-discord/) - reduz vídeos ou imagens e salva, quando possível, com menos de 10 MB para compartilhar no Discord. A interface está disponível apenas em coreano. ## Deno Visual Fold [![Deno Visual Fold](images/deno-visual-fold-preview.webp)](images/deno-visual-fold.webp) Deno Visual Fold é uma ajuda visual para organizar grafos grandes do ComfyUI. Dobrar nós ou grupos não muda a lógica do workflow. Ao selecionar dois ou mais nós, aparece um botão verde `Fold` na barra de seleção nativa do ComfyUI. Ao clicar, os nós selecionados ficam compactados em um grupo visual e podem voltar com `Unfold`. Ao selecionar um grupo comum do ComfyUI, `Fold Group` dobra os nós dentro do grupo; com vários grupos selecionados também aparecem ações de alinhamento. Diferente do Subgraph, o Visual Fold não move nós para um grafo filho. Ele serve apenas para organização visual, útil quando você quer manter nós `Get` / `Set` ou a estrutura pai-filho visível no grafo principal. ## Deno Floating Tools Deno Floating Tools é um assistente opcional em `Settings > DENO > Tools`. Ele vem desativado por padrão. Quando ativado, adiciona um pequeno ícone Deno arrastável à tela do ComfyUI. O painel pode liberar VRAM pelo endpoint de limpeza de memória integrado do ComfyUI, mostrar em modo somente leitura o status da versão atual e mais recente do ComfyUI Stable e abrir um relatório Error Help quando uma execução falha. Error Help cria um relatório pronto para GPT / Gemini com o workflow atual, executável e tipo de ambiente Python, versões de pacotes, GPU, contexto recente de traceback / log e resumo de custom nodes. O recurso é somente leitura, abre primeiro uma janela de relatório e só copia quando você clica em `Copy Report`. Segredos comuns como tokens, cookies, senhas, chaves privadas e credenciais em URLs são ocultados antes da cópia. Floating Tools não instala, atualiza, reinicia, repara nem modifica workflows. ## Included Nodes ### `(Deno) Ideogram Director` Construtor visual de prompts para Ideogram 4, feito para editar captions JSON estruturadas e layouts bbox dentro do canvas do ComfyUI. [![Ideogram Director — Demo](images/ideogram-director-video-thumbnail.jpg)](https://youtu.be/Z8s27skkIDM) - Desenhe e edite regiões bbox; desative temporariamente cada caixa sem excluí-la nem alterar a ordem. - Clique duas vezes em uma bbox para editar perto do ponteiro, ou use `Alt`+clique repetidamente em uma sobreposição para percorrer as caixas por baixo. - Importe prompts JSON do Local LLM Loader ou de outra fonte STRING, confirme antes de substituir um board e rejeite claramente JSON inválido. - As entradas STRING opcionais Summary e Background substituem esses campos do board durante a execução; sem conexão, é usado o texto salvo. - Use galerias de presets de estilo/layout e Language view para editar descrições no seu idioma. A saída final continua em inglês pronto para o modelo e as palavras de caixas TEXT, como placas, logos e títulos, são preservadas exatamente. - Saídas: `prompt`, `width`, `height`, `seed`, `bboxes`. - `bboxes` conecta tanto a `BBOX` padrão quanto a entradas `BOUNDING_BOX`, por exemplo `Ideogram4_MultiLora_BoundingBoxNode_Fedor`. O número de linhas de regiões desse nó acompanha as caixas ativas do Director sem acrescentar campos salvos ao Director. A sincronização atual apenas conta caixas e não acompanha sua identidade: revise as atribuições LoRA depois de excluir ou reordenar uma caixa intermediária. ### `(Deno) Resize Box` Nó de resolução e redimensionamento de imagem para ComfyUI. ![Deno Resize Box](images/resize-box.jpg) Principais recursos: `Preset Ratio` / `Manual Input`, presets de proporção, cálculo por megapixels, alinhamento `divisible_by`, `Center Crop (Fill)`, `Crop Position (Fill)` com zoom e proporção fixa, `Fit (Letterbox/Pillarbox)`, interpolação `lanczos` por padrão e saídas `image`, `width`, `height`. `Crop Position (Fill)` mostra a imagem de origem completa. Arraste o quadro de recorte para reposicioná-lo ou qualquer canto para ajustar o zoom, mantendo fixos a proporção e os megapixels de saída. ### `(Deno) Multi Image Loader` Carregador de várias imagens pensado para workflows de guia em lote. ![Deno Multi Image Loader](images/multi-image-loader.jpg) Principais recursos: galeria de altura fixa, reordenação por arrastar, upload, drag-and-drop, colar imagem, navegação pela pasta `input`, subpastas, ordenação por data recente, redimensionamento por proporção/preset/manual, saídas `multi_output`, `width`, `height`. ### `(Deno) MiniMax H3 Multi Reference Image Loader` Carregador de imagens de referência com uma única conexão para o workflow nativo MiniMax H3 Reference to Video do ComfyUI. Mantém a mesma experiência de upload, paste, drag-and-drop, Input Folder, reordenação de cartões e limpeza do `(Deno) Multi Image Loader`. Envia até 9 referências ordenadas por um socket `ref_images`, preservando separadamente as dimensões e proporções originais de cada imagem, sem resize, crop ou padding. A ordem dos cartões corresponde a ``, `` e seguintes; as mesmas imagens também saem como `image_list` para conexão direta à entrada `image` do `(Deno) Local LLM Loader`. O nó incluído `(Deno) MiniMax H3 Reference to Video` apenas reúne as imagens em uma entrada; as entradas Autogrow nativas de vídeo de referência, áudio associado ao vídeo e áudio independente continuam disponíveis. Esses dois nós MiniMax H3 exigem ComfyUI 0.30.0 ou mais recente. Consulte o [workflow de exemplo MiniMax H3 com múltiplas referências](workflows/minimax-h3-multi-reference.json). ### `(Deno) MiniMax H3 Acc LoRA Loader` Carrega diretamente os [MiniMax-H3-Acc-LoRAs](https://huggingface.co/alibaba-pai/MiniMax-H3-Acc-LoRAs) oficiais da Alibaba PAI, sem converter nem duplicar o arquivo safetensors. 1. Baixe o arquivo oficial `Acc-8Step.safetensors` de FL2VA ou Ref2VA e coloque-o na pasta habitual `ComfyUI/models/loras/` ou na pasta dedicada `ComfyUI/models/minimax_h3_acc_loras/`. 2. Conecte a `model` um modelo de difusão nativo MiniMax H3 compatível; são aceitos modelos completos e variantes `*_pruned_*` da Comfy-Org. 3. Selecione o Acc-LoRA correspondente: FL2VA para FL2VA/T2VA ou Ref2VA para Ref2VA. 4. Conecte a única saída `model` do nó ao caminho habitual do guider. 5. Monte o caminho de amostragem com nós padrão do ComfyUI. Recomenda-se começar com `BasicScheduler: simple, steps: 8` e `KSamplerSelect: euler`, conectados a `SamplerCustomAdvanced`. O nó aplica os pesos LoRA estáticos e as 32 cabeças de saída PDD dependentes do tempo do checkpoint. Durante a amostragem, lê os limites sigma reais fornecidos pelo ComfyUI e funde automaticamente as cabeças PDD para esses intervalos. Assim, o sampler, o scheduler e os passos continuam sendo controlados nos nós habituais do ComfyUI. A configuração oficial Simple/Euler de 8 passos continua sendo a recomendada e a usada no treinamento. Você pode selecionar de 4 a 12 passos no Simple Scheduler sem mudar este loader; outros schedules descendentes ou passes sigma divididos para workflows de ampliação de latentes estão disponíveis para experimentação, sem garantia de melhoria da qualidade. Mantenha os deslocamentos sigma nativos de vídeo/áudio do MiniMax H3 em `12.0 / 3.0` e a força LoRA em `1.0`. Os modelos completos sem poda, incluindo as variantes INT8 nativas do ComfyUI, aplicam o adaptador completo pelo caminho LoRA do ComfyUI compatível com quantização. Para um modelo curve-pruned, o loader procura um checkpoint MiniMax H3 completo compatível já instalado em `models/diffusion_models/`, lê apenas a pequena seção FP32 time-embedder e calcula em memória uma ponte que adapta todas as 50 atualizações AdaLN LoRA de largura completa à curva podada de largura 8. Não carrega o checkpoint completo para esse cálculo. Se não houver um checkpoint completo compatível, continua utilizável em modo de compatibilidade: avisa uma vez, ignora essas 50 atualizações AdaLN e aplica todas as demais atualizações LoRA e cabeças PDD. Os workflows UI padrão com o loader de três saídas de v0.7.92–v0.7.94 ativo são migrados ao serem abertos no canvas do ComfyUI. As conexões do modelo são mantidas, e as antigas conexões sampler e sigmas passam para nós padrão editáveis `KSamplerSelect: euler` e `BasicScheduler: simple, steps: 8`. Salve o workflow UI uma vez depois de abri-lo. Os workflows atuais de uma saída não mudam. Nós silenciados ou em bypass, layouts personalizados desconhecidos e grafos malformados ficam intactos. O JSON de prompts API não executa essa migração frontend; exporte-o novamente a partir do workflow UI migrado. Se o arquivo já tiver sido salvo depois de perder as conexões sampler/sigmas, reconecte manualmente esses nós padrão. O Deno Custom Nodes não inclui pesos LoRA nem workflows para este loader. Baixe os pesos da Alibaba e crie ou adapte seu próprio workflow nativo do ComfyUI. ### Workflow MiniMax H3 R2V com referência de áudio O [workflow de referência de áudio para iniciantes](workflows/minimax-h3-r2v-audio-reference.json) mantém o caminho de áudio de referência nativo do MiniMax H3 e acrescenta uma linha automática de direção de prompts. - `(Deno) Audio Transcript`: usa OpenAI Whisper local para criar letras ou diálogos, tempos por segmento, idioma detectado e resumo de confiança. Se o usuário inserir letras ou diálogos, esse texto tem prioridade. - `(Deno) Audio Analysis Finalizer`: mantém somente os campos documentados de análise acústica do resultado do ComfyUI `TextGenerate` e pode descarregar o modelo CLIP usado na análise após a execução. - `(Deno) Local LLM Loader`: recebe a transcrição e o relatório acústico pela entrada STRING opcional `audio_context`. O AUDIO original não é enviado ao LLM local e a análise automática é tratada como dados de referência, não como instruções. - A seção escolhida do áudio original é, ao mesmo tempo, a referência `