MiniMax H3 LongForge 7.1 · FL2VA & REF2VA

От первой сцены до готового фильма со звуком — в одном workflow ComfyUI.

From the first scene to a finished film with audio — in one ComfyUI workflow.

Подписка и поддержка / Follow & support

AI Bob Public · AI DEV LAB

Поддержать разработку можно кнопкой Tip в моём профиле Civitai или добровольным переводом USDT (или другой валютой в соответствующей сети). / Support development through Tip on my Civitai profile or an optional USDT donation (or another currency in the corresponding network).

BNB Smart Chain — 0xdCf9846A1B0F2fe32E19dC9CFdDC5194CC13D108

TON — UQCeukjBulZw9gni1jv8NLRgtmgHDQ6mUiS2qf3716XobIxA

TRON / TRC20 — THLU3yu8VpoPqP4bMLCp86FRhoCweJ2Qz4

Если вы кидаете USDT, только через соответствующую сеть.(Остальные валюты тоже через определенную сеть) Спасибо! / If you send USDT, only through the appropriate network. (Other currencies also through a specific network.) Thank you!

Русский

LongForge собирает длинное видео MiniMax H3 по сценам: сценарий и промпты, генерация со звуком, продолжение, выбор тейков, монтаж, HQ и экспорт. В комплекте — собственный Node Pack, основной workflow FL2VA / REF2VA и RefMod Studio. Кнопки на английском; полные инструкции RU/EN встроены в оба workflow.

Главное в 7.1

Миниатюры сцен. В карточках Scene 1, Scene 2 и далее появляется первый видимый кадр сохранённого тейка — проще ориентироваться в фильме без открытия каждого видео. Миниатюра обновляется при перегенерации, смене проекта и восстановлении цепочки. Старые проекты используют сохранённое превью; если его нет, нажмите Preview scene. При выключенных Scene previews кадр появится после создания превью. Trim for export миниатюру не меняет; картинки не встраиваются в workflow.

Два способа кеширования в одной ноде. В 09 · Native Cache → Cache method доступны OFF / OUTPUT / BLOCK:

OUTPUT — Может повторно использовать полный выход модели; видео и звук проверяются независимо. Сохраняет алгоритм, профили и защиты 7.0. Не менее 16 шагов, CFG 1, обход 07 · Turbo LoRA и 08a · VEDA.

BLOCK — Экспериментальный кеш на основе T8: считает первый блок и при достаточно малой разнице повторно использует сохранённые изменения остальных блоков. Не менее 4 шагов, CFG 1, Euler / RES multistep / RES multistep CFG++. Turbo не запрещён; VEDA требует отдельного разрешения.

OFF — Передаёт MODEL без установки кеша. Для сравнения с обычной генерацией.

Оба метода используют проверки LongForge Render. Другой активный кеш, несовместимые патчи и RefMod sampling-step curves могут отключить кеширование. OUTPUT также отключается со стохастическими семплерами и при неизвестном состоянии Turbo. Ускоряющие LoRA подключайте через 07, обычные — через 08 · Extra LoRA.

BLOCK — полностью ручной. Порог, окно работы, лимит повторов, CPU/GPU-хранилище и metric stride доступны сразу, без пресетов. Все значения и диапазоны перечислены ниже. Профили OUTPUT сохранены.

Внешний T8 устанавливать не нужно. Кеш очищается после каждой сцены, в том числе при ошибке. Старые workflow 7.0 сохраняют OUTPUT; прежние пресеты BLOCK из workflow 7.1 переводятся в их фактические числовые настройки, CUSTOM сохраняет введённые значения.

Начните с BLOCK без VEDA и сравните одинаковый seed с OFF, одной VEDA и BLOCK + VEDA. На коротком расписании выгоды может не быть: active True · reused 0/N означает, что кеш включён, но повторов не было. BLOCK и BLOCK + VEDA экспериментальные; ускорение и сохранение качества не гарантируются.

Исправления устойчивости. Исправлена очистка предзагрузки BLOCK для ComfyUI 0.42.5, обработка повреждённого кеша импорта и списка медиа. Seam Lab возвращает индивидуальную длительность выбранного тейка. Уточнены подсказки RefMod и адрес Ollama. Возможности 7.0, включая Trim for export, сохранены.

