Publish only the final 1000-step character-swap LoRA

LICENSE

@@ -0,0 +1,84 @@
+MiniMax H3 COMMUNITY LICENSE AGREEMENT
+MiniMax H3 release date/License date: August 2, 2026.
+The scope of this License Agreement (this “Agreement”) is expressly limited to the “Applicable Territory” as defined below.
+By clicking to accept, or by using, reproducing, modifying, distributing, running, or displaying any portion or element of the MiniMax H3 Works (including through any Hosted Services) in any manner, you acknowledge and accept the terms of this Agreement, and this Agreement shall take immediate effect upon the occurrence of such act.
+I.  Definitions
+1. “Acceptable Use Policy” means the policy published by MiniMax in Exhibit A.
+2. “Agreement” means the terms and conditions set forth herein that govern the use, reproduction, distribution, modification, running, and display of the MiniMax H3 Works or any portion or element thereof.
+3. “Applicable Territory” means worldwide, excluding the Excluded Territories.
+4. “Documentation” means the specifications, manuals, and documentation concerning MiniMax H3 that are publicly released by MiniMax.
+5. “Excluded Territories” means the European Union, the United Kingdom, the Republic of Korea and the United States of America.  
+6. “MiniMax H3” means the video generation model, together with its software and algorithms, including trained model weights, parameters (including optimizer states), machine-learning model code, inference-supporting code, and other elements thereof made publicly available by Us, as released at https://huggingface.co/MiniMaxAI/MiniMax-H3.
+7. “MiniMax H3 Works” means (i) the Materials, (ii) the Model Derivatives, and (iii) all derivatives thereof.
+8. “Hosted Services” means hosted services provided via application programming interfaces (APIs), web access, or any other electronic or remote means.
+9. “Licensee,” “you,” or “your” means the natural or legal person exercising rights and/or using the MiniMax H3 Works for any purpose in any field of use under this Agreement.
+10. “Materials” means, collectively, MiniMax H3 and the Documentation (and any portion thereof), in each case as made available by MiniMax under this Agreement and proprietary to MiniMax.
+11. “Model Derivatives” means all of the following: (i) any modification of MiniMax H3 or any Model Derivative thereof; (ii) any work based on MiniMax H3 or any Model Derivative thereof; or (iii) any other machine learning model created by transferring the patterns of the weights, parameters, operational patterns, or Outputs of MiniMax H3 or any Model Derivative thereof to another model, such that the latter model exhibits behavior similar to MiniMax H3 or its Model Derivatives, including by distillation methods, methods using intermediate data representations, or methods based on training using synthetic-data Outputs generated by MiniMax H3 or its Model Derivatives. For the avoidance of doubt, Outputs are not deemed Model Derivatives.
+12. “Output” means any result of operating or otherwise using MiniMax H3 or any Model Derivatives (including through Hosted Services).
+13. “Third Party” means any natural or legal person that is not under common control with us or with you.
+14. “Including” means “including but not limited to.”
+15. “We,” “Us”  or  “MiniMax” means Nanonoble Pte. Ltd..
+II.  Grant of Rights
+Solely within the Applicable Territory, we grant you a non-exclusive, non-transferable, royalty-free, limited license to use, reproduce, distribute, create derivative works (including Model Derivatives), and modify the Materials in accordance with the terms of this Agreement and the Acceptable Use Policy, based on the intellectual property and other rights owned by MiniMax that are embodied in or used by the Materials. You shall not violate (or encourage or permit any person to violate) any term of this Agreement or the Acceptable Use Policy.
+We will continuously evaluate the applicable laws, regulations and compliance requirements for the Excluded Territories. In the meantime, should any person in such Excluded Territories be interested in deploying our models, you are welcome to contact us about obtaining a license, which will be granted based on robust controls and guardrails for purposes of complying with the laws, regulations and compliance requirements of the Excluded Territories.
+III.  Distribution and Redistribution
+Subject to and conditioned on your continuing compliance with this Agreement, including its territorial restrictions and the Acceptable Use Policy, and solely within the Applicable Territory, you may distribute or make available the MiniMax H3 Works to Third Parties within the Applicable Territory; provided, that all of the following conditions are met:
+1. You must provide a copy of this Agreement to all such Third Parties who receive the MiniMax H3 Works or use your products or services related thereto;
+2. You must cause any modified files to carry prominent notices stating that you have modified such files;
+3. You are encouraged to:
+  a. display a notice on any product or service developed using MiniMax H3 indicating that the product or service is “Powered by MiniMax H3”; 
+  b. add an AI-generation identifier to files produced using generative AI models including MiniMax H3; and
+  c. publish at least one technical blog post or a public statement describing your experience using MiniMax H3 Works;
+4. All distributions to Third Parties (other than through Hosted Services) must be accompanied by a “NOTICE” text file containing the following notice:
+  “MiniMax H3 is licensed under the MiniMax H3 Community License Agreement, Copyright © 2026 MiniMax. All Rights Reserved.”
+You may add your own copyright notices on your modifications; except as provided in this Section and in Section V, however, you may not impose additional or different terms and conditions on the use, reproduction, or distribution of your modifications or of any aggregate Model Derivatives, and your use, reproduction, modification, distribution, running, and display of the work must otherwise comply with the terms and conditions of this Agreement (including the provisions concerning the Applicable Territory). If you receive the MiniMax H3 Works from a Licensee as part of an integrated end-user product, the provisions of Section III of this Agreement do not apply to you, but Section V and Exhibit A remain applicable.
+IV.  Additional Commercial Terms
+1. You shall obtain a separate, prior written authorization from MiniMax by contacting api@minimax.io with the subject line “MiniMax H3 licensing - authorization request”, if your commercial products and services generate more than 20 million US dollars (or equivalent in other currencies) in yearly revenue.
+2. You shall prominently display “MiniMax H3”on the user interface of commercial product or service that uses MiniMax H3 or MiniMax H3 Works.
+V. Use Restrictions
+1. Your use of the MiniMax H3 Works must comply with applicable laws and regulations (including trade-compliance laws and regulations) and must comply with the Acceptable Use Policy for the MiniMax H3 Works, which is incorporated into this Agreement by reference. 
+2. Before providing access to the MiniMax H3 Works or any product, service, or Hosted Service incorporating them, you must bind each recipient or user to enforceable terms at least as protective as the use restrictions in this Section V and Exhibit A, and you must notify each recipient or user that those restrictions apply.
+3. You may not use the MiniMax H3 Works or any of their Outputs or results to improve any other artificial intelligence model (other than MiniMax H3 or its Model Derivatives).
+4. You may not use, reproduce, modify, distribute, or display the MiniMax H3 Works or any of their Outputs or results outside the Applicable Territory. Any such use outside the Applicable Territory is not authorized by this Agreement.
+5. If you provide or make available to any Third Party a product, service, or Hosted Service that permits the generation of Outputs using MiniMax H3 or any Model Derivative, you must, before making that product or service available and throughout its operation, implement, maintain, test, and periodically review reasonable and proportionate technical and organizational safeguards designed to prevent and mitigate access, uses, and Outputs that violate this Section V or Exhibit A, including uses or Outputs that infringe, misappropriate, or otherwise violate any Third Party’s intellectual-property or other rights. You must not knowingly disable, materially weaken, or permit the circumvention of those safeguards. You must maintain a reasonably accessible mechanism for reporting suspected violations. Upon receiving a good-faith report or otherwise obtaining actual knowledge of a violation, you must promptly investigate and take reasonable steps within your control to stop or mitigate the violation, including removing or disabling access to offending content or services and suspending or terminating repeat violators where appropriate. You are responsible for implementing and enforcing these requirements with respect to your products, services, systems, users, and downstream recipients.
+VI.  Intellectual Property
+1. Subject to MiniMax’s rights in the MiniMax H3 Works (and the intellectual property therein), and to your compliance with the terms and conditions of this Agreement, as between you and MiniMax, you will own the derivative works and modifications of the Materials that you have created or had created, as well as any Model Derivatives.
+2. Except for the limited license expressly granted in this paragraph, no trademark license is granted under this Agreement; with respect to MiniMax H3 Works, the Licensee may not use any name or mark owned by or associated with MiniMax or any of its affiliates, except as reasonably and customarily necessary to describe and distribute the MiniMax H3 Works. MiniMax hereby grants you a license to use the “MiniMax H3” mark (the “Mark”) within the Applicable Territory solely for the purpose of complying with Section III.3; provided, that you comply with all applicable trademark-protection laws. All goodwill arising from your use of the Mark shall inure to the benefit of MiniMax.
+3. If you bring or assert any suit or other legal proceeding (including a cross-claim or counterclaim in any action) against us or any other natural or legal person alleging that the Materials, any Output, or any portion of the foregoing infringes any intellectual property right or other right owned by you or for which you can obtain a license, all licenses granted to you under this Agreement will terminate as of the date such suit or proceeding is filed. You shall defend, indemnify, and hold us harmless against any Third-Party claim arising out of or related to the use or distribution of the MiniMax H3 Works by you or by any Third Party.
+4. MiniMax claims no rights over the Outputs you generate. You and your users are entirely responsible for the Outputs and any subsequent use thereof.
+VII.  Disclaimers and Limitations of Liability
+1. We have no obligation to support, update, provide training for, or develop any further version of the MiniMax H3 Works, or to grant any license with respect thereto.
+2. UNLESS AND ONLY TO THE EXTENT REQUIRED BY APPLICABLE LAW, THE MINIMAX H3 WORKS AND ANY OUTPUT AND RESULTS THEREFROM ARE PROVIDED “AS IS” WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES OF ANY KIND INCLUDING ANY WARRANTIES OF TITLE, MERCHANTABILITY, NONINFRINGEMENT, COURSE OF DEALING, USAGE OF TRADE, OR FITNESS FOR A PARTICULAR PURPOSE. YOU ARE SOLELY RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OF USING, REPRODUCING, MODIFYING, PERFORMING, DISPLAYING OR DISTRIBUTING ANY OF THE MINIMAX H3 WORKS OR OUTPUTS AND ASSUME ANY AND ALL RISKS ASSOCIATED WITH YOUR OR A THIRD PARTY’S USE OR DISTRIBUTION OF ANY OF THE MINIMAX H3 WORKS OR OUTPUTS AND YOUR EXERCISE OF RIGHTS AND PERMISSIONS UNDER THIS AGREEMENT.
+3. TO THE FULLEST EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL MINIMAX OR ITS AFFILIATES BE LIABLE UNDER ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, TORT, NEGLIGENCE, PRODUCTS LIABILITY, OR OTHERWISE, FOR ANY DAMAGES, INCLUDING ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, EXEMPLARY, CONSEQUENTIAL OR PUNITIVE DAMAGES, OR LOST PROFITS OF ANY KIND ARISING FROM THIS AGREEMENT OR RELATED TO ANY OF THE MINIMAX H3 WORKS OR OUTPUTS, EVEN IF MINIMAX OR ITS AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF ANY OF THE FOREGOING.
+VIII.  Term and Termination
+1. This Agreement is effective from the moment you accept this Agreement or begin accessing the Materials, and, subject to your compliance with its terms and conditions, will remain in effect until terminated as provided herein.
+2. If you breach any term or condition of this Agreement, we have the right to terminate this Agreement. Upon termination, you must immediately cease accessing, using, and distributing the MiniMax H3 Works; delete or destroy all copies within your possession or control; and notify each downstream recipient that your authorization has ended. The obligations in the preceding sentence and Sections VI.1, VI.3, VII, and IX survive termination.
+IX.  Governing Law and Jurisdiction
+1. This Agreement, and any dispute arising out of or related to this Agreement, shall be governed by the laws of the Hong Kong Special Administrative Region of the People’s Republic of China, without regard to its conflict-of-laws rules. The United Nations Convention on Contracts for the International Sale of Goods does not apply to this Agreement.
+2. Any dispute arising out of or related to this Agreement shall be subject to the exclusive jurisdiction of the courts of the Hong Kong Special Administrative Region of the People’s Republic of China with competent jurisdiction. Both MiniMax and the Licensee hereby consent to the exclusive jurisdiction of such courts for any such dispute.
+Additional Note: Please note that the encoder of MiniMax H3 uses Qwen3-VL-32B, which is licensed under Apache 2.0 License: https://github.com/QwenLM/Qwen3-VL/blob/main/LICENSE.
+
+Exhibit A — Acceptable Use Policy
+MiniMax reserves the right to update this Acceptable Use Policy from time to time. 
+Last revised: August 2, 2026.
+MiniMax is committed to promoting the safe and fair use of its tools and features, including MiniMax H3. You agree not to use MiniMax H3, any Model Derivatives, or any Output in any of the following ways:
+1. Use outside the Applicable Territory;
+2. Use in any manner that violates any applicable national, federal, state, local, or international law, regulation, or other legal requirement, or that infringes, misappropriates, or otherwise violates any Third Party’s intellectual-property or other proprietary rights, including through unauthorized reproduction, distribution, public display, public performance, or creation of derivative works;
+3. Use in any manner that may harm yourself or others;
+4. Use to repurpose or distribute the Outputs of MiniMax H3 or any Model Derivatives in order to harm yourself or others;
+5. Use to circumvent or bypass any safety guardrails or safeguards we have implemented;
+6. Use in any manner that exploits or harms, or intends to exploit or harm, minors;
+7. Use to generate or disseminate verifiably false information and/or content for the purpose of harming others or influencing elections;
+8. Use to manufacture or facilitate false online engagement, including fake reviews and other means of false online engagement;
+9. Use to intentionally defame, disparage, or otherwise harass others;
+10. Use to generate and/or disseminate malware (including ransomware) or any other content intended to damage electronic systems;
+11. Use to generate or disseminate personally identifiable information for the purpose of harming others;
+12. Use to generate or disseminate information (including images, code, posts, or articles) in or to any public environment (including via bot tweets or similar means) without clearly and prominently disclosing that such information and/or content is machine-generated;
+13. Use to impersonate another person without that person’s consent, authorization, or lawful right to do so;
+14. Use to make high-risk automated decisions in critical domains that affect individual safety, rights, or well-being (such as law enforcement, immigration, healthcare or medical services, critical-infrastructure management, product-safety components, essential services, credit, employment, housing, education, social scoring, or insurance);
+15. Use in any manner that violates or disregards the social, ethical, or moral standards of other countries or regions;
+16. Use to carry out, assist, threaten, incite, plan, advocate for, or encourage violent extremism or terrorism;
+17. Use for any purpose intended to discriminate against, or harm, individuals or groups based on protected characteristics or categories, online or offline social behavior, or known or predicted personality traits;
+18. Use to intentionally exploit the vulnerabilities of specific populations based on age, social, physical, or psychological characteristics, so as to materially distort the behavior of a member of that group in a manner that causes, or is likely to cause, physical or psychological harm to that person or to others;
+19. Use for military purposes;
+20. Use to engage in any unauthorized or unlicensed professional activity, including but not limited to financial, legal, medical or healthcare, or other professional practice.

