LokkenJP/10Eros_Max_optimized_w4a8_exp_learned

10Eros Max H3 Turbo-hybrid beta5 — proxy-activation W4A8 / INT8 ConvRot

[!WARNING] PlagueKind H3 MiniMax Cache users: A reported interaction with ComfyUI's AIMDO model compiler can cause aimdo memory compile error: could not start recording. Bypass that cache node if affected. See Format and compatibility below.

This repository contains quality-oriented, weight-only quantizations of TenStrip/10Eros-Max for ComfyUI. The current root release is the proxy-activation-informed beta5 checkpoint:

10Eros_Max_h3_TURBO-hybrid_beta5_proxy_activation_balanced_final_14_5gb_v5.safetensors

Keep its accompanying files:

10Eros_Max_h3_TURBO-hybrid_beta5_proxy_activation_balanced_final_14_5gb_v5.safetensors.sha256
10Eros_Max_h3_TURBO-hybrid_beta5_proxy_activation_balanced_final_14_5gb_v5.safetensors.quantization.json

Earlier non-proxy learned releases remain under `BasicLearned/`, and the first accepted proxy-activation release remains under `ProxyActivatedLearned_v1/`. They are preserved for provenance and comparison and are not the current default.

A working learned W4A8 conversion of the non-Turbo beta5 transformer is also available as `BasicLearned/10Eros_Max_h3_hybrid_beta5_w4a8_14gb_optimized.safetensors` in this repository's BasicLearned/ folder. It is a completed and runtime-tested legacy alternative for users who specifically want the non-Turbo beta5 model, but it predates this proxy-activation campaign and is not the current recommended release in this repository.

This is a transformer-only derivative precision conversion. It does not contain the text encoder, video/audio VAE, vocoder, or workflow. Use the same compatible H3 ecosystem components as the source checkpoint. A sample two-pass workflow is included.

Content notice: the source repository is marked Not-For-All-Audiences. The same usage and content considerations apply to this derivative.

Current artifact

The final map covers the four large projection matrices in each of the 50 main transformer blocks:

Blocks 0--1 and 47--49 receive exact admitted INT8-p20 protection. Blocks 44--46 receive an additional W4-g8-or-better floor.

“Proxy-activation-calibrated” describes the offline W4 candidate learning, code refinement, scoring, and selection. The published W4 tensors remain the standard native weight-only asym_w4a8_int8 format and require no calibration activations at inference time.

What “proxy activation” means

This release uses activations captured from a representative beta5 proxy checkpoint to estimate how quantization error propagates through real H3 input distributions. Calibration and prompt-disjoint development trajectories guide the offline W4 rounding refinements, selective learned INT8 candidates, safety guards, and final byte-budget allocation. The distributed checkpoint remains a weight-only W4A8/INT8 model; it does not require activation data at inference.

W4 construction has two stages. The activation-aware base learner first optimizes discrete codes and stored scales and can update the native-format 16-entry codebook through an exact-tested quadratic proposal followed by code reassignment. The final cumulative v5.7 refinement then freezes those already learned same-release scales and codebooks while combining exact bounded micro-greedy code changes with binary AdamW relaxation in both cumulative orders. A final population-wide, benefit-dependent microgreedy polish then evaluates up to eight adjacent-code passes for the W4-g16/g8 families that can participate in the protected allocation. This polish occurs before allocation; the assembler only materializes already validated payloads. A separate control panel found no better retained candidate from another joint-scale or codebook- polish pass. INT8 candidates use row-wise ConvRot with fixed scales and learned top_p=0.20 rounding. Candidate selection uses calibration evidence; development trajectories are audit evidence rather than a selection input.

For the capture design, mathematical objectives, W4/INT8 optimization, allocation, validation infrastructure, and numerical results, see [Proxy-activation technical overview](./H3_PROXY_ACTIVATION_TECHNICAL_OVERVIEW.md).

Format and compatibility

The W4 representation is ComfyUI-native asym_w4a8_int8: packed W4 codes, FP8 E4M3 relative group scales, FP32 channel scales, a per-matrix 16-entry FP32 codebook, and ConvRot group 256. INT8 matrices use standard row-wise INT8 ConvRot with FP32 row scales and ConvRot group 256.

Use a current ComfyUI build with MiniMax H3 and native W4A8 ConvRot support, together with compatible Comfy Kitchen dependencies. Install the checkpoint in the diffusion-model location used by your H3 workflow and select it as the transformer/diffusion model.

Third-party cache compatibility: If PlagueKind's experimental H3 MiniMax Cache node triggers aimdo memory compile error: could not start recording, bypass that node. Restarting ComfyUI with --disable-comfy-compiler can be used as a diagnostic workaround, although it may reduce performance. This interaction does not by itself indicate checkpoint corruption.

Runtime memory depends on resolution, frame count, attention backend, LoRAs, the W4/INT8 mixture, and other resident models. The 14.5 GB figure is the checkpoint's decimal file cap, not total runtime VRAM. INT8 weights use more resident bytes than packed W4 weights; near a hardware limit, a higher INT8 share can reduce headroom and trigger additional offloading even when the checkpoint remains within its disk-size cap.

Validation and operator evaluation

• —[x] The source-bound v5.5/v5.7 W4 populations, the final balanced microgreedy W4 population, and both INT8 populations passed their authoritative validators.
• —[x] The frozen 200-matrix map passed exact size, header, descriptor, candidate-digest, preserved-byte, resume, and SHA-256 validation.
• —[x] The final checkpoint loaded and generated successfully in the target ComfyUI workflow.
• —[x] In the completed focused audio/video A/B set, every tested output was equivalent or superior overall to the preceding proxy-activation variants. The operator judged video and audio quality very good and promoted v5 as the definitive beta5 release.
• —[x] Known proxy-family caveats remain: slight behavior drift from source beta5 despite prompt compliance, and occasional slight unwanted-audio or speech hallucinations.
• —[x] V5 appeared slightly slower and more memory-hungry than some predecessors; controlled timing, transfer, and VRAM traces were not recorded.

The final observations are practical operator checks, not a controlled or repository-reproducible benchmark. Do not generalize the perceived improvement to every prompt, seed, LoRA, resolution, or workflow.

Technical provenance and license

The quantization method and retained evidence are documented in the companion quantization repository. The W4A8 and INT8 ConvRot layouts are provided by Comfy Kitchen and follow ComfyUI's quantization format.

This is an experimental derivative precision conversion, not an official upstream checkpoint. No ownership of the source model, training data, or associated workflows is claimed. This conversion grants no additional rights. Comply with the source checkpoint's license, terms, and content/use requirements, along with those of the surrounding inference components.