Установка и первый фильм

1. Закройте ComfyUI. Установите или целиком замените ComfyUI/custom_nodes/ComfyUI-H3-LongForge-NodePack/. Проекты в output/longforge_native/ сохраните и сделайте резервную копию.

2. Установите requirements.txt через Python самого ComfyUI. Для полного шаблона отдельно нужны ComfyUI-KJNodes и Veda-on-ComfyUI с зависимостями. Команды и ссылки — ниже; внешний T8 и оригинальный RefMod-пак не нужны.

3. Перезапустите ComfyUI, нажмите Ctrl+F5 и откройте H3_LongForge_FL2VA_REF2VA_v7.1.json. В 01–04 выберите H3 checkpoint, соответствующий текстовый энкодер и оба VAE; в 11 — подходящий модели FL2VA / REF2VA.

4. Без совместимого SageAttention обойдите 05–06 через Ctrl+B. VEDA (08a) и Live Preview (04a) отключаются независимо. Bypass не заменяет установку отсутствующих типов нод. 09 · Native Cache по умолчанию выключен; для кеширования включите ноду через Ctrl+B и выберите метод.

5. В 10 · Project & Scenes задайте уникальное имя проекта и промпты. GENERATE NEXT → Run создаёт следующую сцену; ONE SCENE / ALL PENDING — одну или все ожидающие с сохранением каждой.

6. EXPORT FILM → Run собирает активный фильм. Результаты: output/longforge_native/<project>/exports/.

Шаблон начинает с 20 шагов и выключенной Turbo LoRA. Для Turbo включите подходящую LoRA в 07 и используйте её рекомендованные настройки. VEDA сама не уменьшает число шагов и не заменяет Turbo.

Что ещё умеет LongForge

Продолжение видео и звука. В 11 · Video & Continuity доступны PROTECTED — копирование видеолатентного хвоста с защитной маской; GUIDE — хвост как ориентир; LAST FRAME — один последний декодированный RGB-кадр базового видео. Звук независим: HARD / SOFT / OFF защищают аудиопрефикс, допускают изменение его конца или отключают защищённый контекст, сохраняя генерацию звука. Старт — MANUAL / 22F / HARD. В LAST FRAME 22F задаёт скрытый контекст, а не передачу 22 картинок. Точное сохранение лица и незаметный стык не гарантируются.

Длительность: WINDOW FRAMES включает overlap; NEW SECONDS задаёт новую видимую часть. Значения округляются по сетке H3; у первой сцены предыдущего overlap нет. ALL PENDING проверяет очередь заранее, но AUTO зависит и от будущих сцен, поэтому остановка между сценами возможна.

Оставить удачный фрагмент без перегенерации — Preview scene → Trim for export → Set In / Set Out или номера First / Last frame → Apply trim → EXPORT FILM → Run. Нумерация с 1, обе границы включены; Reset trim возвращает полный диапазон.

Укоротить сцену и продолжить от нового конца — Только LAST FRAME: Preview scene → нужная точка → Continue here → проверить следующую карточку → GENERATE NEXT → Run. Точка округляется назад к границе H3; слишком ранняя отклоняется.

Посмотреть стык и сравнить A/B-тейки — Seam Lab, фильм из двух и более сцен. Выбор другого тейка делает поздние сцены pending; прежняя цепочка остаётся в Saved chains.

Trim обрезает видео и звук только при экспорте, сохраняя полные тейки, превью и контекст продолжения. Обрезки привязаны к тейкам в export_trim.json; новый тейк начинает с полного диапазона. Continue here создаёт сокращённый тейк видео, HQ и звука, сохраняя исходную цепочку. Trim не создаёт плавный переход; интерполяция не заполняет вырезанные интервалы.

Проекты и версии. Open project / Saved chains открывают проекты и сохранённые цепочки; Recover project восстанавливает указатель по целым проверенным файлам. New film сбрасывает активный фильм, оставляя обычные карточки и тейки; импортированная карточка становится пустой. Delete all оставляет одну Scene 1, сохраняя файлы. Clean unused очищает неиспользуемое с отдельным подтверждением удаления цепочек; Delete film удаляет всю папку проекта. Перед пересъёмкой середины фильма появляется предупреждение о поздних сценах. GENERATE NEXT на завершённом фильме ничего не переснимает.

