Skip to content

feat!: switch default hub model to FLUX.2 klein 9B (Q5_K_M GGUF)#218

Open
TimPietruskyRunPod wants to merge 1 commit intomainfrom
feat/flux2-klein-9b-default
Open

feat!: switch default hub model to FLUX.2 klein 9B (Q5_K_M GGUF)#218
TimPietruskyRunPod wants to merge 1 commit intomainfrom
feat/flux2-klein-9b-default

Conversation

@TimPietruskyRunPod
Copy link
Copy Markdown
Contributor

Summary

  • Switch the default hub deployment model from FLUX.1-dev-fp8 to FLUX.2 klein 9B (Q5_K_M GGUF variant from Unsloth)
  • Install ComfyUI-GGUF custom node in the base Docker stage for GGUF model support
  • Add flux2-klein-9b build target across Dockerfile, docker-bake.hcl, and CI/CD workflows
  • Update hub config, documentation, test workflows, and extra_model_paths.yaml

Breaking Change (6.0.0)

The default hub image ships a different model. Existing workflows using CheckpointLoaderSimple with flux1-dev-fp8.safetensors won't work on the new default image. Users can use the flux1-dev-fp8 image tag for backward compatibility.

Model Details

File Size Directory
flux-2-klein-9b-Q5_K_M.gguf 7.02 GB models/unet/
qwen_3_8b_fp8mixed.safetensors 8.66 GB models/text_encoders/
flux2-vae.safetensors 336 MB models/vae/

Total VRAM: ~16 GB on 24 GB ADA GPUs (8 GB headroom)

Test plan

  • Build locally: docker build --platform linux/amd64 --build-arg MODEL_TYPE=flux2-klein-9b --build-arg HUGGINGFACE_ACCESS_TOKEN=<token> -t test-flux2 .
  • Verify GGUF model loads correctly with UnetLoaderGGUF
  • Verify image generation produces output with test_input.json
  • Verify existing flux1-dev-fp8 target still builds correctly
  • Verify container disk fits within 25 GB

Closes #217

BREAKING CHANGE: The default hub deployment now uses FLUX.2 klein 9B
instead of FLUX.1-dev-fp8. Existing workflows using CheckpointLoaderSimple
with flux1-dev-fp8.safetensors will not work with the new default image.
Use the flux1-dev-fp8 image tag for backward compatibility.

- Install ComfyUI-GGUF custom node in Dockerfile base stage
- Add flux2-klein-9b model download block (GGUF + text encoder + VAE)
- Change default MODEL_TYPE from flux1-dev-fp8 to flux2-klein-9b
- Add docker-bake.hcl target and CI/CD workflow entries
- Update hub config (description + 25GB container disk)
- Add new workflow files for FLUX.2 klein 9B GGUF
- Update documentation across README, hub README, and deployment guide
- Add diffusion_models + text_encoders to extra_model_paths.yaml

Closes #217
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: switch default hub model to FLUX.2 klein 9B (Q5_K_M GGUF)

2 participants