NOTICE

@@ -0,0 +1,3 @@
+MiniMax H3 is licensed under the MiniMax H3 Community License Agreement, Copyright © 2026 MiniMax. All Rights Reserved.
+
+Modified by Akatz Labs: character-swap LoRA fine-tuning, 1,000 updates, September 2026. This repository contains adapter weights, not base-model weights.

README.md

@@ -0,0 +1,87 @@
+---
+language:
+- en
+license: other
+license_name: minimax-h3-community-license-agreement
+license_link: LICENSE
+base_model: Comfy-Org/MiniMax-H3
+base_model_relation: adapter
+pipeline_tag: video-to-video
+library_name: diffusion-single-file
+datasets:
+- akatz-ai/H3-Character-Swap-v1
+tags:
+- minimax-h3
+- lora
+- character-swap
+- video-editing
+- ref2va
+- comfyui
+- ai-toolkit
+---
+
+# MiniMax H3 Character Swap LoRA v1
+
+An experimental character-replacement LoRA trained by Akatz Labs for **1,000 updates**. It aims to replace a selected character using an image reference while preserving the source scene. In our local comparisons it often preserved the background more closely than the base model, but motion timing, facial expressions, and hard cuts remain unreliable.
+
+**Download:** [final 1,000-step LoRA](h3_character_swap_pro4500_1000.safetensors). Only the final 1,000-step checkpoint is published. Start with the final checkpoint at **strength 1.0**. This is an adapter, not a standalone model or a Turbo distillation LoRA.
+
+**Dataset:** [H3 Character Swap v1](https://huggingface.co/datasets/akatz-ai/H3-Character-Swap-v1).
+
+## Use
+
+1. Use an H3 Ref2VA-capable runtime and obtain the base model and VAEs separately.
+2. Place the final `.safetensors` file in `ComfyUI/models/loras/` (or your configured shared LoRA directory), and apply it to the H3 model at strength 1.0 using a compatible model-only LoRA loader.
+3. Supply the source video as `<Video 1>` and replacement image or character sheet as `<Picture 1>`.
+4. Specify the target person in the prompt. No additional trigger word was trained.
+
+Example:
+
+> Replace only the man in the purple shirt in <Video 1> with the character in <Picture 1>. Keep the replacement character's identity, outfit, and art style from <Picture 1>. Preserve the source video's camera, background, lighting, objects, and all other people. Match the target person's position, scale, pose, and movement. Do not show the reference sheet or its background.
+
+The training captions were shorter, for example `Swap the man in the purple shirt in <Video 1> with the character in <Picture 1>.` Preservation instructions helped some local evaluations, but stronger expression instructions sometimes suppressed the swap entirely. Prompt wording is not a guarantee of strict source alignment.
+
+Short, continuous shots of roughly 4–5 seconds were more promising than our full 14-second tests. A precise maximum duration has **not** been established. Use 24 fps and your runtime's supported H3 frame grid. The character-swap LoRA does not require a Turbo LoRA, Spectrum, or Sol attention.
+
+## Base model and tested configurations
+
+Training used `minimax_h3_ref2va_pruned_int8_convrot.safetensors` from [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3), plus the frozen [Ostris Ref2VA training assistant](https://huggingface.co/ostris/minimax_h3_training_adapter). The assistant and base weights are **not merged into this adapter** and are not distributed here. Model revisions and hashes are in `training/base-model-files.json`.
+
+We evaluated on the Ref2VA base and a local FL2VA/Ref2VA hybrid (blocks 25–49, INT8). A later experimental configuration combined this character-swap adapter with a separate 768p Turbo 8-step LoRA, `res_multistep` / `simple`, and native Sol attention. Those are evaluation choices, not the training base or universal compatibility claims. The local hybrid is not bundled. The text-to-video-only FastH3 experiment did not demonstrate a useful replacement workflow.
+
+## Training record
+
+| Setting | Recorded value |
+| --- | --- |
+| Updates / saves | 1,000 / every 250 updates |
+| Hardware | RunPod RTX PRO 4500 Blackwell, 32 GB |
+| LoRA rank / alpha | 16 / 16, excluding `adaln_proj` |
+| Optimizer / learning rate | AdamW8bit / 5e-5 |
+| Batch / accumulation | 1 / 1 |
+| Precision | BF16, convrot8 transformer, NVFP4 text encoder |
+| Edit target resolution | Area budget 1024; 1344×768 buckets |
+| Video regularization resolution | Reduced area budget 384 |
+| Regularization duration | 73 frames at 24 fps, approximately 3.04 seconds |
+| Memory measures | Gradient checkpointing, layer offload, cached latents/text, chunked MLP |
+| Sampling during training | Disabled |
+
+The dataset has 94 synthetic image-edit triplets and 40 unchanged video/audio examples. Optimization used **76 edits and 32 regularization clips**; 18 edits and 8 clips were held out. The edit targets are single still images, with five-frame static source-video controls. This is **not** training on long moving character-swap targets. AI Toolkit interleaves regularization, so file-count ratios are not update ratios. The data include cross-style swaps and varied character sheets, but only one-character replacement targets.
+
+The author estimates the overnight rental at around $11; this is not a measured cost benchmark. `training/train-1000-noeval.json` records the run configuration, with inactive local evaluation paths removed. The launcher and package snapshot are supplied for reference. The copied AI Toolkit source was not a Git checkout, so the embedded version label is not an exact source revision. See the dataset's runtime-contract fingerprints.
+
+## Findings and limitations
+
+- Local side-by-side reviews suggest improved scene/background preservation relative to the base model. These are qualitative observations, not a benchmark score.
+- Long windows can drift in framing, placement, or source timing. Hard cuts can become zooms or gradual repositioning.
+- Close-up facial expressions may not match the original performance; added expression prompting was not consistently helpful.
+- Two-character inference was tested, but multi-character replacements were not supervised in the training targets.
+- Short-window continuation improved some joins but did not guarantee camera-cut timing or full source adherence.
+- Generated audio was closer in some early LoRA comparisons but skipped or drifted in the continuation test. The later review used original source audio copied onto the generated video. That audio preservation is **postprocessing**, not proof of the LoRA's audio fidelity; remuxing does not repair lip-sync drift.
+
+Next experiments include aligned moving swap targets, explicit hard-cut examples, expression supervision, and longer sequences. More VRAM alone is not a demonstrated quality fix.
+
+## License and attribution
+
+This adapter is distributed under the [MiniMax H3 Community License Agreement](LICENSE), including its acceptable-use, distribution, commercial, and territorial provisions. **It is not Apache-2.0.** The agreement excludes the US, EU, UK, and Republic of Korea from its standard territorial grant and describes separate authorization. Read the complete upstream terms; this repository does not expand them. See NOTICE for attribution and the modification notice.
+
+The separately published dataset uses Apache-2.0 for Akatz Labs contributions and preserves the upstream VidGen license/provenance. Its license does not replace this model's terms.

SHA256SUMS

@@ -0,0 +1,8 @@
+59b99642b95ea21630e311198ddbfffbfe05aadba0c2f5d884cbdf4efcc90f44  LICENSE
+a48642bdfdf17dc2e22b08c737b6fdf37cd0d5eb3f0641a5cb30bd7fcbc88378  NOTICE
+54ae4176209198aa1d632a8195d0c5f6d2083b364c1047d60191f7cdd6e59468  README.md
+4b2a3f420ae804c0aa3422761ff84dbd1bf52eef6900ffab6d2e66df63cb4e79  h3_character_swap_pro4500_1000.safetensors
+a4871c95fb7f74d88ff60c4cbb82cf05c65bc309f684efefb1572f87b25e4581  training/base-model-files.json
+79d4ebdbb1195e882629adbc7ec27640bd4a42bc24ae5a2961474667992b2e5d  training/requirements-pinned.txt
+4aabe5d9758a926787eca28fe1bec142ca78160ba25b41d0dc5ab4b437c5e5ca  training/train-1000-noeval.json
+f574f99af8a96af93ddf8967f441495ccc7ea21135d89e3b9f80671cd4097a3d  training/train-launcher.py

h3_character_swap_pro4500_1000.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4b2a3f420ae804c0aa3422761ff84dbd1bf52eef6900ffab6d2e66df63cb4e79
+size 155110320

training/base-model-files.json

@@ -0,0 +1,42 @@
+[
+  {
+    "repo": "Comfy-Org/MiniMax-H3",
+    "revision": "1c41cfca8ebba91d0af792a05c5761fb2c3a7975",
+    "filename": "diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors",
+    "destination": "diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors",
+    "size": 20970379616,
+    "sha256": "9255f52b6677845ad238f20dfaafa94727053694127ab7f255c048f0f9365779"
+  },
+  {
+    "repo": "Comfy-Org/MiniMax-H3",
+    "revision": "1c41cfca8ebba91d0af792a05c5761fb2c3a7975",
+    "filename": "text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors",
+    "destination": "text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors",
+    "size": 15687142551,
+    "sha256": "35a88d51044231fe332301d7a62aa81e3f2cba62febeb446e2c1e3e0ef76f2c6"
+  },
+  {
+    "repo": "Comfy-Org/MiniMax-H3",
+    "revision": "1c41cfca8ebba91d0af792a05c5761fb2c3a7975",
+    "filename": "vae/minimax_h3_video_vae_fp16.safetensors",
+    "destination": "vae/minimax_h3_video_vae_fp16.safetensors",
+    "size": 5207808496,
+    "sha256": "7c1f131492e7eddacaac9069a61b81bdd39de5cc96561e677c5eab1cdce5e522"
+  },
+  {
+    "repo": "Comfy-Org/MiniMax-H3",
+    "revision": "1c41cfca8ebba91d0af792a05c5761fb2c3a7975",
+    "filename": "vae/minimax_h3_audio_vae_fp32.safetensors",
+    "destination": "vae/minimax_h3_audio_vae_fp32.safetensors",
+    "size": 605254808,
+    "sha256": "8e505d95dd1561d47abd43d4238fd40d9bb1ae9e147ed0a4cba778d76ae4db48"
+  },
+  {
+    "repo": "ostris/minimax_h3_training_adapter",
+    "revision": "b2e664cb0bba5d96f3ab02fc142c825d4b2409e1",
+    "filename": "minimax_h3_ref2va_training_adapter_v1.safetensors",
+    "destination": "loras/minimax_h3_ref2va_training_adapter_v1.safetensors",
+    "size": 155110344,
+    "sha256": "79611559f85712b9ed3bd8a4009d07294dcf88b62ac566051128cfb65d87e0de"
+  }
+]

training/requirements-pinned.txt

@@ -0,0 +1,158 @@
+ImageIO==2.37.4
+Jinja2==3.1.6
+Markdown==3.10.3
+MarkupSafe==3.0.3
+PyWavelets==1.10.0
+PyYAML==6.0.3
+Pygments==2.21.0
+Werkzeug==3.1.8
+absl-py==2.5.0
+accelerate==1.15.0
+albucore==0.0.16
+albumentations==1.4.15
+annotated-doc==0.0.5
+annotated-types==0.8.0
+antlr4-python3-runtime==4.9.3
+anyio==4.15.1
+audioread==3.1.0
+av==16.0.1
+bitsandbytes==0.50.2
+brotli==1.2.0
+certifi==2026.7.22
+cffi==2.1.1
+charset-normalizer==3.5.1
+click==8.5.0
+cloudpickle==3.1.2
+contourpy==1.3.3
+controlnet_aux==0.0.10
+cuda-bindings==12.9.7
+cuda-pathfinder==1.6.0
+cuda-toolkit==12.8.1
+cycler==0.12.1
+decorator==5.3.1
+einops==0.8.2
+eval_type_backport==0.4.0
+fastapi==0.141.1
+filelock==3.32.3
+flatten-json==0.1.14
+fonttools==4.65.0
+fsspec==2026.7.0
+ftfy==6.3.1
+gradio==6.27.0
+gradio_client==2.7.0
+groovy==0.1.2
+grpcio==1.84.0
+h11==0.16.0
+hf-gradio==0.4.1
+hf-xet==1.6.0
+hf_transfer==0.1.9
+httpcore==1.0.9
+httpx==0.28.1
+huggingface_hub==1.23.0
+idna==3.19
+importlib_metadata==9.0.1
+invisible-watermark==0.2.0
+joblib==1.6.0
+kiwisolver==1.5.1
+kornia==0.8.3
+kornia_rs==0.1.14
+lazy-loader==0.5
+librosa==0.11.0
+llvmlite==0.49.0
+lpips==0.1.4
+lycoris_lora==1.8.3
+markdown-it-py==4.2.0
+matplotlib==3.10.1
+mdurl==0.1.2
+mpmath==1.3.0
+msgpack==1.2.2
+mutagen==1.47.0
+narwhals==2.26.0
+networkx==3.6.1
+ninja==1.13.2
+numba==0.67.0
+numpy==1.26.4
+nvidia-cublas-cu12==12.8.4.1
+nvidia-cuda-cupti-cu12==12.8.90
+nvidia-cuda-nvrtc-cu12==12.8.93
+nvidia-cuda-runtime-cu12==12.8.90
+nvidia-cudnn-cu12==9.19.0.56
+nvidia-cufft-cu12==11.3.3.83
+nvidia-cufile-cu12==1.13.1.3
+nvidia-curand-cu12==10.3.9.90
+nvidia-cusolver-cu12==11.7.3.90
+nvidia-cusparse-cu12==12.5.8.93
+nvidia-cusparselt-cu12==0.7.1
+nvidia-nccl-cu12==2.28.9
+nvidia-nvjitlink-cu12==12.8.93
+nvidia-nvshmem-cu12==3.4.5
+nvidia-nvtx-cu12==12.8.90
+omegaconf==2.3.1
+open_clip_torch==3.3.0
+opencv-python-headless==4.11.0.86
+opencv-python==4.11.0.86
+optimum-quanto==0.2.4
+orjson==3.12.0
+oyaml==1.0
+packaging==26.3
+pandas==3.0.5
+peft==0.18.1
+pillow==12.3.0
+platformdirs==4.11.8
+pooch==1.9.0
+prodigyopt==1.1.2
+protobuf==7.36.1
+psutil==7.2.2
+pycparser==3.0
+pydantic==2.13.5
+pydantic_core==2.46.5
+pydub==0.25.1
+pyparsing==3.3.2
+python-dateutil==2.9.0.post0
+python-dotenv==1.2.3
+python-multipart==0.0.32
+python-slugify==9.0.0
+pytorch-fid==0.3.0
+pytorch-wavelets==1.3.0
+pytz==2026.3.post1
+regex==2026.9.10
+requests==2.34.2
+rich==15.0.0
+safehttpx==0.1.7
+safetensors==0.9.0rc0
+scikit-image==0.26.0
+scikit-learn==1.9.1
+scipy==1.12.0
+semantic-version==2.10.0
+sentencepiece==0.2.2
+setuptools==78.1.0
+shellingham==1.5.4
+six==1.17.0
+soundfile==0.14.0
+soxr==1.1.0
+starlette==1.6.0
+sympy==1.14.0
+tensorboard-data-server==0.7.2
+tensorboard==2.21.0
+text-unidecode==1.3
+threadpoolctl==3.6.0
+tifffile==2026.3.3
+timm==1.0.22
+tokenizers==0.22.2
+toml==0.10.2
+tomlkit==0.14.0
+torch==2.11.0+cu128
+torchao==0.10.0
+torchaudio==2.11.0+cu128
+torchcodec==0.11.0+cpu
+torchvision==0.26.0+cu128
+tqdm==4.70.1
+transformers==5.5.3
+triton==3.6.0
+typer==0.27.2
+typing-inspection==0.4.4
+typing_extensions==4.16.0
+urllib3==2.7.0
+uvicorn==0.53.0
+wcwidth==0.8.3
+zipp==4.1.0

training/train-1000-noeval.json

@@ -0,0 +1,145 @@
+{
+  "job": "extension",
+  "config": {
+    "name": "h3_character_swap_pro4500_1000",
+    "process": [
+      {
+        "type": "sd_trainer",
+        "training_folder": "${H3_OUTPUT_ROOT}",
+        "device": "cuda:0",
+        "network": {
+          "type": "lora",
+          "linear": 16,
+          "linear_alpha": 16,
+          "network_kwargs": {
+            "ignore_if_contains": [
+              "adaln_proj"
+            ]
+          }
+        },
+        "save": {
+          "dtype": "bf16",
+          "save_every": 250,
+          "max_step_saves_to_keep": 4,
+          "push_to_hub": false
+        },
+        "datasets": [
+          {
+            "caption_ext": "txt",
+            "default_caption": "",
+            "resolution": 1024,
+            "fps": 24,
+            "buckets": true,
+            "cache_latents_to_disk": true,
+            "caption_dropout_rate": 0,
+            "random_crop": false,
+            "flip_x": false,
+            "flip_y": false,
+            "num_workers": 0,
+            "cache_latents_num_workers": 1,
+            "full_size_control_images": true,
+            "shrink_video_to_frames": true,
+            "folder_path": "${H3_DATASET_ROOT}/data/edits/train/targets",
+            "control_path": [
+              "${H3_DATASET_ROOT}/data/edits/train/character_references",
+              "${H3_DATASET_ROOT}/data/edits/train/scene_videos"
+            ],
+            "num_frames": 1,
+            "auto_frame_count": true,
+            "trim_auto_frame_count_tail": true,
+            "do_audio": false
+          },
+          {
+            "caption_ext": "txt",
+            "default_caption": "",
+            "resolution": 384,
+            "fps": 24,
+            "buckets": true,
+            "cache_latents_to_disk": true,
+            "caption_dropout_rate": 0,
+            "random_crop": false,
+            "flip_x": false,
+            "flip_y": false,
+            "num_workers": 0,
+            "cache_latents_num_workers": 1,
+            "full_size_control_images": true,
+            "shrink_video_to_frames": true,
+            "folder_path": "${H3_DATASET_ROOT}/data/regularization/train/videos",
+            "control_path": "${H3_DATASET_ROOT}/data/regularization/train/videos",
+            "num_frames": 73,
+            "auto_frame_count": false,
+            "do_audio": true,
+            "is_reg": true,
+            "audio_normalize": false
+          }
+        ],
+        "train": {
+          "batch_size": 1,
+          "steps": 1000,
+          "gradient_accumulation_steps": 1,
+          "train_unet": true,
+          "train_text_encoder": false,
+          "cache_text_embeddings": true,
+          "skip_first_sample": true,
+          "gradient_checkpointing": true,
+          "noise_scheduler": "flowmatch",
+          "timestep_type": "shift",
+          "optimizer": "adamw8bit",
+          "optimizer_params": {
+            "weight_decay": 0.0001
+          },
+          "lr": 5e-05,
+          "weight_decay": 0.0001,
+          "dtype": "bf16",
+          "do_guidance_loss": true,
+          "guidance_loss_target": 3.5,
+          "disable_sampling": true
+        },
+        "model": {
+          "name_or_path": "Comfy-Org/MiniMax-H3",
+          "arch": "minimax_h3_ref2va",
+          "quantize": true,
+          "qtype": "convrot8",
+          "quantize_te": true,
+          "qtype_te": "nvfp4",
+          "low_vram": true,
+          "layer_offloading": true,
+          "layer_offloading_transformer_percent": 1.0,
+          "layer_offloading_text_encoder_percent": 1.0,
+          "assistant_lora_path": "${H3_MODEL_ROOT}/loras/minimax_h3_ref2va_training_adapter_v1.safetensors",
+          "model_kwargs": {
+            "image_refs_as_video": false,
+            "image_ref_video_frames": 5,
+            "partition": "ref2va_pruned",
+            "dit_ref2va_pruned_path": "${H3_MODEL_ROOT}/diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors",
+            "text_encoder_path": "${H3_MODEL_ROOT}/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors",
+            "video_vae_path": "${H3_MODEL_ROOT}/vae/minimax_h3_video_vae_fp16.safetensors",
+            "audio_vae_path": "${H3_MODEL_ROOT}/vae/minimax_h3_audio_vae_fp32.safetensors",
+            "sample_audio": false
+          }
+        },
+        "sample": {
+          "neg": "",
+          "sampler": "flowmatch",
+          "sample_every": 250,
+          "sample_start_step": 0,
+          "width": 1344,
+          "height": 768,
+          "num_frames": 73,
+          "fps": 24,
+          "guidance_scale": 1,
+          "sample_steps": 28,
+          "sample_audio": true,
+          "seed": 904231,
+          "samples": [],
+          "ext": "mp4",
+          "walk_seed": false
+        }
+      }
+    ]
+  },
+  "meta": {
+    "name": "h3-character-swap-v1",
+    "version": "1.0.0"
+  }
+}

training/train-launcher.py

@@ -0,0 +1,71 @@
+import os,sys,runpy,traceback,json,time
+config_path=os.path.abspath(sys.argv[1])
+root=os.environ['AI_TOOLKIT_ROOT']
+os.chdir(root);sys.path.insert(0,root)
+from extensions_built_in.sd_trainer.SDTrainer import SDTrainer
+import torch
+from torch.utils.checkpoint import checkpoint
+from extensions_built_in.diffusion_models.minimax_h3.src.transformer import MiniMaxH3Mlp
+mlp_forward=MiniMaxH3Mlp.forward
+def chunked_mlp(self,x):
+ if x.shape[-2] <= 1024:
+  return mlp_forward(self,x)
+ return torch.cat([checkpoint(mlp_forward,self,c,use_reentrant=False) if torch.is_grad_enabled() else mlp_forward(self,c) for c in x.split(1024,dim=-2)],dim=-2)
+# Check values and gradients on the tokenwise operation before loading weights.
+torch.manual_seed(123)
+m=MiniMaxH3Mlp(16,32).double()
+a=torch.randn(1,2051,16,dtype=torch.float64,requires_grad=True)
+b=a.detach().clone().requires_grad_(True)
+y=mlp_forward(m,a); y.square().sum().backward()
+expected=[p.grad.clone() for p in m.parameters()]; m.zero_grad()
+z=chunked_mlp(m,b); z.square().sum().backward()
+assert torch.allclose(y,z,atol=1e-10,rtol=1e-10)
+assert torch.allclose(a.grad,b.grad,atol=1e-10,rtol=1e-10)
+assert all(torch.allclose(e,p.grad,atol=1e-9,rtol=1e-9) for e,p in zip(expected,m.parameters()))
+print('CHUNK_PARITY_PASS: outputs, input gradients, parameter gradients',flush=True)
+del m,a,b,y,z,expected
+MiniMaxH3Mlp.forward=chunked_mlp
+
+# Freeze evaluation conditioning with the full 73-frame video context.
+# Upstream cache_sample_prompts constructs GenerateImageConfig without num_frames,
+# which silently limits reference video conditioning to five frames.
+from PIL import Image
+from toolkit.config_modules import GenerateImageConfig
+def cache_eval_prompts(self):
+ if self.train_config.disable_sampling:
+  return
+ vae_device=self.sd.vae.device
+ self.sd.vae.to("cpu")
+ torch.cuda.empty_cache()
+ self.sd.sample_prompts_cache=[]
+ for item in self.sample_config.samples:
+  gen=GenerateImageConfig(prompt=item.prompt,width=item.width,height=item.height,num_frames=item.num_frames,fps=item.fps,ctrl_img_1=item.ctrl_img_1,ctrl_img_2=item.ctrl_img_2,output_path='/tmp/h3-unused.mp4')
+  self.sd.prepare_sample_prompt_context(gen)
+  with torch.no_grad():
+   emb=self.sd.get_prompt_embeds(item.prompt,control_images=[Image.open(item.ctrl_img_1).convert('RGB'),item.ctrl_img_2]).to('cpu')
+  self.sd.sample_prompts_cache.append({'conditional':emb,'unconditional':emb})
+ self.sd.vae.to(vae_device)
+ print('EVAL_PROMPTS_CACHED: full 73-frame reference context',flush=True)
+SDTrainer.cache_sample_prompts=cache_eval_prompts
+torch.set_num_threads(16)
+torch.set_num_interop_threads(4)
+
+original=SDTrainer.hook_train_loop
+def traced(self,batch):
+ bs=batch if isinstance(batch,list) else [batch]
+ info={'step':self.step_num,'regularization':[b.get_is_reg_list() for b in bs]}
+ print('SMOKE_STEP_START '+json.dumps(info),flush=True)
+ torch.cuda.synchronize(); started=time.monotonic()
+ torch.cuda.reset_peak_memory_stats()
+ try:
+  result=original(self,batch)
+ except Exception:
+  traceback.print_exc()
+  print('SMOKE_MEMORY '+json.dumps(dict(allocated=torch.cuda.max_memory_allocated(),reserved=torch.cuda.max_memory_reserved())),flush=True)
+  raise ValueError('Smoke batch failed; aborting rather than skipping')
+ torch.cuda.synchronize()
+ print('SMOKE_STEP_PASS '+json.dumps(dict(**info,elapsed_s=time.monotonic()-started,peak_allocated=torch.cuda.max_memory_allocated(),peak_reserved=torch.cuda.max_memory_reserved())),flush=True)
+ return result
+SDTrainer.hook_train_loop=traced
+sys.argv=[root+'/run.py',config_path]
+runpy.run_path(root+'/run.py',run_name='__main__')