Сценарий и Prompt Assistant. Scenario from description создаёт 1–16 новых сцен по идее и общей длительности; Generate draft пишет промпт одной сцены, при необходимости с 1–8 шотами. В 16 доступны NATIVE / TRANSFORMERS / GGUF / OLLAMA / SERVER. NATIVE требует отдельную генеративную LLM, например Gemma 4 в 16a, а не энкодер H3. Локальные модели и vision-проекции — в models/llm/. Совместимая vision-модель использует выбранные изображения и хвост предыдущей сцены; аудио не анализируется. Ассистент сообщает об исправлениях и повторяет отклонённые карточки. До Apply карточки не заменяются; сохранённые сцены остаются. Обычный Run фильма не запускает LLM.

Импорт и референсы. 18 · Source Video → IMPORT VIDEO в пустом проекте превращает источник в Scene 1; продолжение пишите в Scene 2. Есть CONTAIN / CROP и нормализация к 24 FPS/сетке H3. Нужны оба VAE; diffusion и текстовый энкодер не запускаются. Это VAE-реконструкция, а не пиксели 1:1; импортированная Scene 1 не переснимается обычной генерацией. Обычные фото-, видео- и аудиореференсы поддерживают обрезку, режимы звука и пресеты без исходных файлов. Роли, Character group и Keep/Drop помогают ассистенту; напрямую тензоры H3 не меняют.

RefMod Studio. Сохранённые image/video/audio VAE-латенты в .safetensors без обучения и LoRA. Нужен REF2VA; RefMods стартуют выключенными, с INHERIT / OFF / CUSTOM для каждой сцены. FULL / COMPRESSED сохраняют латент выбранного разрешения или экономят токены ценой деталей. INDEPENDENT / STACK / MERGE — отдельные members, соединение по времени или общий сжатый референс; MERGE требует COMPRESSED и может смешивать внешность и фон. Есть mixed bundles, маски, превью, token reports, перепаковка, strengths, кривые и A/B. Практический объём зависит от памяти и токенов; меньшая strength токены не уменьшает. Кривые не задают время появления персонажа в фильме.

Создание: RefMod_Studio_v7.1.json → источники и оба VAE → CREATE → Run Studio action → Run, затем выключите переключатель. Файлы — обычно models/refmods/longforge/; просмотр — INSPECT → stored → preview_index, с 0. Чёрный квадрат после CREATE — служебный заполнитель. {refmod:hero} выбирает members файла, {refmod:hero_1} — отдельный выбранный member; Check mapping показывает метки. Подробности — во встроенной инструкции.

VEDA, превью, HQ и экспорт

• VEDA · 08a: predictor должен соответствовать FL2VA / REF2VA; файлы — ниже. Старт: 32 / 32, пустые full-attention lists, verbose = false. 32 — бюджет key tiles по 128 токенов, не 32%. Сравнивайте одинаковый seed с обходом VEDA через Ctrl+B. Не совмещайте её с ComfyUI Model Sparse Attention.

• Live Preview · 04a: приблизительная картинка семплирования; Preview scene декодирует сохранённый результат. По умолчанию — один кадр без звука. Совместимый H3 tiny VAE выбирается из models/vae_approx/; без него используются настройки превью ComfyUI. Анимация и звук добавляют расходы. Основной H3 Video VAE не подключайте к LTX-входу vae ноды KJ.

• HQ Finish · 13: OFF / UPSCALE / UPSCALE + REFINE, FULL / TILED / AUTO, плитки, временные окна и бюджет памяти. Нужен совместимый 3D latent upscaler. Exact width/height задаются парой, кратны 32, сохраняют пропорции и не уменьшают оси; оба 0 используют Scale. Настройки фиксируются внутри фильма. Продолжение использует базовые AV-латенты; ветка HQ-refiner не содержит VEDA/Turbo. AUTO не исключает OOM.

• Экспорт · 19–20: MP4 / MKV / WEBM, совместимые H264 / HEVC / AV1 / VP9, CPU и доступные аппаратные энкодеры, AUTO с возвратом к CPU. RIFE / FILM работают на финальном экспорте: ×2 → 48 FPS, ×4 → 96 FPS, сохраняя длительность и звук. Есть непрерывное декодирование звука, необязательное исправление щелчков и Diagnostic WAVs. На резких переходах возможны артефакты; 10 bit не превращает RGB8 в HDR.

