# Compatibility

This page summarizes the supported user-facing boundary for ComfyUI-Sigmax 1.0.0.

## Environment

| Component | Supported boundary |
| --- | --- |
| Python | 3.10 or newer |
| ComfyUI package requirement | 0.29.0 or newer |
| Validated host baseline | ComfyUI 0.29.0 |
| Operating systems covered by project gates | Windows and Linux/WSL |
| Mandatory additional Python packages | None |

A newer ComfyUI version may work, but it is not automatically promoted to the validated host
baseline. When behavior changes after a ComfyUI update, first reproduce the workflow on the
validated baseline.

## Supported model profiles

| Profile | Supported schedule | User selection |
| --- | --- | --- |
| Krea 2 Turbo | Fixed-shift external sigma schedule, 8-step official recipe | Select `Turbo` explicitly when model evidence is ambiguous |
| Krea 2 RAW | Resolution-aware external sigma schedule, official 52-step and framework-reference 28-step recipes | Select `RAW` explicitly and provide the actual width and height |
| Z-Image Base | Fixed-ratio external sigma schedule, 28-50 steps | Select `Base` explicitly |
| Z-Image Turbo | Fixed-ratio external sigma schedule, 8-step official recipe | Select `Turbo` explicitly |
| FLUX.1-schnell | Unshifted external sigma schedule, 1-4 steps | Use the dedicated FLUX.1-schnell node |
| Original Qwen Image | ComfyUI fixed `1.15` shift, or Diffusers dynamic shift with explicit `image_seq_len`; original T2I only | Use `Sigmax.QwenImageSigmaScheduler`; select the mode explicitly |
| Original Stable Diffusion 3 | Original SD3 Medium T2I only; explicit publisher-reference `1.0` or ComfyUI/Diffusers fixed `3.0` shift | Use `Sigmax.SD3SigmaScheduler`; select the source mode explicitly |
| Original AuraFlow v0.2 | Fixed unit-flow `1.73` ratio shift, original 50-step recipe | Use `Sigmax.AuraFlowSigmaScheduler`; select `Official Fixed (1.73)` explicitly |
| Lumina-Image 2.0 | Fixed unit-flow `6.0` ratio shift, original 50-step recipe | Use `Sigmax.Lumina2SigmaScheduler`; select `Official Fixed (6.0)` explicitly |
| HunyuanImage 2.1 Base | Fixed unit-flow `5.0` ratio shift, official 50-step recipe; schedule-only | Use `Sigmax.HunyuanImage21SigmaScheduler`; select `Base (5.0)` explicitly |
| HunyuanImage 2.1 Distilled | Fixed unit-flow `4.0` ratio shift, official 8-step publisher recipe; native host path unqualified | Use `Sigmax.HunyuanImage21SigmaScheduler`; select `Distilled (4.0)` explicitly |
| Anima Base / Aesthetic | Fixed unit-flow rational `3.0` shift, 30-50 step framework-reference recipe; schedule-only | Use `Sigmax.AnimaSigmaScheduler`; select `Base` or `Aesthetic` explicitly |
| Anima Turbo | Fixed unit-flow rational `3.0` shift, 8-12 step framework-reference recipe; schedule-only | Use `Sigmax.AnimaSigmaScheduler`; select `Turbo` explicitly |
| Wan 2.1 T2V | Source-qualified unit-flow direct-ratio shift (`5.0` official, `8.0` ComfyUI-native, `3.0` Diffusers reference), 50-step recipes | Use `Sigmax.WanSigmaScheduler`; select generation, task, source, and `None` resolution explicitly |
| Wan 2.1 I2V | Resolution-qualified official/Diffusers-reference paths: 480P `3.0` and 720P `5.0`, 40-step recipes | Use `Sigmax.WanSigmaScheduler`; select `I2V` and the actual `480P` or `720P` class |
| Wan 2.2 TI2V 5B | Native and Diffusers-reference unit-flow `5.0` shift, 50-step recipes | Use `Sigmax.WanSigmaScheduler`; select `TI2V` and the source explicitly |
| Wan 2.2 A14B T2V/I2V | Source-qualified unit-flow paths with caller-owned boundaries; native T2V/I2V `12.0`/`5.0`, Diffusers references `3.0` | Use `Sigmax.WanSigmaScheduler`; boundary output is metadata only and never routes experts |
| LTXV 0.9.8 / LTX-2 19B / LTX-2.3 22B | Dev token-count adaptive shift; LTX-2/LTX-2.3 distilled Stage 1/2 immutable vectors; schedule-only | Use `Sigmax.LTXSigmaScheduler`; select generation and stage explicitly |

