Extensions/ComfyUI-STARFlow
ComfyUI Extension

ComfyUI-STARFlow

Custom nodes for STARFlow text-to-image generation in ComfyUI, including checkpoint loader, text encoder, sampler, and VAE decoder.

By RyukoMatoiFan·Created 7 months ago·Updated 20 days ago· 0
RyukoMatoiFan/ComfyUI-STARFlow
Nodes10
On cloudLocal install
CategorySTARFlow, STARFlow-V
Stars0
Updated20 days ago

Nodes (10)

STARFlow Checkpoint Loader
STARFlow
STARFlow Sampler
STARFlow
STARFlow T5 Text Encode
STARFlow
STARFlow VAE Decode
STARFlow
STARFlow-V Checkpoint Loader
STARFlow-V
STARFlow-V Decode
STARFlow-V
STARFlow-V Image Encode (Official I2V)
STARFlow-V
STARFlow-V Sampler
STARFlow-V
STARFlow-V Text Encode
STARFlow-V
STARFlow-V Text Encoder Loader (FLAN-T5-XL)
STARFlow-V
Readme

ComfyUI-STARFlow

ComfyUI nodes for Apple's STARFlow text-to-image model and STARFlow-V text/image-to-video model.

Installation

Clone this repository into ComfyUI/custom_nodes/ComfyUI-STARFlow, install requirements.txt in ComfyUI's Python environment, and restart ComfyUI.

STARFlow text-to-image

Models

  • Checkpoint: place starflow_3B_t2i_256x256.safetensors in ComfyUI/models/starflow/.
  • Text encoder: place FLAN-T5-XL encoder weights in ComfyUI/models/text_encoders/.
  • VAE: use sd-vae-ft-ema.safetensors with the core VAELoader. This model was trained with stabilityai/sd-vae-ft-ema.

Nodes

  • STARFlowCheckpointLoader
  • STARFlowT5TextEncode
  • STARFlowSampler
  • STARFlowVAEDecode

Example: workflows/starflow_basic_t2i.json.

STARFlow-V text-to-video and image-to-video

Models

  • Checkpoint: place starflow-v_7B_t2v_caus_480p_v3.safetensors in ComfyUI/models/starflow_v/.
  • Text encoder: place a complete local google/flan-t5-xl directory in ComfyUI/models/text_encoders/flan-t5-xl/.
  • VAE: use a Wan2.2 TI2V VAE with the core VAELoader.

The checkpoint loader accepts the shipped single safetensors file directly. Legacy .pth and sharded safetensors checkpoints remain supported. scripts/convert_checkpoint.py converts a tensor-only .pth checkpoint to verified safetensors shards.

Nodes

  • STARFlowVCheckpointLoader
  • STARFlowVTextEncoderLoader
  • STARFlowVTextEncode
  • STARFlowVSampler
  • STARFlowVDecode

Examples:

  • workflows/starflow_v_t2v.json
  • workflows/starflow_v_i2v.json

The video examples use the released inference profile: 848x480 (the nearest 16-aligned 16:9 size), 81 frames at 16 FPS, CFG 3.5, Jacobi block size 32, threshold 0.001, and the learnable denoiser enabled. Width and height must be divisible by 16, and frame counts must follow 4n+1.

Model repository

Converted checkpoints and checksums are published at https://huggingface.co/AkaneTendo25/starflow.

License

See LICENSE, LICENSE_MODEL, and ACKNOWLEDGMENTS. The implementation is based on Apple's ml-starflow release.