NONE / RECOVERY — экспорт без вложенных настроек либо с данными восстановления, включая монтажную карту. RECOVERY не заменяет резервную копию: для переноса фильма и локальных обрезок сохраняйте всю папку проекта. Прежние экспорты остаются на диске.

English

LongForge builds long MiniMax H3 videos scene by scene: planning, prompts, generation with audio, continuation, take selection, editing, HQ and export. Includes a custom Node Pack, the FL2VA / REF2VA main workflow and RefMod Studio. Controls use English labels; both workflows contain full RU/EN guides.

New in 7.1

Scene thumbnails. Scene cards show the saved take's first visible frame, making the film easier to navigate without opening every video. Thumbnails update after regeneration, project changes and chain restoration. Older projects use their saved preview; if none exists, click Preview scene. With Scene previews disabled, a thumbnail becomes available after creating that preview. Trim for export does not change it; images are not embedded in workflows.

Two cache methods in one node. 09 · Native Cache → Cache method offers OFF / OUTPUT / BLOCK:

OUTPUT — Can reuse the full model output, with independent video/audio checks. Retains the 7.0 algorithm, profiles and guards. At least 16 steps, CFG 1, 07 · Turbo LoRA and 08a · VEDA bypassed.

BLOCK — Experimental cache adapted from T8. Computes the first block and, when differences are small enough, reuses cached changes from the remaining blocks. At least 4 steps, CFG 1, Euler / RES multistep / RES multistep CFG++. Turbo is allowed; VEDA needs explicit permission.

OFF — Passes MODEL through without installing a cache. Baseline comparison.

Both methods require LongForge Render preflight. Another active cache, incompatible patches or RefMod sampling-step curves can disable caching. OUTPUT also rejects stochastic samplers and unknown Turbo state. Connect accelerating LoRAs through 07, ordinary LoRAs through 08 · Extra LoRA.

BLOCK controls are fully manual. Threshold, schedule window, reuse limit, CPU/GPU storage and metric stride are directly editable, without presets. Defaults and ranges are listed below. OUTPUT profiles remain available.

No separate T8 installation is needed. Cached tensors are cleared after each scene, including on error. Older 7.0 workflows keep OUTPUT; previous 7.1 BLOCK presets migrate to their effective numeric settings, while CUSTOM retains entered values.

Start with BLOCK without VEDA. Compare the same seed against OFF, VEDA alone and BLOCK + VEDA. Short schedules may yield no benefit: active True · reused 0/N means the cache was enabled but reused nothing. BLOCK and BLOCK + VEDA are experimental; speed gains and unchanged quality are not guaranteed.

Stability fixes. Corrected BLOCK prefetch cleanup for ComfyUI 0.42.5, damaged import-cache/media-list handling and restoration of a selected take's individual duration in Seam Lab. RefMod tooltips and the Ollama address were corrected. All 7.0 features, including Trim for export, remain available.

Installation and your first film

1. Stop ComfyUI. Install or replace the entire ComfyUI/custom_nodes/ComfyUI-H3-LongForge-NodePack/ folder. Keep and back up projects in output/longforge_native/.

2. Install requirements.txt using ComfyUI's Python. The complete template also needs external ComfyUI-KJNodes and Veda-on-ComfyUI, with their dependencies. Commands and links are below. Separate T8 and original RefMod installations are unnecessary.

3. Restart ComfyUI, refresh with Ctrl+F5, then open H3_LongForge_FL2VA_REF2VA_v7.1.json. Select the H3 checkpoint, matching text encoder and both VAEs in 01–04; match FL2VA / REF2VA in 11 to the model.

4. Bypass 05–06 with Ctrl+B if compatible SageAttention is unavailable. VEDA (08a) and Live Preview (04a) can be bypassed independently. Bypass does not install missing node types. 09 · Native Cache starts bypassed; enable it with Ctrl+B and select a method to use caching.

5. Set a unique project name and prompts in 10 · Project & Scenes. GENERATE NEXT → Run creates the next scene; ONE SCENE / ALL PENDING selects one or all pending scenes, saving each.

6. EXPORT FILM → Run assembles the active film. Results: output/longforge_native/<project>/exports/.