The experimental `Sigmax.Krea2ConditioningRebalance` node accepts explicit RAW or Turbo
`CONDITIONING` tensors with shape `(batch, sequence, 30720)`. It preserves standard ComfyUI
metadata and performs no scheduler or model mutation. Its profiles are community-derived and
experimental; this boundary does not claim prompt adherence or image-quality improvement.

The generic advanced FlowMatch node constructs explicit schedule math only. It is experimental
and does not establish compatibility with an arbitrary model.

## Usage boundary

- Sigmax produces sigma schedules; it does not replace the numerical sampler.
- External Sigmax sigmas must not be shifted or scheduled a second time.
- Krea 2 `Auto` selection fails closed when evidence identifies the family but not RAW versus
  Turbo.
- Checkpoint header inspection does not load weights and cannot confirm a model variant from weak
  filename or structural evidence.
- Slicing, concatenating, or resampling a schedule changes its evidence status to modified.
- Model weights must be obtained separately under their own licenses and access terms.
- Qwen Image dynamic mode requires an explicit packed image sequence length; it never falls back
  to the fixed mode when that input is absent.
- SD3 source modes are intentionally non-composable. The publisher 1.0 and ComfyUI/Diffusers 3.0
  values are separate evidence lanes, not a silent default selection.
- AuraFlow v0.2 uses one fixed model-native ratio shift. Do not apply a second shift or pass
  already-shifted sigmas to the node.
- Lumina-Image 2.0 uses one fixed model-native ratio shift. Do not apply a second shift or pass
  already-shifted sigmas to the node.
- HunyuanImage 2.1 uses one direct-ratio shift per explicit variant. The Base lane is host-compatible
  at the pinned baseline; Distilled is schedule-only and must not be presented as native host parity.
- HunyuanImage 2.1 model weights remain under Tencent's community license and are not distributed by
  Sigmax; this package does not include model code, weights, encoders, or conditioning.
- Anima applies one fixed rational `3.0` shift and rejects already-shifted composition. The node
  does not load Anima weights, run conditioning, or establish image-quality or prompt-adherence claims;
  Anima weight files remain under CircleStone Labs and applicable derivative licenses.
- Wan profiles keep ComfyUI-native, official-native, and Diffusers-reference shift ownership
  separate. A Wan 2.1 I2V resolution is mandatory, and unsupported derivatives fail closed.
- Wan 2.2 A14B boundaries are descriptive caller-owned split metadata; Sigmax does not select high
  or low experts, load video weights, patch the model, or implement a video sampler.
- Wan Diffusers-reference rows document scheduler sigma/timestep construction only; they do not
  claim UniPC solver parity when consumed by an Euler sampler.
- LTX generation and stage are explicit; Dev token shifting and distilled vectors are separate
  lanes. LTX profiles do not load video weights or claim video-quality parity.

## Not currently claimed

- Real-model GPU execution or image-quality parity.
- Stochastic, resumable, or interrupted sampler state.
- Partial-denoise execution and advanced model-patch workflows.
- Automatic compatibility with unlisted model families.
- Guaranteed compatibility with every future ComfyUI release.
- AuraFlow v0.1/v0.3, PonyFlow, Wan derivatives (FLF2V/VACE/Fun-Control and similar), community
  finetunes, or real-model image-quality parity.

If a workflow falls outside these boundaries, treat it as unvalidated rather than silently
substituting another profile or schedule.