From a637dfdbb36c539ca563e52a3d8886eaac04f977 Mon Sep 17 00:00:00 2001 From: Morpheus Date: Wed, 28 Oct 2026 16:45:05 +0000 Subject: [PATCH] Organize Flux 3 Klein tests by image mode --- optimized/I2I/flux3klein/README.md | 9 ++++ optimized/I2I/flux3klein/variables.json | 7 ++++ optimized/MultipleRef2I/flux3klein/README.md | 9 ++++ .../MultipleRef2I/flux3klein/variables.json | 7 ++++ optimized/T2I/flux3klein/README.md | 41 ++++++------------- optimized/T2I/flux3klein/variables.json | 35 ++++------------ 6 files changed, 52 insertions(+), 56 deletions(-) create mode 100644 optimized/I2I/flux3klein/README.md create mode 100644 optimized/I2I/flux3klein/variables.json create mode 100644 optimized/MultipleRef2I/flux3klein/README.md create mode 100644 optimized/MultipleRef2I/flux3klein/variables.json diff --git a/optimized/I2I/flux3klein/README.md b/optimized/I2I/flux3klein/README.md new file mode 100644 index 0000000..eeafacd --- /dev/null +++ b/optimized/I2I/flux3klein/README.md @@ -0,0 +1,9 @@ +# FLUX.3 Klein image-to-image tests + +This is the FLUX.3 Klein image-to-image section. Keep one-reference tests here rather than in the text-to-image directory. + +| ID | Encoder | Resolution | References | Sampler / scheduler | Purpose | +|---|---|---:|---:|---|---| +| F3K-I2I-01 | `qwen3-vl-4b-heretic_int8.safetensors` | 1024×1024 | 1 | Euler / simple | Single-reference conditioning | + +Use the shared prompt from `optimized/T2I/flux3image/prompt.txt`, the installed `flux3-image-klein-int8-convrot.safetensors`, seed `310101`, guidance `3.5`, and four steps. Use an existing repository reference image where available and record its path/hash. Stop and record the exact node-contract error if the local workflow cannot represent the reference path. diff --git a/optimized/I2I/flux3klein/variables.json b/optimized/I2I/flux3klein/variables.json new file mode 100644 index 0000000..a763e20 --- /dev/null +++ b/optimized/I2I/flux3klein/variables.json @@ -0,0 +1,7 @@ +{ + "model": "flux3-image-klein-int8-convrot.safetensors", + "text_encoder": "qwen3-vl-4b-heretic_int8.safetensors", + "vae": "flux2-vae.safetensors", + "fixed": {"prompt_file":"../../T2I/flux3image/prompt.txt","seed":310101,"guidance":3.5,"steps":4}, + "tests": [{"id":"F3K-I2I-01","mode":"i2i","width":1024,"height":1024,"references":1,"sampler":"euler","scheduler":"simple"}] +} diff --git a/optimized/MultipleRef2I/flux3klein/README.md b/optimized/MultipleRef2I/flux3klein/README.md new file mode 100644 index 0000000..5ebd6bb --- /dev/null +++ b/optimized/MultipleRef2I/flux3klein/README.md @@ -0,0 +1,9 @@ +# FLUX.3 Klein multi-reference-to-image tests + +This is the multi-reference-to-image section. Keep tests with two or more input images here. + +| ID | Encoder | Resolution | References | Sampler / scheduler | Purpose | +|---|---|---:|---:|---|---| +| F3K-MI2I-01 | `qwen3-vl-4b-heretic_int8.safetensors` | 1024×1024 | 2 | Euler / simple | Two-reference conditioning | + +Use the shared prompt from `optimized/T2I/flux3image/prompt.txt`, the installed `flux3-image-klein-int8-convrot.safetensors`, seed `310101`, guidance `3.5`, and four steps. Record each reference image path/hash and the exact result. Stop rather than silently reducing the reference count if the workflow or node contract does not support two references. diff --git a/optimized/MultipleRef2I/flux3klein/variables.json b/optimized/MultipleRef2I/flux3klein/variables.json new file mode 100644 index 0000000..44e7d6a --- /dev/null +++ b/optimized/MultipleRef2I/flux3klein/variables.json @@ -0,0 +1,7 @@ +{ + "model": "flux3-image-klein-int8-convrot.safetensors", + "text_encoder": "qwen3-vl-4b-heretic_int8.safetensors", + "vae": "flux2-vae.safetensors", + "fixed": {"prompt_file":"../../T2I/flux3image/prompt.txt","seed":310101,"guidance":3.5,"steps":4}, + "tests": [{"id":"F3K-MI2I-01","mode":"mi2i","width":1024,"height":1024,"references":2,"sampler":"euler","scheduler":"simple"}] +} diff --git a/optimized/T2I/flux3klein/README.md b/optimized/T2I/flux3klein/README.md index 292969e..8b83f1d 100644 --- a/optimized/T2I/flux3klein/README.md +++ b/optimized/T2I/flux3klein/README.md @@ -1,35 +1,20 @@ -# FLUX.3 Klein local test plan +# FLUX.3 Klein text-to-image tests -This plan is prepared for the locally installed `flux3-image-klein-int8-convrot.safetensors` model. Tests are deliberately deferred until **18:30 Europe/London on 28 October 2026**. +Tests for the locally installed `flux3-image-klein-int8-convrot.safetensors` model that do not use image references belong here. Execution is deferred until **18:30 Europe/London on 28 October 2026**. -## Available local model candidates +## Candidate encoder -The ComfyUI server currently reports these text encoders: +Use `qwen3-vl-4b-heretic_int8.safetensors` as the primary local candidate. It is the closest available Qwen3-VL 4B encoder to the Klein workflow contract. `qwen3-8b-heretic_int8.safetensors` is text-only and belongs only in the separate compatibility probe; do not treat it as a valid primary encoder. -- `qwen3-vl-4b-heretic_int8.safetensors` — primary candidate. The VL 4B family is the closest available match to the Klein workflow's expected Qwen3-VL conditioning architecture. -- `qwen3-8b-heretic_int8.safetensors` — compatibility probe only. It is a text-only Qwen3 family model, so it should not be assumed compatible with the Klein VL conditioning path. -- `qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors` and `qwen3vl_8b_w4a8.safetensors` — excluded from the first matrix because they are H3-oriented variants with different expected conditioning contracts. -- `uncensoredQwen34BLLMForZ_fp8.safetensors` — excluded; not the required Qwen3-VL architecture. +## Matrix -The model and encoder must be validated by ComfyUI's node contract and actual prompt execution; filename similarity alone is not sufficient. +All rows use the shared prompt in `../flux3image/prompt.txt`, `flux3-image-klein-int8-convrot.safetensors`, the local Flux-compatible VAE, seed `310101`, guidance `3.5`, and four steps. -## Basic matrix +| ID | Encoder | Resolution | Sampler / scheduler | Purpose | +|---|---|---:|---|---| +| F3K-T2I-01 | Qwen3-VL 4B Heretic int8 | 1024×1024 | Euler / simple | Primary architecture and baseline generation | +| F3K-T2I-02 | Qwen3-VL 4B Heretic int8 | 1088×1920 | Euler / simple | Existing portrait baseline comparison | +| F3K-T2I-03 | Qwen3-VL 4B Heretic int8 | 1024×1024 | Euler / normal | Scheduler compatibility check | +| F3K-PROBE-01 | Qwen3 8B Heretic int8 | 512×512 | Euler / simple | Negative compatibility probe, only if graph validation permits it | -All runs use the existing shared prompt from `../flux3image/prompt.txt`, the local Flux 3 Klein diffusion model, the local Flux-compatible VAE, fixed seed `310101`, guidance `3.5`, and four steps unless a failure requires a diagnostic rerun. - -| ID | Encoder | Mode | Resolution | References | Sampler / scheduler | Purpose | -|---|---|---|---:|---:|---|---| -| F3K-T2I-01 | Qwen3-VL 4B Heretic int8 | text-to-image | 1024×1024 | 0 | Euler / simple | Primary architecture and baseline generation | -| F3K-T2I-02 | Qwen3-VL 4B Heretic int8 | text-to-image | 1088×1920 | 0 | Euler / simple | Existing portrait baseline comparison | -| F3K-T2I-03 | Qwen3-VL 4B Heretic int8 | text-to-image | 1024×1024 | 0 | Euler / normal | Scheduler compatibility check | -| F3K-I2I-01 | Qwen3-VL 4B Heretic int8 | image-to-image | 1024×1024 | 1 | Euler / simple | Reference-image conditioning | -| F3K-MI2I-01 | Qwen3-VL 4B Heretic int8 | multi-image-to-image | 1024×1024 | 2 | Euler / simple | Multiple reference conditioning | -| F3K-PROBE-01 | Qwen3 8B Heretic int8 | text-to-image | 512×512 | 0 | Euler / simple | Controlled negative compatibility probe; stop on contract/shape failure | - -## Test rules - -1. Confirm the exact files exposed by `/models/text_encoders`, `/models/diffusion_models`, and `/models/vae` immediately before queueing. -2. Do not substitute H3-specific Qwen3-VL encoders into this matrix without recording the contract mismatch. -3. Queue the primary VL rows first. Do not queue the 8B probe if the ComfyUI node rejects its architecture at graph validation. -4. Record prompt, model filenames, encoder type, seed, resolution, sampler, scheduler, runtime, output dimensions, and the complete error text for failures. -5. Compare successful outputs against the existing FLUX.3 Image baseline and retain only the test records and selected outputs needed for analysis. +Record model filenames, encoder type, seed, dimensions, sampler, scheduler, runtime, output path, and exact errors in a timestamped results directory. Do not overwrite prior results. diff --git a/optimized/T2I/flux3klein/variables.json b/optimized/T2I/flux3klein/variables.json index afd8736..1533699 100644 --- a/optimized/T2I/flux3klein/variables.json +++ b/optimized/T2I/flux3klein/variables.json @@ -1,33 +1,12 @@ { "model": "flux3-image-klein-int8-convrot.safetensors", - "candidate_text_encoders": [ - { - "file": "qwen3-vl-4b-heretic_int8.safetensors", - "type": "flux3", - "role": "primary", - "reason": "Closest available Qwen3-VL 4B architecture to the Klein workflow contract" - }, - { - "file": "qwen3-8b-heretic_int8.safetensors", - "type": "flux3", - "role": "compatibility-probe", - "reason": "Heretic Qwen3 family variant, but text-only and not presumed VL-compatible" - } - ], - "fixed": { - "prompt_file": "../flux3image/prompt.txt", - "seed": 310101, - "guidance": 3.5, - "steps": 4, - "model": "flux3-image-klein-int8-convrot.safetensors", - "vae": "flux2-vae.safetensors" - }, + "text_encoder": "qwen3-vl-4b-heretic_int8.safetensors", + "vae": "flux2-vae.safetensors", + "fixed": {"prompt_file":"../flux3image/prompt.txt","seed":310101,"guidance":3.5,"steps":4}, "tests": [ - {"id":"F3K-T2I-01","encoder":"qwen3-vl-4b-heretic_int8.safetensors","mode":"t2i","width":1024,"height":1024,"references":0,"sampler":"euler","scheduler":"simple"}, - {"id":"F3K-T2I-02","encoder":"qwen3-vl-4b-heretic_int8.safetensors","mode":"t2i","width":1088,"height":1920,"references":0,"sampler":"euler","scheduler":"simple"}, - {"id":"F3K-T2I-03","encoder":"qwen3-vl-4b-heretic_int8.safetensors","mode":"t2i","width":1024,"height":1024,"references":0,"sampler":"euler","scheduler":"normal"}, - {"id":"F3K-I2I-01","encoder":"qwen3-vl-4b-heretic_int8.safetensors","mode":"i2i","width":1024,"height":1024,"references":1,"sampler":"euler","scheduler":"simple"}, - {"id":"F3K-MI2I-01","encoder":"qwen3-vl-4b-heretic_int8.safetensors","mode":"mi2i","width":1024,"height":1024,"references":2,"sampler":"euler","scheduler":"simple"}, - {"id":"F3K-PROBE-01","encoder":"qwen3-8b-heretic_int8.safetensors","mode":"t2i","width":512,"height":512,"references":0,"sampler":"euler","scheduler":"simple"} + {"id":"F3K-T2I-01","mode":"t2i","width":1024,"height":1024,"references":0,"sampler":"euler","scheduler":"simple"}, + {"id":"F3K-T2I-02","mode":"t2i","width":1088,"height":1920,"references":0,"sampler":"euler","scheduler":"simple"}, + {"id":"F3K-T2I-03","mode":"t2i","width":1024,"height":1024,"references":0,"sampler":"euler","scheduler":"normal"}, + {"id":"F3K-PROBE-01","mode":"t2i","width":512,"height":512,"references":0,"sampler":"euler","scheduler":"simple","encoder":"qwen3-8b-heretic_int8.safetensors"} ] }