The template starts with 20 steps and Turbo LoRA bypassed. Enable a compatible LoRA in 07 and follow its recommended settings for Turbo. VEDA does not reduce the step count or replace Turbo.

More LongForge features

Video and audio continuation. 11 · Video & Continuity offers PROTECTED — copied video-latent tail with a protective mask; GUIDE — tail guidance; LAST FRAME — one final decoded RGB frame from the base video. Audio is independent: HARD / SOFT / OFF protects the audio prefix, allows its ending to change, or disables protected context while retaining audio generation. Start with MANUAL / 22F / HARD. In LAST FRAME, 22F defines hidden context, not 22 input images. Exact identity and invisible joins are not guaranteed.

Duration: WINDOW FRAMES includes overlap; NEW SECONDS targets the new visible part. H3-grid rounding applies; Scene 1 has no preceding overlap. ALL PENDING checks the queue in advance, but AUTO depends on future scenes too, so a stop between scenes remains possible.

Keep the best part without regeneration — Preview scene → Trim for export → Set In / Set Out or First / Last frame numbers → Apply trim → EXPORT FILM → Run. Frame numbers start at 1, both endpoints included; Reset trim restores the full range.

Shorten a scene and continue from its new endpoint — LAST FRAME only: Preview scene → desired point → Continue here → review the next card → GENERATE NEXT → Run. The point snaps backward to an H3 boundary; excessively early points are refused.

Inspect joins and compare A/B takes — Seam Lab, for films with two or more scenes. Selecting another take makes later scenes pending; the previous chain remains in Saved chains.

Trim cuts video and audio only during export, keeping full takes, previews and continuation context. Per-take edits live in export_trim.json; new takes start full length. Continue here creates a shortened video/HQ/audio take while retaining the original chain. Trimming does not create smooth transitions; interpolation does not bridge removed intervals.

Projects and versions. Open project / Saved chains opens projects and saved chains; Recover project rebuilds the pointer from intact verified files. New film resets the active film while retaining ordinary cards and takes; imported cards become blank. Delete all leaves Scene 1 and retains files. Clean unused removes unused files, with separate confirmation for saved chains; Delete film removes the entire project folder. Regenerating the middle warns about later scenes. GENERATE NEXT on a completed film does not regenerate it.

Planning and Prompt Assistant. Scenario from description creates 1–16 new scenes from an idea and total duration; Generate draft writes one scene, optionally with 1–8 shots. 16 supports NATIVE / TRANSFORMERS / GGUF / OLLAMA / SERVER. NATIVE needs a separate generation-capable LLM, such as Gemma 4 in 16a, rather than H3's encoder. Local models and vision projections belong in models/llm/. Compatible vision models can inspect selected images and the previous scene tail, without listening to audio. The assistant reports repairs and retries rejected cards. Cards stay unchanged until Apply; saved scenes remain. A normal film Run does not invoke an LLM.

Import and references. 18 · Source Video → IMPORT VIDEO in an empty project makes the source Scene 1; continue in Scene 2. Includes CONTAIN / CROP and 24 FPS/H3-grid normalization. Both VAEs are required; diffusion and the text encoder do not run. This is VAE reconstruction, not original pixels 1:1. Imported Scene 1 cannot be remade through ordinary generation. Ordinary image/video/audio references support trimming, audio modes and presets without source files. Roles, Character group and Keep/Drop guide the assistant without directly changing H3 tensors.

RefMod Studio. Saved image/video/audio VAE latents in .safetensors, without training or LoRAs. Requires REF2VA; RefMods start disabled, with per-scene INHERIT / OFF / CUSTOM. FULL / COMPRESSED retain selected-resolution latents or save tokens at the cost of detail. INDEPENDENT / STACK / MERGE means separate members, temporal stacking or a combined compressed reference; MERGE requires COMPRESSED and may blend appearance and backgrounds. Includes mixed bundles, masks, previews, token reports, repacking, strengths, curves and A/B. Capacity depends on memory and tokens; lower strength does not reduce token cost. Curves do not schedule character appearances in film time.

Create: RefMod_Studio_v7.1.json → sources and both VAEs → CREATE → Run Studio action → Run, then disable the switch. Files normally save in models/refmods/longforge/; inspect with INSPECT → stored → preview_index, starting at 0. The black image after CREATE is a placeholder. Labels {refmod:hero} / {refmod:hero_1} and Check mapping select file members or individual members; details are in the embedded guide.

VEDA, preview, HQ and export

• VEDA · 08a: match the predictor to FL2VA / REF2VA; filenames are below. Start with 32 / 32, empty full-attention lists and verbose = false. 32 is a budget of 128-token key tiles, not 32%. Compare the same seed with VEDA bypassed using Ctrl+B. Do not combine it with ComfyUI Model Sparse Attention.

• Live Preview · 04a: approximate sampling progress; Preview scene decodes a saved result. Defaults to one frame without audio. Select a compatible H3 tiny VAE from models/vae_approx/, or use ComfyUI's preview settings without one. Animation and audio add work. Do not connect the main H3 Video VAE to the KJ node's LTX vae input.

• HQ Finish · 13: OFF / UPSCALE / UPSCALE + REFINE, FULL / TILED / AUTO, spatial tiles, temporal windows and a memory budget. Requires a compatible 3D latent upscaler. Exact width/height must be set together, be multiples of 32, preserve aspect ratio and not shrink either axis; both 0 use Scale. Settings stay fixed within a film. Continuation uses base AV latents; the HQ-refiner branch excludes VEDA/Turbo. AUTO does not eliminate OOM.

• Export · 19–20: MP4 / MKV / WEBM, compatible H264 / HEVC / AV1 / VP9 combinations, CPU or available hardware encoders, AUTO with CPU fallback. RIFE / FILM run at final export: ×2 → 48 FPS, ×4 → 96 FPS, preserving duration and audio. Includes continuous audio decoding, optional click repair and Diagnostic WAVs. Hard cuts may produce artifacts; 10 bit does not create HDR from RGB8.

NONE / RECOVERY exports without embedded settings or with recovery data, including the edit map. RECOVERY is not a backup: retain the whole project folder to move a film and its local trims. Previous exports remain on disk.

Настройки BLOCK / BLOCK settings

Threshold — 0.12 (по умолчанию / default). 0–1; выше — агрессивнее / higher is more aggressive.

Window start / end — 0.08 / 0.95 (по умолчанию / default). 0–1, start < end.

Max reuses — 2 (по умолчанию / default). 0–10; 0 отключает повтор / 0 disables reuse.

Storage — cpu (по умолчанию / default). cpu / gpu — RAM / compute device.

Metric stride — 8 (по умолчанию / default). Целое / integer 1–32.

Console report — true (по умолчанию / default). true / false.

BLOCK + VEDA (experimental) — false (по умолчанию / default). true / false.

RU: Storage задаёт место хранения кеша, а не устройство генерации. Metric stride задаёт выборку внутренних данных для оценки разницы: 1 — все значения, 8 — примерно 1/64; это не интервал шагов генерации. Console report включает подробные логи.

EN: Storage chooses where cached tensors live, without changing the generation device. Metric stride samples internal values for difference measurement: 1 checks all values, 8 checks about 1/64; it is not a denoising-step interval. Console report enables detailed logs.

Комплект и зависимости / Package & dependencies

• ComfyUI-H3-LongForge-NodePack/

• H3_LongForge_FL2VA_REF2VA_v7.1.json

• RefMod_Studio_v7.1.json

RU: нужны ComfyUI с нативным MiniMax H3 и V3 node API, соответствующие H3 checkpoint и текстовый энкодер, H3 Video/Audio VAE, FFmpeg с libx264/AAC. Сначала проверяется PATH, затем используется imageio-ffmpeg. Веса и код внешних нод в архив не входят. SageAttention, VEDA, LLM, HQ и интерполяция требуют своих совместимых зависимостей и весов. Node Pack и workflow используйте одной версии 7.1.

EN: requires ComfyUI with native MiniMax H3 and V3 node API, matching H3 checkpoint and text encoder, H3 Video/Audio VAEs, and FFmpeg with libx264/AAC. PATH is checked first, then imageio-ffmpeg. Weights and external-node source are not bundled. SageAttention, VEDA, LLM, HQ and interpolation need compatible dependencies and weights. Use the 7.1 Node Pack and workflows together.

Windows Portable — из корня portable-сборки / from the portable root:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-H3-LongForge-NodePack\requirements.txt

Обычная установка / Standard installation — в окружении ComfyUI, из папки ComfyUI / in ComfyUI's environment, from its directory:

python -m pip install -r custom_nodes/ComfyUI-H3-LongForge-NodePack/requirements.txt

VEDA predictors

Файлы в ComfyUI/models/veda/, выбор в 08a. Требования к GPU/backend и установке — в README VEDA. / Place files in ComfyUI/models/veda/ and select in 08a. See VEDA's README for installation and GPU/backend requirements.

FL2VA — minimax_h3_t2va_veda_8nfe_600step_preview_fp8.safetensors

REF2VA — minimax_h3_r2va_veda_preview_fp8.safetensors

SERVER API

RU: ключ задаётся через LONGFORGE_LLM_API_KEY, без сохранения в workflow. Для внешнего API с ключом укажите LONGFORGE_LLM_API_HOSTS=api.example.com: точные хосты без протокола и пути, несколько — через запятую; поддомены разрешаются отдельно. Внешнему серверу ключ передаётся только по HTTPS. Loopback и серверы без ключа списка не требуют. В Windows .bat добавьте set LONGFORGE_LLM_API_HOSTS=api.example.com перед запуском ComfyUI.

EN: set the key through LONGFORGE_LLM_API_KEY, never a saved workflow field. For a keyed external API, set LONGFORGE_LLM_API_HOSTS=api.example.com: exact hostnames without protocol or path, comma-separated; allow subdomains separately. External keys are sent only over HTTPS. Loopback and keyless servers need no allowlist. In a Windows .bat, add set LONGFORGE_LLM_API_HOSTS=api.example.com before starting ComfyUI.

Ссылки / Links

• MiniMax H3 models

• ComfyUI-KJNodes · Live Preview & attention tools

• Veda-on-ComfyUI · installation & predictors

• VEDA R2VA predictor

• Gemma 4 · optional assistant model

• H3 3D latent upscaler · optional HQ

Проверка / Validation

RU: финальная сборка проверена с ComfyUI 0.42.5, frontend 1.55.18, Python 3.13.14, PyTorch 2.13.0 CPU: 723 Python-теста, 75 JavaScript-тестов и 227 браузерных проверок, без провалов; 3 Windows junction-теста пропущены. Использовались настоящий ComfyUI HTTP/executor и FFmpeg; основные модели заменялись CPU-двойниками, отдельные проверки выполняли небольшой H3 со случайными весами. Обученные модели, GPU-генерация, GPU-ядра VEDA, VRAM, аппаратные энкодеры и Windows не проверены. BLOCK и BLOCK + VEDA экспериментальные; скорость и качество нужно сравнивать на целевой системе.

EN: the final build was checked with ComfyUI 0.42.5, frontend 1.55.18, Python 3.13.14, PyTorch 2.13.0 CPU: 723 Python tests, 75 JavaScript tests and 227 browser checks, no failures; 3 Windows junction tests skipped. Validation used real ComfyUI HTTP/executor and FFmpeg; main models were CPU doubles, with a small randomly initialized H3 in dedicated checks. Trained models, GPU generation, VEDA GPU kernels, VRAM, hardware encoders and Windows were not tested. BLOCK and BLOCK + VEDA are experimental; compare speed and quality on the target system.

Авторы и благодарности / Credits

• BLOCK cache: адаптация / adapted from comfyui-minimax-h3-blockcache-T8 — T8mars, Apache-2.0. Отдельная установка не нужна / no separate installation required.

• OUTPUT cache / LAST FRAME: подходы изучены на примере / approaches studied through comfyui-AGSoft — AGSoft, с собственной интеграцией в систему сцен LongForge / with LongForge's own scene-system integration.

• RefMod: адаптация / adapted from ComfyUI-MiniMaxH3Mod — Luisa / Luisacaotica.

• HQ: адаптация апскейлера / upscaler adaptation — LBH-123-AI.

• VEDA: veda-sparse / Veda-on-ComfyUI. Live Preview & attention tools: Kijai / ComfyUI-KJNodes — внешние подключаемые ноды / external workflow nodes.

Авторские уведомления и сторонние лицензии сохранены в Node Pack. / Third-party credits and licenses are retained in the Node Pack.